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
- API-Key besorgen vom MCP-Server (Corcava: Einstellungen → Integrationen → Public API)
- Konfigurationsdatei des Clients finden (je nach Client und OS unterschiedlich)
- Server-Endpoint-URL eintragen (Corcava:
https://app.corcava.com/mcp) - Authorization-Header mit API-Key eintragen (
Bearer IHR_API_KEY) - Konfigurationsdatei speichern
- KI-Client neu starten (damit Änderungen wirksam werden)
- Prüfen, ob Tools erscheinen – KI nach verfügbaren Tools fragen
- 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:
- Im Corcava-Workspace anmelden
- Einstellungen → Integrationen öffnen
- Bereich Public API finden
- Auf API-Key hinzufügen klicken
- Den erzeugten Key sofort kopieren (wird nur einmal angezeigt)
- 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:
Die URL sollte:
- HTTPS: Immer sichere Verbindung (nie HTTP)
- Exakt: URL genau so übernehmen – kein Schrägstrich am Ende
- Erreichbar: Netzwerk muss den Endpoint erreichen (ggf. Firewall/Proxy prüfen)
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:
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:
- Konfigurationsdatei speichern (falls Sie eine Datei bearbeiten)
- JSON-Syntax prüfen (bei Unsicherheit einen JSON-Validator nutzen)
- KI-Client vollständig neu starten – Schließen und erneutes Öffnen nötig
- 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:
list_tasks– Aufgaben suchen und filternget_task– Aufgabendetails abrufencreate_task– Neue Aufgaben anlegenupdate_task– Aufgabendetails aktualisierenlist_projects– Projekte auflistenstart_time_tracking– Timer starten- und weitere (siehe vollständige Tool-Referenz)
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):
- Ruft
list_tasksmit Filtern für Fälligkeit auf - Erhält die Aufgabenliste von Corcava
- 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
❌ „Connection refused“ oder Netzwerkfehler
- Internetverbindung prüfen
- Prüfen, ob
https://app.corcava.comim Browser erreichbar ist - Firmen-Firewall/Proxy prüfen
- API-Key ggf. neu erzeugen
❌ 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
Client-spezifische Anleitungen
Detaillierte Schritt-für-Schritt-Anleitungen pro Client:
Claude Desktop
Vollständiges Setup für macOS, Windows und Linux
Cursor
IDE-Setup mit Workflow-Beispielen
Windsurf
Konfiguration über die Einstellungs-UI
Continue
SSE-Transport-Konfiguration
Bereit zum Verbinden?
API-Key holen und KI-Assistent in wenigen Minuten verbinden
Keine Kreditkarte erforderlich