Claude-Code-Integration
Live-Chat auf deiner Website mit Claude Code
Claude Code arbeitet in den Dateien deines Projekts. Gib ihm den Hooky-Prompt: Er findet das gemeinsame Template und setzt die Chat-Bubble ein. Verbinde dann den MCP-Server von Hooky und frag nach deinen Unterhaltungen, deinen Statistiken oder einer neuen Website, ohne das Terminal zu verlassen.
Zwei Wege, Hooky mit Claude Code zu verbinden
Der erste reicht für einen Chat auf deiner Website: ein Prompt, und Claude Code fügt deinem Template eine Zeile hinzu. Der zweite geht weiter: Mit dem MCP-Server spricht Claude Code direkt mit deinem Hooky-Konto. Er legt eine Website an, holt ihr Tag, liest deine Unterhaltungen, schaltet den KI-Agenten ein … Du kannst das eine ohne das andere nutzen.
Du nutzt Claude auf claude.ai statt im Terminal? Die Anleitung Claude erklärt den Prompt in einem Gespräch und den Hooky-Connector.
Die Bubble mit einem Prompt installieren
Erstelle dein Hooky-Konto (kostenlos für eine Website), trag deine Website ein und kopiere ihren Prompt unter Websites: Der Schlüssel steckt schon drin.
Starte Claude Code im Hauptordner deines Projekts (
claudeim Terminal oder aus deinem Editor).Füge den Prompt ein. Claude Code sucht das Template, das alle Seiten teilen, und setzt das Tag. Prüf die vorgeschlagene Änderung: Es sollte nur eine Zeile erscheinen (zwei mit dem Import bei Next.js).
Deploye wie immer: Commit, Push oder der Befehl deines Hosters. Öffne deine Live-Website: Die Bubble ist unten auf dem Bildschirm.
Der Prompt für Claude Code
Füge die Hooky-Chat-Bubble zu dieser Website hinzu, auf allen Seiten. Finde das HTML-Template, das alle Seiten teilen (index.html bei React oder Vite, app/layout.tsx bei Next.js mit der Script-Komponente aus next/script und strategy="afterInteractive", das Basis-Layout bei Astro, Nuxt, SvelteKit, Rails oder Django), und setze dieses Tag dort ein einziges Mal direkt vor </body> ein:
<script src="https://heyhooky.com/widget.js" data-site-key="DEIN_OEFFENTLICHER_SCHLUESSEL" async></script>
Ändere weder die Script-Adresse noch das Attribut data-site-key. Füge keinen weiteren Code hinzu: Die Bubble erscheint von selbst. Wenn die Website mehrere unabhängige Templates hat, setze das Tag in jedes und sag mir, in welche.
Zum Testen auf deinem Entwicklungsserver trag localhost bei den erlaubten Adressen der Website in Hooky ein (gilt für alle Ports).
Den MCP-Server von Hooky verbinden
Der MCP-Server von Hooky liegt unter https://api.heyhooky.com/mcp (HTTP-Transport). Du fügst ihn einmal hinzu und meldest dich dann mit deinem Hooky-Konto an: kein Schlüssel zum Kopieren.
Füge den Server hinzu, in einem Terminal:
claude mcp add --transport http hooky https://api.heyhooky.com/mcpStandardmäßig gilt der Server nur für das aktuelle Projekt. Für alle deine Projekte ergänze
--scope user.Melde dich an: Tipp in Claude Code
/mcp, wähle hooky und folge den Schritten. Eine Hooky-Seite öffnet sich im Browser: Melde dich an (oder erstelle dein Konto), wähle das Konto und erlaube den Zugriff.Prüfe:
claude mcp listim Terminal oder/mcpin Claude Code zeigt hooky als verbunden. Claude Code sieht dann die Tools von Hooky (Websites, Unterhaltungen, Kanäle, Statistiken, KI-Agent).
Lieber ein API-Schlüssel? Erstelle ihn unter Entwickler und gib ihn als Header mit (die Seite Entwickler zeigt dir den Befehl mit deinem Schlüssel):
claude mcp add --transport http hooky https://api.heyhooky.com/mcp --header "Authorization: Bearer hka_dein_api_schluessel"
Mit --scope project landet die Konfiguration in der Datei .mcp.json des Projekts, die du mit deinem Team teilst: Leg dort keinen Schlüssel ab, lass alle sich mit /mcp anmelden. Alle Details stehen in der Doku zum MCP-Server.
Was du Claude Code fragen kannst
- „Füg den Hooky-Chat zu diesem Projekt hinzu“: Er legt die Website in deinem Konto an (oder findet die vorhandene), holt ihr Tag und setzt es in dein Template.
- „Fass die Unterhaltungen von gestern zusammen“: Er liest deine Unterhaltungen und sagt dir, wer geschrieben hat, worum es ging und was auf eine Antwort wartet.
- „Schalte den KI-Agenten meiner Website ein“: In den bezahlten Tarifen schaltet er ihn ein, nennt ihm die Seite, die er lesen soll, und kann deine Hinweise ergänzen (Öffnungszeiten, Versand, Rückgabe …).
- „Mach die Bubble blau und setz sie nach unten links“: Farbe, Seite, Stil und Begrüßung lassen sich ohne Dashboard einstellen.
- „Wie viele Anmeldungen diese Woche?“: Er liest deine Hooky-Statistiken, auch die mit
Hooky.trackgezählten Ereignisse (Doku). - „Entwirf eine Antwort an die letzte Besucherin“: Er schreibt sie, zeigt sie dir und schickt sie erst mit deinem Okay.
Die Kontrolle behalten
Eine Antwort von Claude Code kommt wirklich bei deinem Besucher an, mit deinem Namen: Claude Code sollte sie dir vorher zeigen. Die Anmeldung legt unter Entwickler einen Schlüssel mit dem Namen des Tools an; lösch ihn, um den Zugriff zu entziehen. Und du antwortest weiter selbst in der Hooky-App (iPhone, iPad, Mac, Android) oder im Web-Dashboard.
Häufige Fragen
Brauche ich den MCP-Server für den Chat auf meiner Website?
Nein. Der Prompt reicht: Die Bubble braucht nur ihr Tag. Der MCP-Server dient dazu, dein Hooky-Konto aus Claude Code zu verwalten.
Ich habe noch kein Hooky-Konto
Starte /mcp: Die Anmeldeseite bietet dir an, ein Konto zu erstellen, dann erlaubst du Claude Code den Zugriff. Ohne MCP kann Claude Code dein Konto auch über die Registrierungs-API anlegen: Sag ihm „Lies https://heyhooky.com/llms.txt, erstelle mir dann ein Hooky-Konto mit meiner E-Mail und installiere die Bubble“ (siehe Doku).
/mcp zeigt hooky nicht an
Vielleicht wurde der Server in einem anderen Projekt hinzugefügt: Die Standardeinstellung gilt nur für den Ordner, in dem du ihn hinzugefügt hast. Führ claude mcp list in deinem Projekt aus oder füge ihn mit --scope user hinzu.
Und auf claude.ai oder in der Claude-App?
Wie entziehe ich Claude Code den Zugriff?
Lösch seinen Schlüssel unter Entwickler in Hooky. In Claude Code entfernt claude mcp remove hooky den Server.
Weitere Tools
Deine Besucher haben Fragen. Antworte, wo immer du bist.
Kostenlos für eine Website, mit einem Prompt installiert. Danach reicht das Handy in der Tasche.