Claude Desktop mit CoCoCo verbinden

Es gibt zwei Wege, Claude Desktop mit CoCoCo zu verbinden. Für fast alle ist Option A richtig — eine einzige Datei, etwa eine Minute Aufwand, kein Terminal, keine Node.js-Installation und kein Bearbeiten von Konfigurationsdateien. Das Konfigurationsformular zeigt viele Felder, aber Pflicht sind nur zwei: Endpoint URL und API Key. Alles andere ist optional. Option B (der manuelle Proxy) bleibt nur für fortgeschrittene Nutzer, die volle Kontrolle brauchen.

Option A — Die CoCoCo-Extension installieren (empfohlen)

Aktuelle Version: 1.2.1 · veröffentlicht 2026-08-31 Download: cococo.mcpb

CoCoCo kommt als Claude-Desktop-Extension (eine .mcpb-Datei). Die Installation ist wie das Hinzufügen einer Browser-Erweiterung: eine Datei hineinziehen und zwei Werte einfügen.

Bevor du startest

Claude Desktop installiert — Download unter claude.ai/download
Deine Endpoint URL und ein aktives API Token — beides auf der Seite MCP Connection in CoCoCo

Du brauchst kein Node.js und keine weitere Software — Claude Desktop bringt seine eigene Laufzeitumgebung mit.

Schritt 1 — Endpoint URL und Token aus CoCoCo kopieren

Öffne in CoCoCo die MCP Connection-Einstellungen.
Klicke Copy neben der Endpoint URL (sie sieht aus wie https://<your-domain>/mcp).
Halte ein aktives API Token von derselben Seite bereit (es dient als Bearer-Credential).

Schritt 2 — Extension installieren

Lade die Datei cococo.mcpb herunter.
Öffne in Claude Desktop das Menü (☰) oben links und gehe zu File → Settings → Extensions.
Ziehe cococo.mcpb auf die Extensions-Seite (oder nutze Install Extension… und wähle die Datei).
Möglicherweise erscheint ein Sicherheitshinweis, weil die Extension privat statt über das öffentliche Verzeichnis verteilt wird. Das ist erwartet — wähle Install Anyway.

Schritt 3 — Deine Daten eingeben

Das Formular gruppiert die Felder pro Umgebung („Instance 1”, „Instance 2”, „Instance 3”). Für eine einzelne Umgebung füllst du nur die ersten zwei Felder aus und lässt den Rest, wie er ist.

Pflichtfelder

Endpoint URL — die in Schritt 1 kopierte URL einfügen (z. B. https://<your-domain>/mcp)
API key — dein CoCoCo-API-Token einfügen; es dient als Bearer-Credential

Optionale Felder

Name — kurzes Label (z. B. „Prod”, „Staging”). Es wird als Präfix auf den Tools dieser Umgebung angezeigt, sobald mehr als eine Umgebung konfiguriert ist. Leer gelassen, wird der Name aus dem Hostnamen abgeleitet.
Enabled — standardmäßig aktiv. Ausschalten deaktiviert die Umgebung, ohne URL und Token zu verlieren: keine Verbindung, keine Tools.
Read-only — standardmäßig aus. Eingeschaltet werden nur lesende Tools angeboten; schreibende Tools werden ausgeblendet und abgewiesen.
Tool filter — kommagetrennte Muster, die einschränken, welche Tools bei Claude ankommen; ein führendes - schließt aus. Beispiele: -*_mutation,-train_* oder describe_*,search_*,execute_sql. Reine Anzeige-Hygiene — maßgeblich bleiben deine serverseitigen Tool-Berechtigungen.

Die Felder für Instance 2 und Instance 3 bleiben leer, wenn du nur eine Umgebung nutzt — siehe „Mehrere Umgebungen verbinden”.

Nach Änderungen an diesen Feldern immer Save drücken und danach eine neue Unterhaltung öffnen.

Dein Token wird verschlüsselt im sicheren Speicher deines Betriebssystems abgelegt (macOS Keychain / Windows Credential Manager), nicht in einer Klartextdatei.

Schritt 4 — Prüfen

Öffne eine neue Unterhaltung, klicke auf das Tools-Symbol (Hammer) unten im Eingabefeld und bestätige, dass CoCoCo erscheint. Oder frag Claude direkt:

„What CoCoCo tools do you have access to?”

Mehrere Umgebungen verbinden

Du kannst bis zu drei CoCoCo-Umgebungen gleichzeitig verbinden. Füll dazu den Block Instance 2 (und bei Bedarf Instance 3) aus: Endpoint URL, API key und am besten einen Namen.

Sind mehrere Umgebungen verbunden, werden die Tools jeder Umgebung mit ihrem Namen als Präfix angezeigt, damit sie sich nie überschneiden — aus „Staging” wird Staging__execute_sql, aus „Sandbox DE” wird Sandbox-DE__execute_sql (Leerzeichen werden zu Bindestrichen). Bei einer einzigen Umgebung gibt es kein Präfix.

Jede Umgebung hat ihre eigenen Schalter, du kannst sie also unterschiedlich absichern — zum Beispiel Staging voll beschreibbar und die Sandbox nur lesend.

Schreibschutz und Tool-Filter

Read-only ist die einfachste Absicherung: eingeschaltet verschwinden alle schreibenden Tools aus der Liste, und selbst ein direkter Aufruf wird abgewiesen. Betroffen sind unter anderem create_custom_app, update_custom_app, replace_in_file, create_version, import_workflow, train_ml_model, execute_graphql_mutation sowie die Integration-Tools (create_integration_draft, update_integration_file, update_integration_manifest, publish_integration). Empfehlung: Produktivumgebungen auf Read-only stellen und in Staging oder Sandbox arbeiten.

Tool filter ist dagegen keine Sicherheitsfunktion, sondern Aufräumen: Sind mehrere Umgebungen verbunden, sieht Claude sehr viele Tools. Mit describe_*,search_*,execute_sql reduzierst du eine Umgebung auf reine Recherche, mit -*_mutation,-train_* blendest du gezielt einzelne Tools aus. Die eigentliche Autorität bleiben immer die serverseitigen Berechtigungen deines API-Tokens.

Diagnose

Die Extension bringt ein Tool namens cococo_diagnostics mit. Frag Claude einfach:

„Run CoCoCo diagnostics”

Die Ausgabe zeigt die Version der Extension, alle konfigurierten Umgebungen, den jeweiligen Modus (full oder read), wie viele Tools angeboten bzw. ausgeblendet werden (mit Grund), Alter der Verbindung, Anzahl der Reconnects und den letzten Fehler pro Umgebung. Das ist der schnellste Weg zu prüfen, ob eine Einstellung wirklich angekommen ist — und die Info, die wir im Support als erstes brauchen.

Aktualisieren

Privat verteilte Extensions aktualisieren sich nicht automatisch. Wenn eine neue Version von cococo.mcpb bereitgestellt wird, installiere die neue Datei auf demselben Weg — sie ersetzt die vorherige. Auf deinem Rechner ändert sich nichts, solange du kein Update installierst.

Fehlerbehebung

CoCoCo erscheint nicht: Stelle sicher, dass du nach der Installation eine neue Unterhaltung geöffnet hast und der Extension-Schalter unter Settings → Extensions aktiv ist.
Eine Umgebung fehlt komplett: Prüfe den Schalter Enabled für diese Instanz und ob nach der Änderung Save gedrückt wurde.
Ein einzelnes Tool fehlt: Meist ist Read-only aktiv (schreibende Tools werden ausgeblendet) oder ein Tool filter greift. cococo_diagnostics nennt den Grund pro Tool.
Änderungen wirken nicht: Save drücken, dann eine neue Unterhaltung öffnen. Greift es weiterhin nicht, Claude Desktop vollständig beenden (⌘Q) und neu starten.
Nach Neustart von Claude Desktop: In einer neuen Unterhaltung weitermachen. Eine vor dem Neustart geöffnete Unterhaltung erreicht die Tools womöglich nicht mehr, auch wenn neue Unterhaltungen normal funktionieren.
Authentifizierungsfehler: API-Token erneut prüfen (keine zusätzlichen Leerzeichen); sicherstellen, dass es nicht auf der Seite MCP / API Tokens widerrufen wurde.
Verbindungsfehler: Prüfe, ob die Endpoint URL korrekt und von deinem Rechner erreichbar ist. Interne .local-Adressen sind nur im lokalen Netz erreichbar; von außen die in CoCoCo angezeigte öffentliche URL verwenden.
Logs: Die Extension schreibt nach ~/cococo-bridge.log. Eine Zeile, die mit cococo-bridge … started; environments=[…] beginnt, bestätigt die erkannten Umgebungen.

Option B — Manuelles Proxy-Setup (fortgeschritten / Fallback)

Nur nutzen, wenn du die Verbindung bewusst selbst betreiben willst statt über die Extension. Erfordert Node.js und das Bearbeiten einer Konfigurationsdatei.

Bevor du startest

Claude Desktop installiert
Node.js Version 18 oder höher
Ein aktives API Token und deine Endpoint URL (von der MCP-Connection-Seite)

Wie es funktioniert

Claude Desktop spricht mit lokalen MCP-Servern über stdio — es startet einen lokalen Prozess und tauscht JSON-Nachrichten mit ihm aus. Da der CoCoCo-MCP-Server ein entfernter HTTPS-Endpoint ist, überbrückt ein kleines lokales Script die beiden: Es liest stdio-Nachrichten von Claude Desktop, leitet sie an den CoCoCo-Endpoint weiter und gibt die Antworten zurück.

Schritt 1 — Proxy-Script anlegen

Lege einen Ordner an, z. B. ~/mcp-proxies/, und darin eine Datei cococo-proxy.mjs mit dem gehärteten Bridge-Script (wird separat bereitgestellt). Diese Version parst gestreamte Antworten inkrementell, erzwingt ein absolutes Zeitlimit pro Anfrage, behandelt jede Anfrage unabhängig und fährt sauber herunter — und vermeidet so die Hänger, die einfachere Proxy-Scripts treffen können.

Das Script liest seine Einstellungen aus Umgebungsvariablen (in der Konfiguration unten gesetzt), du musst dein Token also nicht ins Script selbst schreiben:

COCOCO_ENDPOINT — deine Endpoint URL (z. B. https://<your-domain>/mcp)
COCOCO_TOKEN — dein API-Token

Schritt 2 — Node.js-Pfad finden

Führe which node aus. Notiere die Ausgabe (z. B. /usr/local/bin/node oder einen nvm-Pfad wie /Users/yourname/.nvm/versions/node/v18.20.8/bin/node).

Schritt 3 — Claude Desktop konfigurieren

Öffne (oder erstelle) die Konfigurationsdatei:

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

Füge einen cococo-Server-Block (innerhalb von mcpServers) hinzu, mit deinem Node-Pfad, dem Pfad zum Script und deinen Daten:

{
  "mcpServers": {
    "cococo": {
      "command": "/usr/local/bin/node",
      "args": ["/Users/yourname/mcp-proxies/cococo-proxy.mjs"],
      "env": {
        "COCOCO_ENDPOINT": "https://<your-domain>/mcp",
        "COCOCO_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

Schritt 4 — Claude Desktop neu starten

Datei speichern, dann Claude Desktop vollständig beenden (⌘Q) und neu öffnen — das Fenster zu schließen reicht nicht.

Hinweis: Wenn du Claude Desktop neu startest, während eine Unterhaltung offen ist, danach in einer neuen Unterhaltung weitermachen. Eine vor dem Neustart begonnene Unterhaltung erreicht die Tools womöglich nicht mehr.

Schritt 5 — Prüfen

Neue Unterhaltung öffnen, Tools-Symbol anklicken und bestätigen, dass CoCoCo erscheint — oder „What CoCoCo tools do you have access to?” fragen.

Fehlerbehebung

CoCoCo erscheint nicht: Prüfe, ob das JSON gültig ist (ein fehlendes Komma oder eine fehlende Klammer verhindert das Laden der Datei); prüfe, ob die Dateipfade existieren; stelle sicher, dass du vollständig beendet und neu gestartet hast.
Authentifizierungsfehler: COCOCO_TOKEN prüfen; sicherstellen, dass das Token noch aktiv ist.
Node.js nicht gefunden: which node erneut ausführen und den Command-Pfad aktualisieren; bei nvm die richtige Version aktivieren.
Verbindungsfehler: Prüfen, ob die Endpoint URL erreichbar ist.

Was du nach der Verbindung tun kannst

„List all my Custom Apps and tell me what each one does”
„Build me a Custom App that shows a live overview of all active jobs”
„What GraphQL query do I use to fetch jobs with status PRESS?”
„Create a new KIOSK app for shopfloor job reporting”

Der schnellste Anwendungsfall ist die Custom-App-Entwicklung — beschreibe, was du willst, und Claude baut es direkt auf deiner Plattform.