> ## 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.

# Deinen Agenten verbinden

> Schritt-für-Schritt-Anleitung, um Claude, Cursor, VS Code, Windsurf, ChatGPT und andere KI-Agenten mit dem MCP-Server von Zippendo zu 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.

<Card title="Connector-URL" icon="server" horizontal>
  ```
  https://api.zippendo.com/mcp
  ```
</Card>

<Info>
  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](/docs/de/mcp/authentication).
</Info>

## In der Zippendo-App einrichten

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

<Steps>
  <Step title="Karte MCP öffnen">
    Gehe zu **Apps & integrations** → **Catalog**, suche **MCP (AI agents)** und klicke auf **Connect**. Das Fenster **Connect an AI agent** öffnet sich.
  </Step>

  <Step title="Agent wählen">
    Wähle dein KI-Tool. Jeder MCP-Client funktioniert; die Liste zeigt die mit eigener Anleitung.
  </Step>

  <Step title="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**.
  </Step>

  <Step title="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**.
  </Step>
</Steps>

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.

<Steps>
  <Step title="Server hinzufügen">
    ```bash theme={null}
    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).
  </Step>

  <Step title="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.
  </Step>
</Steps>

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

```json .mcp.json theme={null}
{
  "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

<Steps>
  <Step title="Connectors öffnen">
    Gehe zu **Settings → Connectors** und klicke auf **Add custom connector**.
  </Step>

  <Step title="URL hinzufügen">
    Nenne ihn `Zippendo`, gib `https://api.zippendo.com/mcp` ein und klicke auf **Add**.
  </Step>

  <Step title="Verbinden">
    Klicke auf **Connect**, um die Anmeldung im Browser zu öffnen, und bestätige dann Organisation und Berechtigungen.
  </Step>
</Steps>

<Note>
  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.
</Note>

## 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.

<Steps>
  <Step title="MCP-Einstellungen öffnen">
    Öffne **Cursor Settings → Tools & MCP → New MCP Server**. Das öffnet deine `mcp.json`.
  </Step>

  <Step title="Server hinzufügen">
    ```json mcp.json theme={null}
    {
      "mcpServers": {
        "zippendo": {
          "url": "https://api.zippendo.com/mcp"
        }
      }
    }
    ```

    Die globale Konfiguration liegt unter `~/.cursor/mcp.json`, die projektbezogene unter `.cursor/mcp.json`.
  </Step>

  <Step title="Anmelden">
    Neben dem Server erscheint ein Element **Login**. Klicke darauf, um die Anmeldung im Browser zu starten.
  </Step>
</Steps>

<Tip>
  Installation mit einem Klick: [**Zippendo zu Cursor hinzufügen**](cursor://anysphere.cursor-deeplink/mcp/install?name=zippendo\&config=eyJ1cmwiOiJodHRwczovL2FwaS56aXBwZW5kby5jb20vbWNwIn0=).
  Cursor bittet dich um Bestätigung und schreibt den Eintrag für dich.
</Tip>

## VS Code (GitHub Copilot)

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

<Steps>
  <Step title="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**.
  </Step>

  <Step title="Authentifizieren">
    Über dem Servereintrag in `mcp.json` erscheint eine Aktion **Auth**. Schließe die Anmeldung im Browser ab.
  </Step>
</Steps>

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

```json .vscode/mcp.json theme={null}
{
  "servers": {
    "zippendo": {
      "type": "http",
      "url": "https://api.zippendo.com/mcp"
    }
  }
}
```

## Windsurf

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

```json ~/.codeium/windsurf/mcp_config.json theme={null}
{
  "mcpServers": {
    "zippendo": {
      "serverUrl": "https://api.zippendo.com/mcp"
    }
  }
}
```

<Warning>
  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.
</Warning>

## ChatGPT

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

<Steps>
  <Step title="Developer Mode aktivieren">
    Schalte **Settings → Connectors → Advanced → Developer Mode** ein.
  </Step>

  <Step title="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.
  </Step>
</Steps>

<Warning>
  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.
</Warning>

## 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.

```toml ~/.codex/config.toml theme={null}
[mcp_servers.zippendo]
url = "https://api.zippendo.com/mcp"
```

```bash CLI theme={null}
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`.

```json ~/.gemini/settings.json theme={null}
{
  "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:

```json theme={null}
{
  "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

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="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](/docs/de/mcp/tools).
  </Accordion>

  <Accordion title="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](/docs/de/mcp/authentication).
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.