Deinen Agenten verbinden

Verbinde dein KI-Tool mit Zippendo, damit es für dich mit deinen Sendungen, Bestellungen und Versanddienstleistern arbeiten kann. Füge die folgende URL im Tool als eigenen MCP-Connector hinzu. Das Tool öffnet die Zippendo-Anmeldung in deinem Browser und hält die Verbindung selbst aktuell: Du musst nichts installieren und keinen Token einfügen.

Connector-URL

https://api.zippendo.com/mcp

Der Server unterstützt Dynamic Client Registration, ein kompatibler Client braucht also nur die URL: keine Client-ID, kein Client-Secret, keinen eingefügten Token. Beim ersten Verbinden findet er die Anmeldung, registriert sich selbst und öffnet deinen Browser, damit du dich anmeldest und den Zugriff bestätigst. Siehe Authentifizierung.

In der Zippendo-App einrichten

Die App führt dich für dein Tool durch dieselben Schritte:

Karte MCP öffnen

Gehe zu Apps & integrations → Catalog, suche MCP (AI agents) und klicke auf Connect. Das Fenster Connect an AI agent öffnet sich.

Agent wählen

Wähle dein KI-Tool. Jeder MCP-Client funktioniert; die Liste zeigt die mit eigener Anleitung.

Connector hinzufügen

Folge den Schritten für dein Tool. Die Connector URL hat eine Schaltfläche Copy. Wenn du sie hinzugefügt hast, klicke auf I’ve added it.

Zugriff bestätigen

Schließe die Anmeldung ab, die dein Tool geöffnet hat, und bestätige Organisation und Berechtigungen. Das Fenster aktualisiert sich von selbst, sobald die Verbindung steht. Klicke auf Done.

Jeder verbundene Agent erscheint dann auf der Karte MCP (AI agents) mit dem Zeitpunkt der letzten Nutzung und der Anzahl seiner Berechtigungen. Klicke auf Disconnect, um seinen Zugriff zu entfernen, oder auf Connect another, um einen weiteren hinzuzufügen. Die Schritte für jedes Tool stehen auch unten.

Claude Code

Füge den Server mit der CLI hinzu und authentifiziere dich dann in einer Sitzung.

Server hinzufügen

claude mcp add --transport http zippendo https://api.zippendo.com/mcp

Mit --scope user ist er in jedem Projekt verfügbar, mit --scope project wird er für dein Team in die .mcp.json des Repos geschrieben (Standard ist lokal: nur du, im aktuellen Projekt).

Authentifizieren

Starte Claude Code, führe /mcp aus, wähle zippendo und dann Authenticate. Dein Browser öffnet den Zustimmungsbildschirm von Zippendo. Bestätige, und du bist verbunden. Führe /mcp jederzeit erneut aus, um den Status zu prüfen oder dich erneut zu authentifizieren.

Um den Server mit deinem Team zu teilen, schreibe eine .mcp.json ins Projekt:

.mcp.json

{
  "mcpServers": {
    "zippendo": {
      "type": "http",
      "url": "https://api.zippendo.com/mcp"
    }
  }
}

Verwalte die Verbindung mit claude mcp list, claude mcp get zippendo und claude mcp remove zippendo.

Claude Desktop

Connectors öffnen

Gehe zu Settings → Connectors und klicke auf Add custom connector.

URL hinzufügen

Nenne ihn Zippendo, gib https://api.zippendo.com/mcp ein und klicke auf Add.

Verbinden

Klicke auf Connect, um die Anmeldung im Browser zu öffnen, und bestätige dann Organisation und Berechtigungen.

Eigene Connectors gibt es bei Free, Pro, Max, Team und Enterprise. Free-Tarife erlauben einen eigenen Connector. Bei Team und Enterprise fügt ein Owner den Connector hinzu, und jedes Mitglied verbindet sich einzeln.

Claude im Web

Dasselbe Konto, dieselben Schritte wie bei Claude Desktop.

Einzelnutzer (Free, Pro, Max): Settings → Connectors → Add custom connector, gib einen Namen und https://api.zippendo.com/mcp ein, klicke auf Add und dann auf Connect.
Team und Enterprise: Ein Owner fügt ihn einmal unter Organization settings → Connectors → Add → Custom hinzu. Mitglieder öffnen dann Settings → Connectors, suchen den Connector und klicken auf Connect. Jedes Mitglied verbindet sich mit seinem eigenen Zugriff.

Cursor

Füge ihn in den Einstellungen oder mit einer Konfigurationsdatei hinzu.

MCP-Einstellungen öffnen

Öffne Cursor Settings → Tools & MCP → New MCP Server. Das öffnet deine mcp.json.

Server hinzufügen

mcp.json

{
  "mcpServers": {
    "zippendo": {
      "url": "https://api.zippendo.com/mcp"
    }
  }
}

Die globale Konfiguration liegt unter ~/.cursor/mcp.json, die projektbezogene unter .cursor/mcp.json.

Anmelden

Neben dem Server erscheint ein Element Login. Klicke darauf, um die Anmeldung im Browser zu starten.

Installation mit einem Klick: Zippendo zu Cursor hinzufügen. Cursor bittet dich um Bestätigung und schreibt den Eintrag für dich.

VS Code (GitHub Copilot)

Braucht VS Code 1.102 oder neuer mit GitHub Copilot. Nutze die Tools im Copilot Chat im Modus Agent.

Server hinzufügen

Befehlspalette → MCP: Add Server → HTTP, füge https://api.zippendo.com/mcp ein und wähle dann Workspace (schreibt .vscode/mcp.json) oder Global.

Authentifizieren

Über dem Servereintrag in mcp.json erscheint eine Aktion Auth. Schließe die Anmeldung im Browser ab.

Die VS-Code-Konfiguration verwendet den Schlüssel servers auf oberster Ebene (nicht mcpServers):

.vscode/mcp.json

{
  "servers": {
    "zippendo": {
      "type": "http",
      "url": "https://api.zippendo.com/mcp"
    }
  }
}

Windsurf

Bearbeite ~/.codeium/windsurf/mcp_config.json (Cascade → MCP servers → edit raw config).

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "zippendo": {
      "serverUrl": "https://api.zippendo.com/mcp"
    }
  }
}

Windsurf verwendet für Streamable-HTTP-Server serverUrl (nicht url). OAuth wird unterstützt, aber wenn sich die Anmeldung im Browser nicht öffnet, aktualisiere Windsurf auf die neueste Version.

ChatGPT

Eigene MCP-Connectors werden über den Developer Mode hinzugefügt, nur in der Webversion (keine Konfigurationsdatei).

Developer Mode aktivieren

Schalte Settings → Connectors → Advanced → Developer Mode ein.

Connector hinzufügen

Füge zurück unter Connectors einen eigenen Connector mit der URL https://api.zippendo.com/mcp hinzu. ChatGPT bittet dich, dich beim ersten Verbinden anzumelden.

Der Developer Mode ist bei Plus, Pro, Business, Enterprise und Edu in der Beta. Vollständiges Tool Calling (Schreibaktionen wie das Erstellen einer Sendung) ist auf Business, Enterprise und Edu beschränkt. Plus und Pro sind praktisch nur lesend. Schreibaktionen brauchen jedes Mal eine Bestätigung. ChatGPT kann Menünamen und Verfügbarkeit ändern.

OpenAI Codex CLI

Nutze eine aktuelle Codex CLI (ältere Versionen unterstützten nur lokale Server). Füge den Server in der Konfigurationsdatei oder mit der CLI hinzu.

~/.codex/config.toml

[mcp_servers.zippendo]
url = "https://api.zippendo.com/mcp"

CLI

codex mcp add zippendo --url https://api.zippendo.com/mcp
codex mcp login zippendo   # opens the browser sign-in

Hat deine Codex-Version kein --url oder codex mcp login, aktualisiere auf die neueste Codex CLI.

Gemini CLI

Bearbeite ~/.gemini/settings.json. Streamable-HTTP-Server verwenden das Feld httpUrl.

~/.gemini/settings.json

{
  "mcpServers": {
    "zippendo": {
      "httpUrl": "https://api.zippendo.com/mcp"
    }
  }
}

Gemini CLI findet die OAuth-Anmeldung selbst. Führe in einer Sitzung /mcp auth aus (oder /mcp, um zu sehen, welche Server sie brauchen), um die Anmeldung im Browser zu öffnen.

Jeder andere MCP-Client

Die meisten Clients akzeptieren die Standard-Einrichtung für Remote-Server, mit nur der URL:

{
  "mcpServers": {
    "zippendo": {
      "url": "https://api.zippendo.com/mcp"
    }
  }
}

Folgt dein Client der MCP-Autorisierungsspezifikation, findet er die Anmeldung und führt OAuth für dich aus. Bestätige dann auf der Zippendo-Anmeldeseite, die er öffnet, Organisation und Berechtigungen.

Fehlerbehebung

Die Anmeldung im Browser öffnet sich nie

Prüfe, ob dein Client Remote-MCP über OAuth unterstützt und ob du die neueste Version hast. Manche Clients haben Remote-Connectors erst in neueren Versionen ergänzt.

Der Agent sieht ein benötigtes Tool nicht

Tools werden nach den Berechtigungen gefiltert, die du bestätigt hast. Verbinde dich erneut und erteile die fehlende Berechtigung auf dem Zustimmungsbildschirm (zum Beispiel write:shipments, um Sendungen zu erstellen). Siehe Tools und Scopes.

Es funktioniert in der falschen Organisation

Jede Verbindung gehört zu einer Organisation. Trenne die Verbindung, verbinde dich erneut und wähle auf dem Zustimmungsbildschirm die richtige Organisation. Siehe Authentifizierung.

Die Anmeldung weist dein Konto ab

Ist dein Teammitglied-Konto auf eine Marke beschränkt, kannst du keinen Agenten verbinden. Bitte einen Organisationsinhaber, dir Zugriff auf die ganze Organisation zu geben oder den Agenten selbst zu verbinden.

Eine Konfiguration nur mit url wird abgelehnt

Manche Clients brauchen die Angabe des Transporttyps. Ergänze "type": "http" neben der url (Claude Code, VS Code) oder nutze beim Hinzufügen des Servers die HTTP-Option des Clients.

Start

Quickstarts

Fulfillment flow

Connections

Operations

Organization & account

Deinen Agenten verbinden

Connector-URL

In der Zippendo-App einrichten

Claude Code

Claude Desktop

Claude im Web

Cursor

VS Code (GitHub Copilot)

Windsurf

ChatGPT

OpenAI Codex CLI

Gemini CLI

Jeder andere MCP-Client

Fehlerbehebung

Connector-URL

​In der Zippendo-App einrichten

​Claude Code

​Claude Desktop

​Claude im Web

​Cursor

​VS Code (GitHub Copilot)

​Windsurf

​ChatGPT

​OpenAI Codex CLI

​Gemini CLI

​Jeder andere MCP-Client

​Fehlerbehebung

In der Zippendo-App einrichten

Claude Code

Claude Desktop

Claude im Web

Cursor

VS Code (GitHub Copilot)

Windsurf

ChatGPT

OpenAI Codex CLI

Gemini CLI

Jeder andere MCP-Client

Fehlerbehebung