Værktøjer og scopes

Værktøjerne er de handlinger, din AI-agent kan udføre i Zippendo for dig, for eksempel at oprette en forsendelse eller læse en ordre. MCP-serveren tilbyder ét værktøj for hver handling i API’et, og din agent ser kun de værktøjer, som de tilladelser, du godkender, giver adgang til.

​

Sådan hænger værktøjer sammen med tilladelser

Hvert værktøj kræver en tilladelse (en scope), der matcher ressourcen og handlingen:

• At læse data kræver en read:-scope. At vise forsendelser kræver for eksempel read:shipments.
• At ændre data kræver den tilsvarende write:-scope. At oprette en forsendelse kræver for eksempel write:shipments.

Scopes bygger oven på hinanden, så du kan give bred eller smal adgang:

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

En agent, der kun har fået read:shipments, ser værktøjerne til at læse forsendelser (liste, detaljer, tracking, dokumenter), men ingen af de værktøjer, der opretter, sender eller sletter forsendelser.

​

Scope-oversigt

Samtykkeskærmen kan også vise andre tilladelser, for eksempel organisationer, teammedlemmer (org_members), returportaler og API-tokens. De giver i dag ikke adgang til nogen MCP-værktøjer.

​

Eksempler på prompts

Når du er forbundet, kan du tale til din agent på almindeligt sprog. Den vælger de rigtige værktøjer og spørger Zippendo:

• “Hvor mange forsendelser afventer stadig, og hvilke transportører er de hos?”
• “Opret en forsendelse for ordre #10421 med PostNord og giv mig trackingnummeret.”
• “Del forsendelsen for ordre #10388 op i to pakker og send begge.”
• “Hvilke ordrer fra de seneste 24 timer har ikke en forsendelse endnu?”
• “Følg forsendelse shp_8f3kd9 og fortæl mig, om den er forsinket.”
• “Tilføj en forsendelsesregel, der sender ordrer over 10 kg med GLS.”

​

Værktøjer til dokumentation og SDK’er

Ud over handlingsværktøjerne lader MCP-serveren en agent læse Zippendos dokumentation, så den kan hjælpe dig med at bygge en integration i dit programmeringssprog. Disse værktøjer kræver ingen scope, og alle forbundne agenter har dem. Agenten får besked på at foretrække SDK’et for dit sprog og kun bruge den rå OpenAPI-specifikation, når der ikke findes et SDK. Indholdet kommer live fra zippendo.com/docs og SDK-repositorierne, så det altid er opdateret. Prøv prompts som:

• “Skriv et script med Zippendos Python-SDK, der opretter en forsendelse for en ordre og udskriver trackingnummeret.”
• “Hvordan godkender jeg mig mod Zippendos API i Go? Vis mig SDK-opsætningen.”
• “Jeg bruger PHP. Skriv en webhook-handler, der verificerer signaturen og reagerer på shipment.dispatched.”

​

Sikkerhedsmodel

Sletning af forsendelser, ordrer, transportører, adresser, forsendelsesregler eller roller, afsendelse af en forsendelse samt oprettelse eller tilbagekaldelse af kassenøgler og signeringshemmeligheder kræver alle en eksplicit bekræftelse i værktøjskaldet, så agenten bør spørge dig først. Nogle følsomme handlinger, såsom fakturering og administration af API-tokens, er helt udeladt fra værktøjerne, og ingen agent kan bruge dem, uanset dens tilladelser.

​

De samme værktøjer driver Zippy

MCP-serveren deler sine værktøjer med Zippy, assistenten i Zippendo-appen. Kun stedet er forskelligt: Zippy kører inde i appen, mens MCP lader dit eget AI-værktøj bruge de samme handlinger. Begge anvender de samme tilladelser, organisationsgrænser og validering.