Dokumentation / Oberflächen

Claude Code & andere Agenten

Jeder MCP-fähige Agent verbindet sich mit demselben Werkzeug-Satz wie Command Center — offener Standard, keine cegtec-Eigenentwicklung.

Command ist nicht auf die eingebaute Chat-Oberfläche beschränkt. Jeder MCP-fähige Agent kann sich mit demselben Werkzeug-Satz verbinden, den auch Command Center im Browser nutzt — das ist die Operator-Ebene außerhalb der App, primär für das cegtec-Team im Betrieb, aber offen für jeden, der tiefer eingreifen will.

Verbinden

Sie brauchen genau zwei Dinge: die Endpunkt-URL und Ihren Workspace-Schlüssel.

https://app.cegtec.net/api/mcp/IHR_SCHLUESSEL

Den Schlüssel finden Sie im Bereich Extensions in der Web-App. Aus einer bereits verbundenen Sitzung liefert get_mcp_key ihn ebenfalls, generate_mcp_key rotiert ihn.

Die URL ist das Passwort. Der Schlüssel steht im Pfad, es gibt keinen separaten Header. Wer die vollständige URL hat, hat Zugriff auf den Workspace — behandeln Sie sie wie ein Zugangstoken: nicht in ein öffentliches Repository, nicht in einen Chat, nicht in ein Ticket. Verdacht auf Weitergabe? generate_mcp_key rotiert sofort, die alte URL ist danach tot.

Der Endpunkt spricht Streamable HTTP — den aktuellen MCP-Transport, nicht das ältere SSE.

Claude Code

claude mcp add --transport http gtm-goat https://app.cegtec.net/api/mcp/IHR_SCHLUESSEL

Cursor

In ~/.cursor/mcp.json (global) oder .cursor/mcp.json (pro Projekt):

{
  "mcpServers": {
    "gtm-goat": {
      "url": "https://app.cegtec.net/api/mcp/IHR_SCHLUESSEL"
    }
  }
}

VS Code

In .vscode/mcp.json:

{
  "servers": {
    "gtm-goat": {
      "type": "http",
      "url": "https://app.cegtec.net/api/mcp/IHR_SCHLUESSEL"
    }
  }
}

Clients ohne HTTP-Transport

Manche Clients sprechen bislang nur den lokalen stdio-Transport. Dafür gibt es die offizielle Brücke mcp-remote, die den HTTP-Endpunkt lokal verfügbar macht:

{
  "mcpServers": {
    "gtm-goat": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.cegtec.net/api/mcp/IHR_SCHLUESSEL"]
    }
  }
}

Dasselbe Muster funktioniert für jeden stdio-Client — Claude Desktop, Codex CLI und andere. Prüfen Sie im Zweifel in der Doku Ihres Clients, ob er url (HTTP) direkt unterstützt; wenn ja, ist der direkte Weg der bessere.

Läuft es?

Ein verbundener Client listet die Werkzeuge selbst auf. Ein guter erster Aufruf ist explain_system — er gibt das Systemmodell als strukturiertes JSON zurück, und wenn er antwortet, steht die Verbindung.

Wenn es nicht läuft

AntwortWas sie bedeutet
401 Invalid API keySchlüssel falsch, vertippt oder rotiert. Neu aus Extensions holen.
403 MCP-Zugriff ist ab dem Growth-Plan verfügbarKein Fehler, sondern der Tarif — siehe unten.
429 Too many failed attemptsZu viele Fehlversuche von dieser IP. Der Retry-After-Header nennt die Wartezeit.

Voraussetzung: Growth-Plan

MCP-Zugriff ist ab Growth verfügbar (Growth und Enterprise). Workspaces aus der Zeit vor den Selbstbedienungs-Tarifen behalten ihren Zugang unverändert. Ein Upgrade wirkt sofort — der Endpunkt cacht die Ablehnung nicht.

MCP ist ein offener Standard, kein cegtec-eigenes Protokoll: Claude Code ist die empfohlene Referenz, aber jeder andere MCP-Client verbindet sich auf demselben Weg und sieht dieselben Werkzeuge.

Was der Agent beim Verbinden bekommt

Jeder Client erhält beim Connect die Server-Instructions — den InitializeResult.instructions-Teil des MCP-Protokolls — mit einer Erklärung des Systemmodells: die neun Begriffe, das Objektmodell, die Regeln, denen jeder Agent folgen muss. Das explain_system-Tool liefert dieselbe Orientierung jederzeit erneut als strukturiertes JSON ab. Beides ist Standard-MCP-Mechanik, funktioniert also identisch für jeden Client, nicht nur für Claude Code.

Mehr als die Kunden-Ebene

Operator-Zugriff sieht den vollen Werkzeug-Satz, nicht nur das kuratierte Set aus Command Center — inklusive Bulk-Operationen über viele Zeilen und Playbooks hinweg, und die Möglichkeit, ganze Abläufe als Skript statt als einzelne Chat-Nachricht zu fahren. Der vollständige Werkzeug-Satz wird direkt über den MCP-Endpoint des Workspace bereitgestellt: Jeder angebundene MCP-Client listet die verfügbaren Werkzeuge selbst auf.

Governance gilt trotzdem

Freigaben, Workspace-Isolation und der Kosten-Deckel sind serverseitig durchgesetzt, nicht clientseitig — sie gelten unabhängig davon, welcher Agent sich verbindet, weil sie an den MCP-Schlüssel gebunden sind, nicht an die Client-Software. Auch ein Operator-Agent schlägt vor, ein Mensch gibt frei; siehe Freigaben und Kosten.

Siehe auch: Command für die Kunden-Ebene derselben Oberfläche.