Verktøy og scopes

Verktøyene er handlingene AI-agenten din kan utføre i Zippendo for deg, for eksempel å opprette en sending eller lese en ordre. MCP-serveren tilbyr ett verktøy for hver handling i API-et, og agenten din ser bare verktøyene som tillatelsene du godkjenner åpner for.

​

Hvordan verktøy henger sammen med tillatelser

Hvert verktøy trenger en tillatelse (et scope) som passer til ressursen og handlingen:

• Å lese data krever et read:-scope. Å liste sendinger krever for eksempel read:shipments.
• Å endre data krever det tilsvarende write:-scopet. Å opprette en sending krever for eksempel write:shipments.

Scopes bygger på hverandre, så du kan gi bredt eller smalt:

• write:all inkluderer read:all og alle write:-scopes i tabellen nedenfor.
• read:all inkluderer alle read:-scopes i tabellen nedenfor.
• write:<resource> inkluderer read:<resource> (write:shipments inkluderer read:shipments).

En agent som bare har fått read:shipments, ser lese-verktøyene for sendinger (liste, detaljer, sporing, dokumenter), men ingen av verktøyene som oppretter, sender eller sletter sendinger.

​

Scope-oversikt

Samtykkeskjermen kan også liste andre tillatelser, for eksempel organisasjoner, teammedlemmer (org_members), returportaler og API-tokens. De åpner ingen MCP-verktøy i dag.

​

Eksempler på forespørsler

Når du er tilkoblet, snakker du med agenten din på vanlig språk. Den velger riktige verktøy og spør Zippendo:

• «Hvor mange sendinger venter fortsatt, og hvilke transportører gjelder de?»
• «Opprett en sending for ordre #10421 med PostNord og gi meg sporingsnummeret.»
• «Del sendingen for ordre #10388 i to pakker og send begge.»
• «Hvilke ordrer fra de siste 24 timene har ikke en sending ennå?»
• «Spor sendingen shp_8f3kd9 og si fra hvis den er forsinket.»
• «Legg til en fraktregel som sender ordrer over 10 kg med GLS.»

​

Verktøy for dokumentasjon og SDK

I tillegg til handlingsverktøyene lar MCP-serveren en agent lese Zippendos dokumentasjon, slik at den kan hjelpe deg med å bygge en integrasjon i programmeringsspråket ditt. Disse verktøyene trenger ingen scope, og alle tilkoblede agenter har dem. Agenten får beskjed om å foretrekke SDK-et for språket ditt, og bare bruke den rå OpenAPI-spesifikasjonen når det ikke finnes noe SDK. Innholdet kommer live fra zippendo.com/docs og SDK-repositoriene, så det er alltid oppdatert. Prøv forespørsler som:

• «Bruk Zippendo Python SDK og skriv et skript som oppretter en sending for en ordre og skriver ut sporingsnummeret.»
• «Hvordan autentiserer jeg meg mot Zippendo API-et i Go? Vis meg SDK-oppsettet.»
• «Jeg bruker PHP. Skriv en webhook-håndterer som verifiserer signaturen og reagerer på shipment.dispatched.»

​

Sikkerhetsmodell

Å slette sendinger, ordrer, transportører, adresser, fraktregler eller roller, å sende en sending, og å opprette eller oppheve kasse-tokens og signeringshemmeligheter krever alle en uttrykkelig bekreftelse i verktøykallet, så agenten bør spørre deg først. Noen sensitive handlinger, som fakturering og administrasjon av API-tokens, er utelatt fra verktøyene helt, og ingen agent kan bruke dem, uansett tillatelser.

​

De samme verktøyene driver Zippy

MCP-serveren deler verktøyene sine med Zippy, assistenten i Zippendo-appen. Bare stedet er forskjellig: Zippy kjører inne i appen, mens MCP lar ditt eget AI-verktøy bruke de samme handlingene. Begge bruker de samme tillatelsene, organisasjonsgrensene og valideringen.