Skip to main content
Die Tools sind die Aktionen, die dein KI-Agent in Zippendo für dich ausführen kann, etwa eine Sendung erstellen oder eine Bestellung lesen. Der MCP-Server bietet ein Tool für jede Aktion der API, und dein Agent sieht nur die Tools, die die von dir bestätigten Berechtigungen erlauben.

​
Wie Tools Berechtigungen zugeordnet sind

Jedes Tool braucht eine Berechtigung (einen Scope), die zu Ressource und Aktion passt:
  • Das Lesen von Daten braucht einen Scope read:. Das Auflisten von Sendungen braucht zum Beispiel read:shipments.
  • Das Ändern von Daten braucht den passenden Scope write:. Das Erstellen einer Sendung braucht zum Beispiel write:shipments.
Scopes bauen aufeinander auf, sodass du weit oder eng vergeben kannst:
  • write:all schließt read:all und jeden Scope write: in der Tabelle unten ein.
  • read:all schließt jeden Scope read: in der Tabelle unten ein.
  • write:<resource> schließt read:<resource> ein (write:shipments schließt read:shipments ein).
Ein Agent mit nur read:shipments sieht die Lese-Tools für Sendungen (Liste, Details, Sendungsverfolgung, Dokumente), aber keines der Tools, die Sendungen erstellen, versenden oder löschen.

​
Scope-Referenz

Der Zustimmungsbildschirm kann auch weitere Berechtigungen auflisten, etwa zu Organisationen, Teammitgliedern (org_members), Retourenportalen und API-Token. Sie schalten heute keine MCP-Tools frei.
Vergib die engstmögliche Auswahl, mit der die Aufgabe erledigt wird. read:all plus write:shipments ist ein guter Standard für einen Assistenten, der über alles berichtet, aber nur bei Sendungen handelt.

​
Beispiel-Prompts

Sobald die Verbindung steht, sprich in normaler Sprache mit deinem Agenten. Er wählt die passenden Tools und fragt Zippendo:
  • “Wie viele Sendungen sind noch ausstehend, und bei welchen Versanddienstleistern?”
  • “Erstelle eine Sendung für Bestellung #10421 mit PostNord und nenne mir die Sendungsnummer.”
  • “Teile die Sendung für Bestellung #10388 in zwei Pakete auf und versende beide.”
  • “Welche Bestellungen der letzten 24 Stunden haben noch keine Sendung?”
  • “Verfolge die Sendung shp_8f3kd9 und sag mir, ob sie verspätet ist.”
  • “Füge eine Versandregel hinzu, die Bestellungen über 10 kg mit GLS versendet.”

​
Tools für Dokumentation und SDKs

Neben den Aktions-Tools lässt der MCP-Server einen Agenten die Dokumentation von Zippendo lesen, damit er dir helfen kann, eine Integration in deiner Programmiersprache zu bauen. Diese Tools brauchen keinen Scope, und jeder verbundene Agent hat sie. Dem Agenten wird gesagt, dass er das SDK für deine Sprache bevorzugen und die rohe OpenAPI-Spezifikation nur nutzen soll, wenn es dafür kein SDK gibt. Der Inhalt kommt live von zippendo.com/docs und aus den SDK-Repositories und ist deshalb immer aktuell. Probiere Prompts wie diese:
  • “Schreibe mit dem Python-SDK von Zippendo ein Skript, das für eine Bestellung eine Sendung erstellt und die Sendungsnummer ausgibt.”
  • “Wie authentifiziere ich mich in Go bei der Zippendo-API? Zeig mir die Einrichtung des SDK.”
  • “Ich nutze PHP. Schreibe einen Webhook-Handler, der die Signatur prüft und auf shipment.dispatched reagiert.”

​
Sicherheitsmodell

Handelt als du

Tool-Aufrufe laufen als du, nur mit den Berechtigungen, die du bestätigt hast.

Eine Organisation

Eine Verbindung gehört zu einer Organisation. Sie kann die Daten einer anderen Organisation weder lesen noch ändern.

Kein Mitarbeiterzugriff

Ein Agent kann nie Aktionen des Personals von Zippendo ausführen.

Vollständige Validierung

Jeder Aufruf durchläuft dieselben Prüfungen zu Anmeldung, Tariflimits und Validierung wie die App.
Das Löschen von Sendungen, Bestellungen, Versanddienstleistern, Adressen, Versandregeln oder Rollen, das Versenden einer Sendung sowie das Erstellen oder Widerrufen von Checkout-Token und Signatur-Secrets brauchen alle eine ausdrückliche Bestätigung im Tool-Aufruf, der Agent sollte dich also zuerst fragen. Einige sensible Aktionen, etwa die Abrechnung und die Verwaltung von API-Token, sind ganz aus den Tools ausgenommen, und kein Agent kann sie nutzen, egal mit welchen Berechtigungen.

​
Dieselben Tools treiben Zippy an

Der MCP-Server teilt seine Tools mit Zippy, dem Assistenten in der Zippendo-App. Nur der Ort unterscheidet sich: Zippy läuft in der App, während MCP dein eigenes KI-Tool dieselben Aktionen nutzen lässt. Beide wenden dieselben Berechtigungen, Limits der Organisation und dieselbe Validierung an.

Verbinde deinen Agenten

Bereit zur Einrichtung? Folge der Anleitung für dein Tool.