MCP-Server (Model Context Protocol)

SovrGPT als MCP-Server in Cursor, Claude Desktop, Zed & Windsurf einbinden — souveräne EU-Modelle direkt im Editor.

SovrGPT veröffentlicht zwei MCP-Server (Model Context Protocol, Spec):

Endpoint	Auth	Zweck
`https://sovrgpt.com/mcp/docs/mcp`	keine	Dokumentations-Lookup — jeder MCP-Client kann SovrGPT-Doku live durchsuchen.
`https://sovrgpt.com/mcp/mcp`	`Authorization: Bearer sov_…`	Plattform-Tools — Chat, Web-Search, Bild- und Video-Generierung.

Beide Endpoints sprechen Streamable HTTP (MCP 2025-03-26). Für ältere Clients gibt es zusätzlich SSE unter /mcp/docs/sse bzw. /mcp/sse.

Dokumentations-MCP (öffentlich)

Werkzeuge:

sovrgpt_docs_list_pages — alle MDX-Seiten auflisten
sovrgpt_docs_search — Volltextsuche über Doku + docs/api-reference.md
sovrgpt_docs_get_page — Seite als Markdown lesen
sovrgpt_docs_api_endpoints — REST-Endpunkte enumerieren

Kein API-Key nötig. Gedacht für Editor-Modelle, die deinen Code mit SovrGPT integrieren sollen (Migration, Routing, neue Modell-IDs nachschlagen).

Plattform-MCP (authentifiziert)

Werkzeuge:

Tool	Was es tut
`sovrgpt_list_models`	Aktiver Modell-Katalog (Tier, Sprach-/Code-/Reasoning-Rating, Lizenz).
`sovrgpt_chat`	Chat-Completion gegen ein SovrGPT-Modell (EU-gehostet).
`sovrgpt_web_search`	Brave-Live-Suche (max. 6 Treffer).
`sovrgpt_generate_image`	Z-Image-Turbo / FLUX.2 klein — synchron bis ~80 s, sonst `pending` + Poll-URL.
`sovrgpt_generate_video`	LTX-Video — immer `pending` + Poll-URL (Cold-Start 3–5 min).

Auth: einen sov_…-API-Key unter Einstellungen → API-Keys erzeugen und als Bearer-Token mitgeben. Quota-/Kosten-Logging läuft identisch zur REST-API (/api/v1/chat/completions).

Setup pro Client

Cursor

Cursor Settings → MCP → Add new global MCP server:

{
  "mcpServers": {
    "sovrgpt-docs": {
      "url": "https://sovrgpt.com/mcp/docs/mcp"
    },
    "sovrgpt": {
      "url": "https://sovrgpt.com/mcp/mcp",
      "headers": {
        "Authorization": "Bearer sov_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

Speichern, Cursor neu starten, im Chat @ → Tool-Liste prüfen. Die sovrgpt_*-Tools tauchen direkt auf.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) bzw. %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "sovrgpt-docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://sovrgpt.com/mcp/docs/mcp"]
    },
    "sovrgpt": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://sovrgpt.com/mcp/mcp",
        "--header",
        "Authorization:Bearer sov_xxxxxxxxxxxxxxxx"
      ]
    }
  }
}

mcp-remote (npm) brückt von Claudes stdio-Transport auf Streamable HTTP. Claude Desktop neu starten.

Zed

~/.config/zed/settings.json:

{
  "context_servers": {
    "sovrgpt-docs": {
      "command": {
        "path": "npx",
        "args": ["-y", "mcp-remote", "https://sovrgpt.com/mcp/docs/mcp"]
      }
    },
    "sovrgpt": {
      "command": {
        "path": "npx",
        "args": [
          "-y", "mcp-remote",
          "https://sovrgpt.com/mcp/mcp",
          "--header", "Authorization:Bearer sov_xxxxxxxxxxxxxxxx"
        ]
      }
    }
  }
}

Windsurf

Settings → Cascade → MCP servers → Add server → Streamable HTTP. URL + Header analog zu Cursor.

Hinweise

Keine Streaming-Antworten: der MCP-Wrapper liefert sovrgpt_chat-Ergebnisse als ein Tool-Result. Für Live-Streaming nutze die REST-API (/api/v1/chat/completions mit stream:true).
Bild/Video-Polling: der Tool-Output enthält im pending-Fall ein poll_url-Feld; nutze denselben sov_…-Key per GET.
Cold-Starts: sovrgpt_chat blockt bis zu 13 Minuten beim ersten Aufruf eines kalten Tiers. Lade Tier per sovrgpt_list_models und wähle einen warmen tier (i. d. R. default).
Logging: jeder MCP-Tool-Call landet in usage_events.source = 'mcp' und zählt gegen das Monatsbudget der Org — identisch zur REST-API.

API-Keys mit Authorization: Bearer-Header werden nur server-seitig geprüft (api_keys-Tabelle, SHA-256, RLS). Über Einstellungen → API-Keys jederzeit widerrufen — der MCP-Server lehnt den nächsten Call sofort mit 401 ab. Wir empfehlen pro Client einen eigenen Key.