Claude Code mit deinem Studio verbinden

Was ist das

Claude Code ist Claude von Anthropic und läuft im Terminal deines Computers. Mit dem KI-Konnektor kann Claude Code Daten aus deinem Studio abrufen (Umsätze, Kunden, Termine und Finanzen), wenn du danach fragst. Dabei gelten die Berechtigungen des Benutzers, dem der Schlüssel gehört. Das System kann nur abgefragt werden – Änderungen sind nicht möglich.

Wann verwenden

Du verwendest Claude Code bereits auf deinem Computer und möchtest dich nach dem Betrieb in deinem Studio erkundigen, ohne Claude Code zu verlassen.
Du möchtest eine Zusammenfassung oder Tabelle mit Zahlen aus dem System erstellen und kannst deine Anfrage in normaler Sprache formulieren.

Bevor Sie beginnen

Halte die Adresse des Konnektors bereit. So kopierst du sie: KI-Konnektor verbinden. Claude Code muss auf deinem Computer installiert sein. Die Anmeldung erfolgt über den System-Login. Ein API-Schlüssel ist optional, wenn du den Login nicht verwenden möchtest (zum Beispiel auf einem Computer ohne Browser).

Schritt für Schritt

Schritt 1 — Konnektor hinzufügen

Führe im Terminal den folgenden Befehl aus und ersetze die Adresse durch die, die du unter Adresse kopieren kopiert hast:

claude mcp add --transport http heya https://seu-dominio/mcp

Gib in Claude Code /mcp ein, wähle heya und die Authentifizierungsoption aus. Daraufhin wird die System-Anmeldeseite im Browser geöffnet. Melde dich an, wähle das Unternehmen und klicke auf Autorisieren.

Wenn du lieber einen API-Schlüssel verwenden möchtest (erstellt mit Verwendung als KI-Konnektor erlauben), füge dem Befehl den Header hinzu: --header "Authorization: Bearer hk_...".

Damit der Konnektor in allen Ordnern auf deinem Computer und nicht nur im aktuellen Ordner verfügbar ist, ergänze den Befehl um --scope user.

Schritt 2 — Verbindung prüfen

Führe claude mcp list aus. Der Konnektor heya sollte als verbunden angezeigt werden. In Claude Code kannst du dasselbe mit dem Befehl /mcp prüfen.

Schritt 3 — Fragen stellen

Öffne Claude Code und frage zum Beispiel: „Wie viel habe ich gestern im Studio eingenommen?“ Beim ersten Mal bittet Claude dich möglicherweise um Erlaubnis, die Tools des Konnektors zu verwenden.

Was danach passiert

Claude wählt die passende Abfrage für deine Frage aus, führt sie aus und antwortet mit den Zahlen aus dem System.
Unter API Key wird der Zuletzt verwendet aktualisiert.
Um den Zugriff zu beenden, widerrufe den Schlüssel unter API Key. Claude Code verliert innerhalb von 30 Sekunden den Zugriff.

Häufige Fehler und Fragen

F: Bei claude mcp list erscheint „Failed to connect“. Was kann ich tun? A: Prüfe, ob die Adresse mit /mcp endet und der Schlüssel vollständig eingefügt wurde – einschließlich Bearer und eines Leerzeichens danach. Der Befehl speichert die Konfiguration, ohne den Schlüssel zu testen. Ein Fehler wird erst angezeigt, wenn Claude versucht, eine Verbindung herzustellen.

F: Claude sagt, für den Schlüssel muss „Verwendung als KI-Konnektor erlauben“ aktiviert sein. Warum? A: Der Schlüssel wurde ohne diese Option erstellt. Bearbeite den Schlüssel unter API Key und aktiviere Verwendung als KI-Konnektor erlauben.

F: Wie kann ich den Schlüssel ändern? A: Entferne den Konnektor mit claude mcp remove heya und füge ihn mit dem neuen Schlüssel wieder hinzu.

F: Kann ich die Konfiguration über das Repository mit meinem Team teilen? A: Speichere den Schlüssel nicht in einer gemeinsamen Datei (--scope project speichert die Konfiguration in .mcp.json). Jeder sollte den eigenen Schlüssel mit den Berechtigungen des eigenen Benutzerkontos verwenden.

F: Claude sagt, dass eine Information nicht gefunden wurde, obwohl ich sie im System sehe. Warum? A: Das Benutzerkonto des Schlüssels hat keinen Zugriff auf diese Ansicht, oder sie ist aus Sicherheitsgründen vom Konnektor ausgeschlossen (WhatsApp-Unterhaltungen, Anamnese, Fotos und digitales Konto). Weitere Informationen findest du im Artikel KI-Konnektor.