MCP-Server: SovrGPT in Cursor, Claude Desktop und Zed

Über das Model Context Protocol (Spezifikation) binden Sie SovrGPT in Cursor, Claude Desktop, Zed oder Windsurf ein. Es gibt zwei Server:

Beide sprechen Streamable HTTP (MCP 2025-03-26). Ältere Clients erreichen sie per SSE unter /mcp/docs/sse bzw. /mcp/sse.

Dokumentations-MCP (öffentlich)

Werkzeuge:

• sovrgpt_docs_list_pages: alle Doku-Seiten auflisten
• sovrgpt_docs_search: Volltextsuche über alle Doku-Seiten
• sovrgpt_docs_get_page: eine Seite als Markdown lesen

Ein API-Schlüssel ist nicht nötig. Gedacht ist der Server für Editor-Modelle, die Ihren Code an SovrGPT anbinden sollen, etwa bei einer Migration oder um neue Modell-IDs nachzuschlagen.

Sprache: Jedes Werkzeug nimmt den optionalen Parameter language an (de oder en, Vorgabe de). Seiten ohne englische Fassung kommen auf Deutsch zurück und tragen translated: false. So kann ein Modell den Sprachwechsel offen sagen.

Plattform-MCP (mit API-Schlüssel)

Anmeldung: Legen Sie unter Einstellungen → API-Keys einen sov_…-Schlüssel mit Scope mcp an und senden Sie ihn als Bearer-Token. Ohne diesen Scope lehnt der Server schon den Verbindungsaufbau mit 401 ab.

Scope-Regel für sovrgpt_decide: Der Scope mcp öffnet die Verbindung, eine Entscheidung braucht zusätzlich decisions (dieselbe Berechtigung wie POST /v1/decisions). Fehlt er, antwortet das Werkzeug mit { "status": "failed", "code": "missing_scope" }; die übrigen Werkzeuge bleiben mit demselben Schlüssel nutzbar. Kreuzen Sie beim Anlegen des Schlüssels also Decision Engine mit an.

Jede Antwort trägt eine Empfehlung recommendation ("act" oder "review") und die Warnsignale in reasons. Die Altfelder abstain und abstain_reasons bleiben erhalten; abstain ist genau dann true, wenn die Empfehlung "review" lautet. Die Vorgabe ist policy.mode = "threshold" (Schwelle 0,85, Doppelprüfung der Auswahlfragen an): "review" kommt nur bei Warnsignalen. Bis zum 23.09.2026 trug jede Antwort abstain: true.

• policy.mode = "review_only": Jede Empfehlung lautet "review". Nehmen Sie das, wenn ein Editor-Modell nichts ungeprüft ausführen soll.
• policy = { "mode": "review_only", "stability_check": false }: genau das alte Verhalten zu den alten Kosten, ohne Doppelprüfung.
• policy.mode = "autonomous": Jede Empfehlung lautet "act", die Warnsignale stehen trotzdem in reasons.

Die Wahrscheinlichkeiten sind nicht kalibriert (calibration.status = "uncalibrated"). Details: Automatik oder Mensch.

Einrichtung je 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 und im Chat mit @ die Werkzeugliste prüfen. Die sovrgpt_*-Werkzeuge erscheinen dort direkt.

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) übersetzt zwischen Claudes stdio-Transport und Streamable HTTP. Danach 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 und Header wie bei Cursor.

Hinweise

• Kein Streaming: sovrgpt_chat liefert die Antwort als ein einziges Werkzeugergebnis. Für Live-Streaming nutzen Sie die REST-API (/api/v1/chat/completions mit stream:true).
• Bild/Video-Polling: Im Fall pending enthält das Werkzeugergebnis ein Feld poll_url (/api/image/<id> bzw. /api/video/job/<id>). Fragen Sie es per GET mit demselben Schlüssel ab: Authorization: Bearer sov_…, Scope mcp, ohne Cookie. Jede Antwort ist ein 200 mit einem Feld status. pending heißt weiter abfragen (Bild etwa alle 5 s, Video etwa alle 10 s). succeeded (Bild) bzw. done (Video) liefert das Ergebnis in signedUrl; die Adresse gilt eine Stunde, eine erneute Abfrage stellt eine frische aus. failed nennt den Grund in error. Achtung: Das Werkzeugergebnis meldet Erfolg als complete, die Poll-Antwort als succeeded bzw. done. Warten Sie beim Pollen also nicht auf complete.
• Kaltstarts: Beim ersten Aufruf eines kalten, selbst betriebenen Modells wartet sovrgpt_chat bis zu 13 Minuten. Auch der Standard-Tier, den das Werkzeug ohne model nimmt, hat einen Kaltstart. Suchen Sie per sovrgpt_list_models ein Modell, dessen cold_start_hint „kein Kaltstart“ nennt, und geben Sie dessen ID als model mit.
• Decision Engine: sovrgpt_decide erwartet genau eines von state und messages; preset und questions schließen sich aus. Vorlagen, deren example_state ein JSON-String ist (antrag-vollstaendigkeit-v1, grounding-check-v1, agent-step-risk-v1), erwarten ein JSON-Objekt als state. Eine Entscheidung dauert typischerweise deutlich unter einer Sekunde, einen Kaltstart gibt es nicht. Scheitert sie, kommt { "status": "failed", "code": … } mit einem Code aus der Fehlertabelle. Bei upstream_rate_limited drosselt die Laufzeit gerade: kurz warten und wiederholen. Scheitert nur der zweite Durchlauf der Doppelprüfung, ist das kein Fehler. Die Antwort kommt dann mit stability: null und dem Warnsignal stability_unavailable. Mehr: Decision Engine, Vertrag: POST /v1/decisions.
• Abrechnung: Jeder Werkzeugaufruf zählt wie bei der REST-API gegen das Monatsbudget Ihrer Organisation. Als Quelle (usage_events.source) erscheint der Chat als mcp, Bilder und Videos als image bzw. video. sovrgpt_decide erscheint als decisions-mcp, abgerechnet nach Eingabetoken der Laufzeit wie bei POST /v1/decisions. Die Websuche erzeugt keine Kostenzeile.

Sicherheit

Schlüssel im Authorization: Bearer-Header werden nur serverseitig geprüft und nur als SHA-256-Hash gespeichert. Unter Einstellungen → API-Keys widerrufen Sie einen Schlüssel jederzeit; der nächste Aufruf scheitert dann sofort mit 401. Wir empfehlen einen eigenen Schlüssel je Client.