Verktyg och scopes

Verktygen är de åtgärder som din AI-agent kan utföra i Zippendo åt dig, till exempel att skapa en försändelse eller läsa en order. MCP-servern erbjuder ett verktyg för varje åtgärd i API:et, och din agent ser bara de verktyg som de behörigheter du godkänner tillåter.

​

Så hör verktyg ihop med behörigheter

Varje verktyg kräver en behörighet (ett scope) som matchar resursen och åtgärden:

• Att läsa data kräver ett read:-scope. Att lista försändelser kräver till exempel read:shipments.
• Att ändra data kräver motsvarande write:-scope. Att skapa en försändelse kräver till exempel write:shipments.

Scopes bygger på varandra, så du kan ge brett eller smalt:

• write:all omfattar read:all och varje write:-scope i tabellen nedan.
• read:all omfattar varje read:-scope i tabellen nedan.
• write:<resource> omfattar read:<resource> (write:shipments omfattar read:shipments).

En agent som bara har fått read:shipments ser verktygen för att läsa försändelser (lista, detaljer, spårning, dokument) men inga av verktygen som skapar, skickar eller raderar försändelser.

​

Scope-referens

Godkännandeskärmen kan också lista andra behörigheter, till exempel organisationer, teammedlemmar (org_members), returportaler och API-tokens. De låser inte upp några MCP-verktyg i dag.

​

Exempel på prompter

När du har anslutit pratar du med din agent på vanligt språk. Den väljer rätt verktyg och frågar Zippendo:

• “Hur många försändelser väntar fortfarande, och vilka transportörer gäller de?”
• “Skapa en försändelse för order #10421 med PostNord och ge mig spårningsnumret.”
• “Dela upp försändelsen för order #10388 i två paket och skicka båda.”
• “Vilka ordrar från de senaste 24 timmarna har ingen försändelse än?”
• “Spåra försändelse shp_8f3kd9 och berätta om den är försenad.”
• “Lägg till en fraktregel som skickar ordrar över 10 kg med GLS.”

​

Dokumentations- och SDK-verktyg

Utöver åtgärdsverktygen låter MCP-servern en agent läsa Zippendos dokumentation, så att den kan hjälpa dig att bygga en integration i ditt programmeringsspråk. De här verktygen kräver inget scope och alla anslutna agenter har dem. Agenten har fått instruktionen att föredra SDK:n för ditt språk och bara använda den råa OpenAPI-specifikationen när det saknas en SDK för det. Innehållet kommer live från zippendo.com/docs och SDK-förråden, så det är alltid aktuellt. Prova prompter som:

• “Skriv ett skript med Zippendos Python-SDK som skapar en försändelse för en order och skriver ut spårningsnumret.”
• “Hur autentiserar jag mig mot Zippendos API i Go? Visa mig SDK-konfigurationen.”
• “Jag använder PHP. Skriv en webhookhanterare som verifierar signaturen och reagerar på shipment.dispatched.”

​

Säkerhetsmodell

Att radera försändelser, ordrar, transportörer, adresser, fraktregler eller roller, att skicka en försändelse, och att skapa eller återkalla kassatokens och signeringshemligheter kräver alla en uttrycklig bekräftelse i verktygsanropet, så agenten bör fråga dig först. Vissa känsliga åtgärder, till exempel fakturering och hantering av API-tokens, är helt utelämnade från verktygen och ingen agent kan använda dem, oavsett behörigheter.

​

Samma verktyg driver Zippy

MCP-servern delar sina verktyg med Zippy, assistenten i Zippendo-appen. Det är bara platsen som skiljer sig: Zippy körs inne i appen, medan MCP låter ditt eget AI-verktyg använda samma åtgärder. Båda tillämpar samma behörigheter, organisationsgränser och validering.