Client-Setup: Claude Desktop, Cursor & generisch

Die fertigen Snippets mit Ihrer echten Connection-ID finden Sie in der App auf jeder Connection-Detailseite unter „Client-Setup" — hier die Muster zum Nachschlagen.

Claude Desktop#

{
  "mcpServers": {
    "mein-server": {
      "type": "http",
      "url": "https://mcp.tokyn-trail.eu/v1/<connection-id>",
      "headers": { "Authorization": "Bearer tt_live_..." }
    }
  }
}

Cursor#

{
  "mcpServers": {
    "mein-server": {
      "url": "https://mcp.tokyn-trail.eu/v1/<connection-id>",
      "headers": { "Authorization": "Bearer tt_live_..." }
    }
  }
}

Generisch (streamable HTTP)#

• Endpoint: https://mcp.tokyn-trail.eu/v1/<connection-id>
• 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

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 oder Hold-Limit — Fehlercodes.