Leeway MCP einrichten: Cursor, Claude, VS Code & ChatGPT verbinden

1. API-Token holen

Alle Verbindungen authentifizieren sich mit Ihrem persönlichen Leeway API-Token. Ihn finden Sie im Account-Bereich. Ersetzen Sie in allen Beispielen YOUR_TOKEN durch Ihren echten Token.

Token im Account öffnen

2. Verbindungsart wählen

Es gibt drei Wege – wählen Sie den, den Ihr Client unterstützt.

Remote MCP (HTTP)

Streamable HTTP mit Bearer-Token. Für Cursor, VS Code und die meisten MCP-Clients.

Lokale Bridge (stdio)

Eine kleine Bridge per npx — kein OAuth, kein Leeway-Server zu installieren. Für Claude Desktop.

OpenAPI / REST

Für Assistenten ohne MCP, die ein OpenAPI-Schema erwarten – z. B. Custom GPTs oder andere KI-Clients.

Cursor

Cursor verbindet sich remote über Streamable HTTP. Am schnellsten geht es per Ein-Klick-Installation; alternativ tragen Sie den Server manuell in mcp.json ein.

In Cursor installieren

Auf „In Cursor installieren“ klicken oder die Konfiguration unten kopieren.
Die Datei ~/.cursor/mcp.json öffnen und den Block unter mcpServers einfügen.
YOUR_TOKEN durch Ihren Leeway API-Token ersetzen.
In den Cursor-Einstellungen unter MCP den Server aktualisieren – die Leeway-Tools erscheinen im Chat.

Konfigurationsdatei: ~/.cursor/mcp.json

{
  "mcpServers": {
    "leeway-api": {
      "url": "https://mcp.leeway.tech/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Claude Desktop

Der eingebaute "Add custom connector"-Dialog in Claude Desktop unterstützt nur OAuth – unsere Token-Authentifizierung passt dort nicht hinein. Verbinden Sie sich stattdessen über eine stdio-Bridge (mcp-remote) mit dem gehosteten Leeway-Server – per npx, ohne einen eigenen Leeway-Server zu installieren.

Node.js muss installiert sein (nur für npx – sonst ist nichts zu installieren).
In Claude Desktop unter Settings → Developer → Edit Config öffnen.
Den Block unten einfügen und YOUR_TOKEN durch Ihren Leeway API-Token ersetzen.
Claude Desktop neu starten – die Tools stehen im Gespräch bereit.

Konfigurationsdatei: claude_desktop_config.json

{
  "mcpServers": {
    "leeway": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.leeway.tech/mcp",
        "--header",
        "Authorization:Bearer YOUR_TOKEN"
      ]
    }
  }
}

VS Code

VS Code (mit MCP-fähiger Erweiterung) verbindet sich remote über Streamable HTTP – dieselbe Konfiguration wie bei Cursor.

Eine MCP-fähige Erweiterung installieren und deren MCP-Konfiguration öffnen.
Den Server-Block unten einfügen und YOUR_TOKEN ersetzen.
Die Erweiterung neu laden – die Tools werden verfügbar.

{
  "mcpServers": {
    "leeway-api": {
      "url": "https://mcp.leeway.tech/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

OpenAPI-Clients (Custom GPTs, KI-Assistenten)

Assistenten, die kein MCP unterstützen, können über unsere OpenAPI-Spezifikation angebunden werden. Sie übergeben das JSON-Schema und authentifizieren sich über den Query-Parameter.

OpenAPI-Schema (URL)https://api.leeway.tech/openapi.json

REST-Basis-URLhttps://api.leeway.tech

Authentifizierung (Query-Parameter)?apitoken=YOUR_TOKEN

Öffnen Sie die OpenAPI-URL in Ihrem Browser, markieren Sie alles und kopieren Sie den gesamten angezeigten JSON-Text.
Legen Sie in Ihrem KI-Assistenten eine neue Aktion oder einen Skill an und fügen Sie den kopierten JSON-Text in das Feld "Schema" ein.
Wählen Sie als Authentifizierung "API Key" (als Query-Parameter). Der Name des Parameters lautet "apitoken", der Wert ist Ihr Leeway-Token.
Speichern Sie die Konfiguration. Die Endpunkte stehen nun als Aktionen zur Verfügung.

OpenAPI-Spezifikation

Andere MCP-Clients

Jeder MCP-kompatible Client verbindet sich mit denselben zwei Angaben: dem Endpunkt und dem Authorization-Header. Der Endpunkt ist für MCP-Clients gedacht – nicht zum Öffnen im Browser (dort erscheint nur eine Auth-Meldung).

Endpunkthttps://mcp.leeway.tech/mcp

Auth-HeaderAuthorization: Bearer YOUR_TOKEN

Hinweis: Der MCP-Endpunkt gibt beim direkten Aufruf im Browser eine Auth-Fehlermeldung zurück – das ist normal. Er wird nur vom MCP-Client mit Token verwendet.

Fehlerbehebung

Es erscheinen keine Tools.

Prüfen Sie, ob der Server im Client aktiviert und aktualisiert wurde. Nach dem Bearbeiten der Konfiguration ist meist ein Neustart oder Refresh nötig.

401 / Nicht autorisiert.

YOUR_TOKEN wurde nicht ersetzt oder der Token ist ungültig. Holen Sie einen frischen Token im Account-Bereich.

Limit erreicht.

Der kostenlose Tarif umfasst 50 Anfrage-Einheiten pro Tag. Für den produktiven Einsatz bietet das Data-API-Paket 100.000 pro Tag.

Leeway MCP mit Ihrem Client verbinden