Intégration Claude Code
Un chat en direct sur ton site avec Claude Code
Claude Code travaille dans les fichiers de ton projet. Donne-lui le prompt Hooky : il trouve le gabarit commun et y pose la bulle de chat. Branche ensuite le serveur MCP de Hooky, et tu lui demandes tes conversations, tes stats ou un nouveau site sans quitter le terminal.
Deux façons de brancher Hooky à Claude Code
La première suffit pour avoir un chat sur ton site : un prompt, et Claude Code ajoute une ligne à ton gabarit. La seconde va plus loin : avec le serveur MCP, Claude Code parle directement à ton compte Hooky. Il crée un site, récupère sa balise, lit tes conversations, allume l’agent IA… Tu peux faire l’une sans l’autre.
Tu utilises Claude sur claude.ai plutôt que dans le terminal ? Le guide Claude explique le prompt dans une conversation et le connecteur Hooky.
Installer la bulle avec un prompt
Crée ton compte Hooky (gratuit pour un site), déclare ton site et copie son prompt dans Sites : la clé y est déjà.
Lance Claude Code à la racine de ton projet (
claudedans le terminal, ou depuis ton éditeur).Colle le prompt. Claude Code cherche le gabarit commun à toutes les pages et y ajoute la balise. Relis le changement qu’il te propose : une seule ligne doit apparaître (deux avec l’import pour Next.js).
Déploie comme d’habitude : commit, push, ou la commande de ton hébergeur. Ouvre ton site en ligne : la bulle est en bas de l’écran.
Le prompt pour Claude Code
Ajoute la bulle de chat Hooky à ce site, sur toutes les pages. Trouve le gabarit HTML commun à toutes les pages (index.html pour React ou Vite, app/layout.tsx pour Next.js avec le composant Script de next/script et strategy="afterInteractive", le layout de base pour Astro, Nuxt, SvelteKit, Rails ou Django) et colles-y cette balise une seule fois, juste avant </body> :
<script src="https://heyhooky.com/widget.js" data-site-key="TA_CLE_PUBLIQUE" async></script>
Ne modifie ni l’adresse du script ni l’attribut data-site-key. N’ajoute aucun autre code : la bulle s’affiche seule. Si le site a plusieurs gabarits indépendants, ajoute la balise dans chacun et dis-moi lesquels.
Pour tester sur ton serveur de développement, ajoute localhost aux adresses autorisées du site dans Hooky (tous les ports sont couverts).
Brancher le serveur MCP de Hooky
Le serveur MCP de Hooky est à l’adresse https://api.heyhooky.com/mcp (transport HTTP). Tu l’ajoutes une fois, puis tu te connectes avec ton compte Hooky : pas de clé à copier.
Ajoute le serveur dans un terminal :
claude mcp add --transport http hooky https://api.heyhooky.com/mcpPar défaut, le serveur ne sert que dans le projet courant. Pour l’avoir dans tous tes projets, ajoute
--scope user.Connecte-toi : dans Claude Code, tape
/mcp, choisis hooky et suis les étapes. Une page Hooky s’ouvre dans ton navigateur : connecte-toi (ou crée ton compte), choisis le compte et autorise l’accès.Vérifie :
claude mcp listdans le terminal, ou/mcpdans Claude Code, montre hooky connecté. Claude Code voit alors les outils de Hooky (sites, conversations, canaux, stats, agent IA).
Tu préfères une clé API ? Crée-la dans Développeurs et passe-la en en-tête (la page Développeurs te donne la commande avec ta clé) :
claude mcp add --transport http hooky https://api.heyhooky.com/mcp --header "Authorization: Bearer hka_ta_cle_api"
Avec --scope project, la configuration va dans le fichier .mcp.json du projet, partagé avec ton équipe : n’y mets pas de clé, laisse chacun se connecter avec /mcp. Tout est détaillé dans la doc du serveur MCP.
Ce que tu peux demander à Claude Code
- « Ajoute le chat Hooky à ce projet » : il crée le site dans ton compte (ou retrouve celui qui existe), récupère sa balise et la pose dans ton gabarit.
- « Résume mes conversations d’hier » : il lit tes conversations et te dit qui a écrit, pour quoi, et ce qui attend une réponse.
- « Allume l’agent IA de mon site » : sur les offres payantes, il l’active, lui indique la page à lire et peut lui ajouter tes consignes (horaires, livraison, retours…).
- « Passe la bulle en bleu et en bas à gauche » : couleur, côté, style et message d’accueil se règlent sans ouvrir le tableau de bord.
- « Combien d’inscriptions cette semaine ? » : il lit tes stats Hooky, dont les événements comptés avec
Hooky.track(doc). - « Prépare une réponse à la dernière visiteuse » : il rédige, te la montre, et ne l’envoie qu’avec ton accord.
Garder la main
Une réponse envoyée par Claude Code part vraiment chez ton visiteur, signée de ton nom : Claude Code doit te la montrer avant. La connexion crée une clé au nom de l’outil dans Développeurs ; retire-la pour lui couper l’accès. Et tu continues de répondre toi-même depuis l’app Hooky (iPhone, iPad, Mac, Android) ou l’espace web.
Questions fréquentes
Faut-il le serveur MCP pour avoir le chat sur mon site ?
Non. Le prompt suffit : la bulle n’a besoin que de sa balise. Le serveur MCP sert à gérer ton compte Hooky depuis Claude Code.
Je n’ai pas encore de compte Hooky
Lance /mcp : la page de connexion te propose de créer ton compte, puis tu autorises Claude Code. Sans MCP, Claude Code peut aussi créer ton compte par l’API d’inscription : dis-lui « Lis https://heyhooky.com/llms.txt, puis crée-moi un compte Hooky avec mon e-mail et installe la bulle » (voir la doc).
/mcp n’affiche pas hooky
Le serveur a peut-être été ajouté dans un autre projet : le choix par défaut ne vaut que pour le dossier où tu l’as ajouté. Relance claude mcp list dans ton projet, ou ajoute-le avec --scope user.
Et sur claude.ai ou dans l’app Claude ?
Comment couper l’accès de Claude Code ?
Retire sa clé dans Développeurs, côté Hooky. Côté Claude Code, claude mcp remove hooky enlève le serveur.
Les autres outils
Tes visiteurs ont des questions. Réponds-leur d’où tu es.
Gratuit pour un site, installé en un prompt. Ensuite, garde ton téléphone dans la poche.