Corcava logo Das einzige Business-Tool, das Sie brauchen Corcava
Menü

Beliebigen MCP-Client mit Remote-MCP-Server verbinden

Universelle Checkliste für die Verbindung eines beliebigen MCP-Clients mit einem Remote-MCP-Server. Die genauen Konfigurationsschritte unterscheiden sich je nach Client, die Grundprinzipien sind gleich. Corcava dient durchgehend als Beispiel.

Universelle Verbindungs-Checkliste

Unabhängig vom MCP-Client sind diese Schritte nötig:

Schritt-für-Schritt-Checkliste

  1. API-Key besorgen vom MCP-Server (Corcava: Einstellungen → Integrationen → Public API)
  2. Konfigurationsdatei des Clients finden (je nach Client und OS unterschiedlich)
  3. Server-Endpoint-URL eintragen (Corcava: https://app.corcava.com/mcp)
  4. Authorization-Header mit API-Key eintragen (Bearer IHR_API_KEY)
  5. Konfigurationsdatei speichern
  6. KI-Client neu starten (damit Änderungen wirksam werden)
  7. Prüfen, ob Tools erscheinen – KI nach verfügbaren Tools fragen
  8. Mit einfachem Prompt testen – bestätigen, dass alles funktioniert

Schritt 1: API-Key besorgen

Vor der Verbindung benötigen Sie einen API-Key vom MCP-Server. Bei Corcava:

  1. Im Corcava-Workspace anmelden
  2. EinstellungenIntegrationen öffnen
  3. Bereich Public API finden
  4. Auf API-Key hinzufügen klicken
  5. Den erzeugten Key sofort kopieren (wird nur einmal angezeigt)
  6. Sicher aufbewahren – wird in den nächsten Schritten benötigt

⚠️ Sicherheitshinweis

Für verschiedene KI-Assistenten getrennte API-Keys anlegen. So können Sie den Zugriff pro Client widerrufen. Keys aussagekräftig benennen (z. B. „Claude Desktop – MacBook“, „Cursor – Arbeits-Laptop“).

Schritt 2: Konfigurationsdatei des Clients finden

Jeder MCP-Client speichert die Konfiguration an einem anderen Ort. Typische Orte:

Claude Desktop

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

Cursor

  • Alle Plattformen: ~/.cursor/mcp.json

Windsurf

  • Alle Plattformen: Einstellungs-UI (keine Dateibearbeitung nötig)

Continue

  • Alle Plattformen: ~/.continue/config.json

Detaillierte, client-spezifische Anleitungen:

Schritt 3: Server-Endpoint-URL eintragen

Die Endpoint-URL ist die Adresse, mit der Ihr MCP-Client sich zum Server verbindet. Bei Corcava:

https://app.corcava.com/mcp

Die URL sollte:

Schritt 4: Authorization-Header eintragen

Die meisten MCP-Clients verlangen einen Authentifizierungs-Header. Bei Corcava: Authorization-Header mit Ihrem API-Key.

Header-Format

Der Header muss exakt so aussehen:

Authorization: Bearer IHR_API_KEY

Wichtig: Zwischen „Bearer“ und dem API-Key muss ein Leerzeichen stehen. Den Key nicht in Anführungszeichen setzen.

Beispiel-Konfigurationssnippets

Claude Desktop / Cursor:

{
  "mcpServers": {
    "corcava": {
      "url": "https://app.corcava.com/mcp",
      "headers": {
        "Authorization": "Bearer IHR_API_KEY"
      }
    }
  }
}

Continue (SSE):

{
  "mcpServers": [
    {
      "name": "corcava",
      "transport": {
        "type": "sse",
        "url": "https://app.corcava.com/mcp",
        "headers": {
          "Authorization": "Bearer IHR_API_KEY"
        }
      }
    }
  ]
}

⚠️ Typische Fehler

  • Fehlendes Leerzeichen nach „Bearer“
  • API-Key im Header-Wert in Anführungszeichen
  • „Token“ statt „Bearer“
  • Leerzeichen beim Kopieren des Keys
  • Abgelaufener oder widerrufener API-Key

Schritt 5: Speichern und Neustart

Nach dem Eintragen der Konfiguration:

  1. Konfigurationsdatei speichern (falls Sie eine Datei bearbeiten)
  2. JSON-Syntax prüfen (bei Unsicherheit einen JSON-Validator nutzen)
  3. KI-Client vollständig neu starten – Schließen und erneutes Öffnen nötig
  4. Warten, bis der Client geladen hat – kann einige Sekunden dauern

Warum Neustart nötig ist

MCP-Clients laden die Konfiguration in der Regel nur beim Start. Nur Speichern reicht nicht – die Anwendung muss vollständig beendet und neu gestartet werden. Manche Clients (z. B. Cursor) haben einen „Reload“-Befehl; ein vollständiger Neustart ist am zuverlässigsten.

Schritt 6: Prüfen, ob Tools erscheinen

Nach dem Neustart prüfen, ob Ihr KI-Client die Tools des MCP-Servers sieht:

Verifizierungs-Prompts

Der KI-Assistenten z. B. eine dieser Fragen stellen:

  • „Welche MCP-Tools sind verfügbar?“
  • „Liste alle verfügbaren Tools von Corcava“
  • „Was kannst du mit Corcava machen?“

Die KI sollte mit einer Tool-Liste antworten, z. B. list_tasks, create_task, start_time_tracking usw.

Erwartete Tool-Liste

Bei Corcava sollten u. a. diese Tools sichtbar sein:

Schritt 7: Erster Test-Prompt

Wenn die Tools sichtbar sind, mit einer einfachen Nur-Lesen-Operation testen:

Sichere Test-Prompts

Mit Nur-Lesen-Operationen starten, die keine Daten ändern:

  • „Welche Aufgaben habe ich in Corcava?“ – testet list_tasks
  • „Zeige meine Projekte“ – testet list_projects
  • „Welche Boards sind verfügbar?“ – testet list_boards

Hinweis: Wenn Sie noch keine Aufgaben/Projekte haben, liefert die KI eine leere Liste – die Verbindung ist trotzdem erfolgreich.

Beispiel: Test mit Corcava

Sie: „Welche Aufgaben haben diese Woche in Corcava Fälligkeit?“

KI (über MCP):

  1. Ruft list_tasks mit Filtern für Fälligkeit auf
  2. Erhält die Aufgabenliste von Corcava
  3. Formatiert und zeigt Ihnen die Ergebnisse

Wenn das funktioniert, ist die Verbindung erfolgreich.

Verbindungsprobleme beheben

Wenn Tools nicht erscheinen oder Fehler auftreten, diese Punkte prüfen:

❌ „Authorization failed“ oder 401

  • API-Key nochmals prüfen (keine zusätzlichen Leerzeichen)
  • In Corcava unter Einstellungen → Integrationen prüfen, ob Key aktiv ist
  • „Bearer“-Präfix mit Leerzeichen verwenden
  • Beim Kopieren des Keys auf Leerzeichen am Ende achten

401-Fehlerbehebung →

❌ „Connection refused“ oder Netzwerkfehler

  • Internetverbindung prüfen
  • Prüfen, ob https://app.corcava.com im Browser erreichbar ist
  • Firmen-Firewall/Proxy prüfen
  • API-Key ggf. neu erzeugen

Verbindungs-Fehlerbehebung →

❌ Tools werden nicht angezeigt

  • Client wirklich vollständig neu gestartet? (nicht nur Datei gespeichert)
  • JSON-Syntax prüfen (keine trailing commas, korrekte Anführungszeichen)
  • Prüfen, ob Konfigurationsdatei am richtigen Ort liegt
  • Client-Logs auf Fehlermeldungen prüfen

Tools-Fehlerbehebung →

Client-spezifische Anleitungen

Detaillierte Schritt-für-Schritt-Anleitungen pro Client:

Bereit zum Verbinden?

API-Key holen und KI-Assistent in wenigen Minuten verbinden

Keine Kreditkarte erforderlich