> ## 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. # Verktøy og scopes > Verktøyene Zippendo MCP-serveren tilbyr, hvilke tillatelser som åpner for dem, og eksempler på forespørsler. 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](/docs/no/mcp/authentication) å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:`** inkluderer **`read:`** (`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 | Ressurs | Lese-scope | Skrive-scope | Lesing lar agenten... | Skriving lar den også... | | - | - | - | - | - | | Sendinger | `read:shipments` | `write:shipments` | Liste sendinger, se detaljer og sporing, hente fraktetiketter og dokumenter | Opprette, endre, sende, dele og slette sendinger, flytte pakker, opprette retursendinger og hente en fraktetikett på nytt | | Ordrer | `read:orders` | `write:orders` | Liste ordrer og se detaljene deres | Opprette, endre og slette ordrer | | Transportører | `read:carriers` | `write:carriers` | Liste tilkoblede transportører og fraktproduktene deres | Koble til, oppdatere og fjerne transportører, og slå opp hentesteder | | Ordrekanaler | `read:order_channels` | `write:order_channels` | Liste ordrekanaler og webhook-statusen deres | Opprette, endre og slette kanaler, synkronisere og teste dem, registrere webhookene deres og administrere kasse-tokens og signeringshemmeligheter | | Adresser | `read:addresses` | `write:addresses` | Liste avsender-, hente- og returadresser | Opprette, oppdatere og slette adresser | | Fraktregler | `read:shipping_rules` | `write:shipping_rules` | Liste fraktregler | Opprette, endre og slette fraktregler | | Automatiseringer | `read:automations` | `write:automations` | Liste automatiseringer, kjøringene deres og tilgjengelige steg | Opprette, endre, slette og kjøre automatiseringer | | Skrivere | `read:printers` | `write:printers` | Liste skrivere | Registrere, godkjenne, deaktivere, endre og slette skrivere | | Webhooks | `read:webhooks` | `write:webhooks` | Liste webhooks og leveringene deres | Opprette, endre, teste og slette webhooks | | Integrasjoner | `read:integrations` | `write:integrations` | Liste tilgjengelige integrasjoner, tilkoblingene dine og leveringene deres | Koble til, endre, teste og slette integrasjoner | | Roller | `read:roles` | `write:roles` | Liste roller | Opprette, endre og slette roller | | Teammedlemmer | `read:users` | `write:users` | (ingen lese-verktøy) | Legge til et teammedlem i organisasjonen | | **Alt** | `read:all` | `write:all` | Alle lese-verktøyene ovenfor | Alle verktøyene ovenfor | Samtykkeskjermen kan også liste andre tillatelser, for eksempel organisasjoner, teammedlemmer (`org_members`), returportaler og API-tokens. De åpner ingen MCP-verktøy i dag. Gi det smaleste settet som gjør jobben. `read:all` pluss `write:shipments` er et godt utgangspunkt for en assistent som rapporterer om alt, men bare handler på sendinger. ## 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. | Verktøy | Hva det gjør | | - | - | | `search_documentation` | Søker i all dokumentasjon: veiledninger, hele API-referansen og SDK-sidene. Utelat spørringen for å bla i hele indeksen. | | `fetch_documentation` | Leser en hvilken som helst side som markdown (API-referansesider inkluderer endepunktets OpenAPI-beskrivelse). Send `openapi` for hele den rå spesifikasjonen. | | `get_sdk_reference` | SDK-referansen for hvert språk (TypeScript, Python, PHP, Go, Ruby): metodesignaturer og kjørbare eksempler. | 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](https://www.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 Verktøykall kjører som deg, bare med tillatelsene du har godkjent. En tilkobling tilhører én organisasjon. Den kan ikke lese eller endre en annen organisasjons data. En agent kan aldri utføre handlinger forbeholdt Zippendos ansatte. Hvert kall kjører de samme kontrollene for pålogging, planbegrensninger og validering som appen. Å 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. Klar til å sette dette opp? Følg oppsettsveiledningen for verktøyet ditt. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.