> ## Documentation Index > Fetch the complete documentation index at: https://www.zippendo.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Verktyg och scopes > Verktygen som Zippendos MCP-server erbjuder, vilka behörigheter som låser upp dem och exempel på prompter. 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](/docs/sv/mcp/authentication) 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:`** omfattar **`read:`** (`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 | Resurs | Läs-scope | Skriv-scope | Läsning låter agenten… | Skrivning låter den dessutom… | | - | - | - | - | - | | Försändelser | `read:shipments` | `write:shipments` | Lista försändelser, se detaljer och spårning, hämta fraktetiketter och dokument | Skapa, ändra, skicka, dela upp och radera försändelser; flytta paket; skapa retursändningar; hämta en fraktetikett igen | | Ordrar | `read:orders` | `write:orders` | Lista ordrar och se deras detaljer | Skapa, ändra och radera ordrar | | Transportörer | `read:carriers` | `write:carriers` | Lista anslutna transportörer och deras fraktprodukter | Ansluta, uppdatera och ta bort transportörer; slå upp ombud | | Orderkanaler | `read:order_channels` | `write:order_channels` | Lista orderkanaler och deras webhookstatus | Skapa, ändra och radera kanaler; synkronisera och testa dem; registrera deras webhooks; hantera kassatokens och signeringshemligheter | | Adresser | `read:addresses` | `write:addresses` | Lista avsändar-, upphämtnings- och returadresser | Skapa, uppdatera och radera adresser | | Fraktregler | `read:shipping_rules` | `write:shipping_rules` | Lista fraktregler | Skapa, ändra och radera fraktregler | | Automatiseringar | `read:automations` | `write:automations` | Lista automatiseringar, deras körningar och tillgängliga steg | Skapa, ändra, radera och köra automatiseringar | | Skrivare | `read:printers` | `write:printers` | Lista skrivare | Registrera, godkänna, inaktivera, ändra och radera skrivare | | Webhooks | `read:webhooks` | `write:webhooks` | Lista webhooks och deras leveranser | Skapa, ändra, testa och radera webhooks | | Integrationer | `read:integrations` | `write:integrations` | Lista tillgängliga integrationer, dina anslutningar och deras leveranser | Ansluta, ändra, testa och radera integrationer | | Roller | `read:roles` | `write:roles` | Lista roller | Skapa, ändra och radera roller | | Teammedlemmar | `read:users` | `write:users` | (inga läsverktyg) | Lägga till en teammedlem i organisationen | | **Allt** | `read:all` | `write:all` | Alla läsverktyg ovan | Alla verktyg ovan | 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. Ge den smalaste uppsättning som räcker. `read:all` plus `write:shipments` är ett bra utgångsläge för en assistent som rapporterar om allt men bara agerar på försändelser. ## 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. | Verktyg | Vad det gör | | - | - | | `search_documentation` | Söker i all dokumentation: guider, hela API-referensen och SDK-sidorna. Utelämna sökfrågan för att bläddra i hela indexet. | | `fetch_documentation` | Läser vilken sida som helst som markdown (sidor i API-referensen inkluderar slutpunktens OpenAPI-beskrivning). Ange `openapi` för hela den råa specifikationen. | | `get_sdk_reference` | SDK-referensen för varje språk (TypeScript, Python, PHP, Go, Ruby): metodsignaturer och körbara exempel. | 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](https://www.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 Verktygsanrop körs som du, bara med de behörigheter du har godkänt. En anslutning tillhör en organisation. Den kan inte läsa eller ändra en annan organisations data. En agent kan aldrig utföra åtgärder som är förbehållna Zippendos personal. Varje anrop går igenom samma kontroller av inloggning, plangränser och validering som appen. 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. Redo att sätta upp det här? Följ installationsguiden för ditt verktyg. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.