CaryvaneHilfe
/
DE

Claude mit Caryvane verbinden

Der MCP-Server von Caryvane ist ein einzelner HTTPS-Endpunkt; Claude braucht seine URL und Ihren Schlüssel. Fünf Minuten, und „Welche Backups sind letzte Nacht fehlgeschlagen?“ ist eine Frage statt eines Berichts.

1. Einen Schlüssel erstellen #

Konsole → Ihr Name → KI-Zugriffsschlüssel → Neuer Schlüssel. Nennen Sie ihn „Claude“, wählen Sie die Stufe – Nur lesen für Fragen, Lesen + steuern, damit Claude Ausführungen starten und abbrechen darf, Lesen + steuern + bearbeiten, damit Claude Jobs erstellen und Laufwerke einbinden darf – und kopieren Sie den Schlüssel; er wird nur einmal angezeigt. Einzelheiten zu den Stufen unter KI-Assistenten und API.

2a. Claude Code #

Im Terminal, in dem Projekt, in dem der Server verfügbar sein soll (oder mit --scope user für überall):

claude mcp add --transport http caryvane https://console.caryvane.com/mcp/rpc \
  --header "Authorization: Bearer <key>"

Oder legen Sie .mcp.json im Projekt an:

{
  "mcpServers": {
    "caryvane": {
      "type": "http",
      "url": "https://console.caryvane.com/mcp/rpc",
      "headers": { "Authorization": "Bearer <key>" }
    }
  }
}

Halten Sie die Datei aus der Versionsverwaltung heraus – sie enthält den Schlüssel. Starten Sie Claude Code neu; /mcp listet den Server und seine Tools auf.

2b. Claude Desktop und claude.ai #

Hier stolpern viele, weil die naheliegende Schaltfläche die falsche ist. Caryvane authentifiziert über einen Schlüssel, den Sie als Header einfügen, nicht über eine Anmeldung – es gibt also nichts, wo Sie sich anmelden müssten, und es öffnet sich kein Fenster. Arbeiten Sie den Bereich ab, den die Konsole beim Erstellen des Schlüssels angezeigt hat; dort gibt es neben jedem der drei Werte eine Kopierschaltfläche.

  1. Einstellungen → Konnektoren → Benutzerdefinierten Konnektor hinzufügen (englische Oberfläche: Settings → Connectors → Add custom connector).
  2. Nennen Sie ihn Caryvane.
  3. Fügen Sie die Server-URL ein: https://console.caryvane.com/mcp/rpc (oder die Adresse Ihrer eigenen Konsole, falls sie abweicht).
  4. Melden Sie sich nicht an und lassen Sie die OAuth-Felder leer. Es gibt keine Client-ID und kein Client-Secret. Wer auf Verbinden klickt und eine Anmeldung erwartet, bekommt einen Fehler.
  5. Fügen Sie einen benutzerdefinierten Header hinzu. Name Authorization. Wert Bearer , gefolgt von Ihrem Schlüssel, genau ein Leerzeichen dazwischen, sonst nichts. Die Konsole bietet den Wert fertig zusammengesetzt an – wenn Sie Header-Wert kopieren, sparen Sie sich das Tippen.
  6. Speichern und aktivieren Sie den Konnektor für die Unterhaltung. Die Caryvane-Tools erscheinen im Tool-Menü.

Der mit Abstand häufigste Fehler: nur den Schlüssel allein als Header-Wert einzufügen. Das Wort Bearer und das Leerzeichen gehören beide dazu.

2c. ChatGPT #

ChatGPT erreicht denselben Endpunkt auf dieselbe Weise, unter Settings → Connectors → Create (in der deutschen Oberfläche entsprechend übersetzt; bei manchen Tarifen nur im Entwicklermodus). Geben Sie den Namen und dieselbe /mcp/rpc-URL ein, wählen Sie bei der Authentifizierung die Option für Zugriffstoken bzw. API-Schlüssel statt OAuth und fügen Sie Ihren Schlüssel ein. ChatGPT sendet ihn als Authorization: Bearer <key>, genau so, wie Caryvane es erwartet. Die Menübezeichnungen ändern sich von Version zu Version; die drei Werte nie.

Caryvane bietet kein OAuth an, ein Client, der darauf besteht, kann sich also nicht verbinden. Ist das bei Ihrem der Fall, verwenden Sie stattdessen die einfache REST-Schnittstelle unter KI-Assistenten und API – dieselben Tools, dieselben Stufen, gewöhnliche HTTP-Aufrufe mit demselben Bearer-Header.

3. Verwenden #

Die Tool-Beschreibungen sagen Claude, was jedes Tool tut und was zuerst zu prüfen ist, deshalb funktionieren einfache Anfragen:

Claude sieht genau das, was Sie sehen. Claude kann keine Dateiinhalte herunterladen und keine Dateien im Speicher löschen oder verschieben; das Durchsuchen liefert nur Namen und Datumsangaben.

Wenn die Verbindung nicht klappt #