MCP-Client verbinden

Copera MCP Cloud ist über einen einzigen Streamable-HTTP-Endpunkt erreichbar. Richten Sie Ihren KI-Client darauf, liefern Sie ein Bearer-Token, und der Tool-Katalog erscheint automatisch.

Endpunkt

MCP-Endpunkt	https://mcp.copera.ai/mcp
Transport	Streamable HTTP (POST)
Auth-Header	Authorization: Bearer cp_pat_… oder cp_oat_…

Zustandsloser Transport

Der Server läuft im zustandslosen Modus — es gibt keine Sessions zum Fortsetzen. Nur POST /mcp wird unterstützt; GET und DELETE liefern 405. Ein Health-Check ist unter GET /health verfügbar.

Sie brauchen ein Token, bevor Sie verbinden. Die einfachste Option ist ein Personal Access Token (cp_pat_…), erstellt in den Workspace-Einstellungen von Copera. Siehe Authentifizierung für PATs vs. OAuth und wie Scopes auf Tools mappen.

Client verbinden

Token erstellen

Erzeugen Sie ein Personal Access Token (cp_pat_…) in Ihrem Copera-Workspace und gewähren Sie die Scopes, die Ihr Agent braucht — z. B. access_boards und access_docs. Behandeln Sie es wie ein Passwort.

Server zum MCP-Client hinzufügen

Konfigurieren Sie Ihren Client mit der Endpunkt-URL und dem Bearer-Token. Die meisten Clients akzeptieren entweder einen Remote-Server-Config-Block oder einen mcp-remote-Bridge-Befehl.

Remote server (JSON)

{
  "mcpServers": {
    "copera": {
      "type": "http",
      "url": "https://mcp.copera.ai/mcp",
      "headers": {
        "Authorization": "Bearer cp_pat_YOUR_TOKEN_HERE"
      }
    }
  }
}

mcp-remote bridge

Für Clients, die nur lokale stdio-Server unterstützen, bridgen Sie zum Remote-Endpunkt mit mcp-remote:

{
  "mcpServers": {
    "copera": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.copera.ai/mcp",
        "--header",
        "Authorization: Bearer cp_pat_YOUR_TOKEN_HERE"
      ]
    }
  }
}

Neu laden und Tools prüfen

MCP-Client neu starten oder neu laden. Der Server copera sollte verbinden und seine Tools freigeben (list_boards, search, search_docs usw.). Wenn der Client Tool-Discovery unterstützt, sehen Sie den vollen Katalog aus der Tool-Referenz.

Ersten Aufruf machen

Bitten Sie das Modell, get_workspace_info aufzurufen — ein schreibgeschütztes Tool, das bestätigt, dass das Token den richtigen Workspace auflöst. Von dort aus läuft list_boards → list_tables → list_rows den Discovery-Flow ab.

OAuth-Connectors

Manche Clients (z. B. Claude mit Remote-Connectors) können sich per OAuth statt mit eingefügtem Token verbinden. Wenn Sie die Server-URL ohne Bearer hinzufügen, erhält der Client ein 401 mit WWW-Authenticate-Challenge und startet den OAuth-Flow automatisch, der ein Token cp_oat_… ausstellt. Siehe Authentifizierung.

Mit dem MCP Inspector testen

Der MCP Inspector ist der schnellste Weg, Konnektivität zu bestätigen und Tools manuell zu erkunden, bevor Sie einen Agenten verdrahten.

Inspector starten

npx @modelcontextprotocol/inspector

Verbindung konfigurieren

In der Inspector-UI:

• Transport type: Streamable HTTP
• URL: https://mcp.copera.ai/mcp
• Authentication: Header Authorization mit dem Wert Bearer cp_pat_YOUR_TOKEN_HERE hinzufügen

Tools listen und aufrufen

Verbinden, Tab Tools öffnen — Sie sollten alle 37 Tools sehen. Rufen Sie get_workspace_info auf, um das Token zu prüfen, dann list_boards für Lesezugriff.

Tokens geheim halten

Wer Ihr Bearer-Token hält, kann innerhalb seiner Scopes als Sie handeln. Committen Sie Tokens nicht in die Versionskontrolle und fügen Sie sie nicht in geteilte Configs ein. Rotieren Sie ein Token sofort bei einem Leak.

Fehlerbehebung

Symptom	Wahrscheinliche Ursache
401 Unauthorized	Fehlendes, fehlerhaftes oder abgelaufenes Bearer-Token. Header Authorization: Bearer … prüfen.
403 Forbidden bei einem Tool	Dem Token fehlt der Scope, den das Tool braucht (z. B. access_docs für Dokument-Tools). Siehe Authentifizierung.
405 Method Not Allowed	Der Client hat GET/DELETE an /mcp gesendet. Der Server ist zustandslos — POST verwenden.
Tools fehlen im Client	Server verbunden, aber Client hat Tools gefiltert, oder das Token löst einen Workspace ohne diese Daten auf. Mit dem Inspector prüfen.