Client-Setup: Claude, ChatGPT, Cursor & Co.

Die fertigen Snippets mit Ihrer echten Server-URL finden Sie in der App auf jeder MCP-Server-Detailseite unter „Client-Setup" - hier die Muster zum Nachschlagen. Alle Clients sprechen denselben streamable-HTTP-Endpunkt mit demselben Authorization-Header; es unterscheiden sich nur Dateiname und Schlüsselwort.

Claude Desktop#

{
  "mcpServers": {
    "mein-server": {
      "type": "http",
      "url": "<MCP-Server-URL aus der App>",
      "headers": { "Authorization": "Bearer tt_live_..." }
    }
  }
}

Claude Code#

Ein Befehl; er schreibt die Server-Definition in Ihre .mcp.json:

claude mcp add --transport http mein-server <MCP-Server-URL aus der App> \
  --header "Authorization: Bearer tt_live_..."

ChatGPT#

In der Oberfläche unter Einstellungen → Connectors → Create: MCP-Server-URL eintragen und als Authentifizierung einen eigenen Header Authorization: Bearer tt_live_... hinterlegen. Damit ein Connector mehr darf als Suchen und Abrufen - also Ihre Werkzeuge tatsächlich aufruft -, muss der Developer Mode aktiv sein.

Über die API wird derselbe Server als Tool eingehängt:

{
  "type": "mcp",
  "server_label": "mein-server",
  "server_url": "<MCP-Server-URL aus der App>",
  "headers": { "Authorization": "Bearer tt_live_..." }
}

Cursor#

{
  "mcpServers": {
    "mein-server": {
      "url": "<MCP-Server-URL aus der App>",
      "headers": { "Authorization": "Bearer tt_live_..." }
    }
  }
}

VS Code (Copilot)#

Achtung, hier heißt der Schlüssel servers und nicht mcpServers:

{
  "servers": {
    "mein-server": {
      "type": "http",
      "url": "<MCP-Server-URL aus der App>",
      "headers": { "Authorization": "Bearer tt_live_..." }
    }
  }
}

Gemini CLI#

{
  "mcpServers": {
    "mein-server": {
      "httpUrl": "<MCP-Server-URL aus der App>",
      "headers": { "Authorization": "Bearer tt_live_..." }
    }
  }
}

Generisch (streamable HTTP)#

• Endpoint: die MCP-Server-URL aus der Kopierbox auf der Serverseite
• Header: Authorization: Bearer tt_live_...
• Optional: X-TokynTrail-Agent: <agent-id> - identifiziert den Agenten in Inbox, Reports und Audit-Events
• stdio-Transport wird nicht unterstützt (SaaS) - nutzen Sie streamable HTTP

Client-Formate ändern sich. Weicht Ihr Client ab, gilt immer dasselbe Minimum: streamable HTTP auf die Server-URL, dazu der Authorization-Header. Was ein Client daraus macht, steht in dessen eigener Dokumentation.

Nach Config-Änderungen den Client neu starten - die meisten Clients cachen die Serverliste. Danach sollte der erste Call binnen Sekunden im Inbox-Verlauf erscheinen.

Fehlerbilder beim Setup#

• 401 beim Verbinden: Key-Tippfehler oder widerrufener Key - neuen Key unter Einstellungen → API-Keys erzeugen.
• Tools erscheinen nicht: Client neu starten (Serverlisten-Cache) und prüfen, ob der erste tools/list im Inbox-Verlauf auftaucht.
• Calls werden sofort abgelehnt (-32003): Deny-Regel - Fehlercodes.