> ## 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. # Tools en scopes > De tools die de Zippendo MCP-server biedt, welke rechten ze ontgrendelen en voorbeeldopdrachten. De tools zijn de acties die je AI-agent in Zippendo voor je kan uitvoeren, zoals een zending aanmaken of een bestelling lezen. De MCP-server biedt één tool voor elke actie in de API en je agent ziet alleen de tools die de [rechten die je goedkeurt](/docs/nl/mcp/authentication) toestaan. ## Hoe tools aan rechten zijn gekoppeld Elke tool vraagt om een recht (een scope) dat past bij het onderdeel en de actie: * Gegevens lezen vraagt om een scope met `read:`. Zendingen opvragen vraagt bijvoorbeeld om `read:shipments`. * Gegevens wijzigen vraagt om de bijbehorende scope met `write:`. Een zending aanmaken vraagt bijvoorbeeld om `write:shipments`. Scopes bouwen op elkaar voort, zodat je breed of smal rechten kunt geven: * **`write:all`** omvat `read:all` en elke `write:`-scope in de tabel hieronder. * **`read:all`** omvat elke `read:`-scope in de tabel hieronder. * **`write:`** omvat **`read:`** (`write:shipments` omvat `read:shipments`). Een agent die alleen `read:shipments` heeft gekregen, ziet de **leestools** voor zendingen (lijst, details, track & trace, documenten), maar geen van de tools die zendingen aanmaken, verzenden of verwijderen. ## Overzicht van scopes | Onderdeel | Leesscope | Schrijfscope | Lezen laat de agent… | Schrijven laat hem ook… | | - | - | - | - | - | | Zendingen | `read:shipments` | `write:shipments` | Zendingen opvragen, details en track & trace bekijken, verzendlabels en documenten ophalen | Zendingen aanmaken, wijzigen, verzenden, splitsen en verwijderen; pakketten verplaatsen; retourzendingen aanmaken; een verzendlabel opnieuw ophalen | | Bestellingen | `read:orders` | `write:orders` | Bestellingen opvragen en hun details bekijken | Bestellingen aanmaken, wijzigen en verwijderen | | Vervoerders | `read:carriers` | `write:carriers` | Gekoppelde vervoerders en hun producten opvragen | Vervoerders koppelen, bijwerken en verwijderen; afhaalpunten opzoeken | | Verkoopkanalen | `read:order_channels` | `write:order_channels` | Verkoopkanalen en de status van hun webhooks opvragen | Kanalen aanmaken, wijzigen en verwijderen; ze synchroniseren en testen; hun webhooks registreren; checkout-tokens en ondertekeningssleutels beheren | | Adressen | `read:addresses` | `write:addresses` | Afzender-, ophaal- en retouradressen opvragen | Adressen aanmaken, bijwerken en verwijderen | | Verzendregels | `read:shipping_rules` | `write:shipping_rules` | Verzendregels opvragen | Verzendregels aanmaken, wijzigen en verwijderen | | Automatiseringen | `read:automations` | `write:automations` | Automatiseringen, hun uitvoeringen en de beschikbare stappen opvragen | Automatiseringen aanmaken, wijzigen, verwijderen en uitvoeren | | Printers | `read:printers` | `write:printers` | Printers opvragen | Printers registreren, goedkeuren, uitschakelen, wijzigen en verwijderen | | Webhooks | `read:webhooks` | `write:webhooks` | Webhooks en hun leveringen opvragen | Webhooks aanmaken, wijzigen, testen en verwijderen | | Integraties | `read:integrations` | `write:integrations` | Beschikbare integraties, je koppelingen en hun leveringen opvragen | Integraties koppelen, wijzigen, testen en verwijderen | | Rollen | `read:roles` | `write:roles` | Rollen opvragen | Rollen aanmaken, wijzigen en verwijderen | | Teamleden | `read:users` | `write:users` | (geen leestools) | Een teamlid aan de organisatie toevoegen | | **Alles** | `read:all` | `write:all` | Alle leestools hierboven | Alle tools hierboven | Het toestemmingsscherm kan ook andere rechten tonen, zoals organisaties, teamleden (`org_members`), retourportalen en API-tokens. Die ontgrendelen op dit moment geen MCP-tools. Geef de kleinst mogelijke set rechten die de klus klaart. `read:all` plus `write:shipments` is een goede standaard voor een assistent die over alles rapporteert maar alleen op zendingen handelt. ## Voorbeeldopdrachten Zodra je bent gekoppeld, praat je met je agent in gewone taal. Hij kiest de juiste tools en vraagt het aan Zippendo: * "Hoeveel zendingen staan nog op Pending en bij welke vervoerders zijn ze?" * "Maak een zending aan voor bestelling #10421 met PostNord en geef me het trackingnummer." * "Splits de zending van bestelling #10388 in twee pakketten en verzend ze allebei." * "Welke bestellingen van de afgelopen 24 uur hebben nog geen zending?" * "Volg zending `shp_8f3kd9` en vertel me of die vertraagd is." * "Voeg een verzendregel toe die bestellingen boven 10 kg met GLS verstuurt." ## Tools voor documentatie en SDK's Naast de actietools laat de MCP-server een agent **de documentatie van Zippendo lezen**, zodat hij je kan helpen een integratie te *bouwen* in je programmeertaal. Voor deze tools is **geen scope** nodig en elke gekoppelde agent heeft ze. | Tool | Wat het doet | | - | - | | `search_documentation` | Doorzoekt alle documentatie: handleidingen, de volledige API-referentie en de SDK-pagina's. Laat de zoekopdracht weg om de hele index te doorbladeren. | | `fetch_documentation` | Leest elke pagina als markdown (pagina's van de API-referentie bevatten de OpenAPI-beschrijving van het endpoint). Geef `openapi` mee voor de volledige ruwe specificatie. | | `get_sdk_reference` | De SDK-referentie voor elke taal (TypeScript, Python, PHP, Go, Ruby): methodehandtekeningen en uitvoerbare voorbeelden. | De agent krijgt de opdracht **de SDK voor jouw taal te verkiezen** en de ruwe OpenAPI-specificatie alleen te gebruiken als er geen SDK voor is. De inhoud komt live van [zippendo.com/docs](https://www.zippendo.com/docs) en de SDK-repositories, dus hij is altijd actueel. Probeer opdrachten zoals: * "Schrijf met de Zippendo Python SDK een script dat een zending voor een bestelling aanmaakt en het trackingnummer print." * "Hoe authenticeer ik me bij de Zippendo-API in Go? Laat me de SDK-installatie zien." * "Ik werk in PHP. Schrijf een webhook-handler die de handtekening verifieert en reageert op `shipment.dispatched`." ## Veiligheidsmodel Toolaanroepen worden als jij uitgevoerd, alleen met de rechten die je hebt goedgekeurd. Een koppeling hoort bij één organisatie. Hij kan de gegevens van een andere organisatie niet lezen of wijzigen. Een agent kan nooit acties van Zippendo-medewerkers uitvoeren. Elke aanroep doorloopt dezelfde controles op inloggen, abonnementslimieten en validatie als de app. Het verwijderen van zendingen, bestellingen, vervoerders, adressen, verzendregels of rollen, het verzenden van een zending en het aanmaken of intrekken van checkout-tokens en ondertekeningssleutels vragen allemaal om een uitdrukkelijke bevestiging in de toolaanroep, dus de agent hoort je eerst te vragen. Sommige gevoelige acties, zoals facturering en het beheer van API-tokens, zijn helemaal weggelaten uit de tools en geen enkele agent kan ze gebruiken, welke rechten hij ook heeft. ## Dezelfde tools drijven Zippy aan De MCP-server deelt zijn tools met **Zippy**, de assistent in de Zippendo-app. Alleen de plek verschilt: Zippy draait in de app, terwijl je met MCP je eigen AI-tool dezelfde acties laat gebruiken. Beide passen dezelfde rechten, organisatielimieten en validatie toe. Klaar om dit in te stellen? Volg de installatiehandleiding voor jouw tool. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.