> ## 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. # Værktøjer og scopes > De værktøjer, Zippendos MCP-server tilbyder, hvilke tilladelser der giver adgang til dem, og eksempler på prompts. 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](/docs/da/mcp/authentication), 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:`** omfatter **`read:`** (`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 | Ressource | Læse-scope | Skrive-scope | Læsning lader agenten… | Skrivning lader den desuden… | | - | - | - | - | - | | Forsendelser | `read:shipments` | `write:shipments` | Vise forsendelser, se detaljer og tracking, hente labels og dokumenter | Oprette, ændre, sende, opdele og slette forsendelser; flytte pakker; oprette returforsendelser; hente en label igen | | Ordrer | `read:orders` | `write:orders` | Vise ordrer og se deres detaljer | Oprette, ændre og slette ordrer | | Transportører | `read:carriers` | `write:carriers` | Vise forbundne transportører og deres produkter | Forbinde, opdatere og fjerne transportører; slå pakkeshops op | | Ordrekanaler | `read:order_channels` | `write:order_channels` | Vise ordrekanaler og status for deres webhooks | Oprette, ændre og slette kanaler; synkronisere og teste dem; registrere deres webhooks; administrere kassenøgler og signeringshemmeligheder | | Adresser | `read:addresses` | `write:addresses` | Vise afsender-, afhentnings- og returadresser | Oprette, opdatere og slette adresser | | Forsendelsesregler | `read:shipping_rules` | `write:shipping_rules` | Vise forsendelsesregler | Oprette, ændre og slette forsendelsesregler | | Automatiseringer | `read:automations` | `write:automations` | Vise automatiseringer, deres kørsler og de tilgængelige trin | Oprette, ændre, slette og køre automatiseringer | | Printere | `read:printers` | `write:printers` | Vise printere | Registrere, godkende, deaktivere, ændre og slette printere | | Webhooks | `read:webhooks` | `write:webhooks` | Vise webhooks og deres leverancer | Oprette, ændre, teste og slette webhooks | | Integrationer | `read:integrations` | `write:integrations` | Vise tilgængelige integrationer, dine forbindelser og deres leverancer | Forbinde, ændre, teste og slette integrationer | | Roller | `read:roles` | `write:roles` | Vise roller | Oprette, ændre og slette roller | | Teammedlemmer | `read:users` | `write:users` | (ingen læseværktøjer) | Tilføje et teammedlem til organisationen | | **Alt** | `read:all` | `write:all` | Alle læseværktøjerne ovenfor | Alle værktøjerne ovenfor | 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. Giv den smalleste adgang, der kan klare opgaven. `read:all` plus `write:shipments` er et godt udgangspunkt for en assistent, der rapporterer om alt, men kun handler på forsendelser. ## 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. | Værktøj | Hvad det gør | | - | - | | `search_documentation` | Søger i al dokumentationen: vejledninger, hele API-referencen og SDK-siderne. Udelad forespørgslen for at gennemse hele indekset. | | `fetch_documentation` | Læser en vilkårlig side som markdown (API-referencesider indeholder endpointets OpenAPI-beskrivelse). Angiv `openapi` for hele den rå specifikation. | | `get_sdk_reference` | SDK-referencen for hvert sprog (TypeScript, Python, PHP, Go, Ruby): metodesignaturer og kørbare eksempler. | 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](https://www.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 Værktøjskald kører som dig, kun med de tilladelser, du har godkendt. En forbindelse tilhører én organisation. Den kan ikke læse eller ændre en anden organisations data. En agent kan aldrig udføre handlinger forbeholdt Zippendos medarbejdere. Hvert kald gennemgår de samme kontroller af login, planbegrænsninger og validering som appen. 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. Klar til at sætte det op? Følg opsætningsvejledningen til dit værktøj. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.