Integración con Claude Code
Un chat en vivo en tu web con Claude Code
Claude Code trabaja en los archivos de tu proyecto. Dale el prompt de Hooky: encuentra la plantilla común y pone la burbuja de chat. Conecta después el servidor MCP de Hooky y pídele tus conversaciones, tus estadísticas o una web nueva sin salir del terminal.
Dos formas de conectar Hooky a Claude Code
La primera basta para tener un chat en tu web: un prompt, y Claude Code añade una línea a tu plantilla. La segunda va más allá: con el servidor MCP, Claude Code habla directamente con tu cuenta de Hooky. Crea una web, obtiene su etiqueta, lee tus conversaciones, activa el agente IA… Puedes hacer una sin la otra.
¿Usas Claude en claude.ai en vez del terminal? La guía Claude explica el prompt en una conversación y el conector de Hooky.
Instalar la burbuja con un prompt
Crea tu cuenta de Hooky (gratis para un sitio), añade tu web y copia su prompt en Sitios: la clave ya está dentro.
Abre Claude Code en la raíz de tu proyecto (
claudeen el terminal, o desde tu editor).Pega el prompt. Claude Code busca la plantilla común a todas las páginas y añade la etiqueta. Revisa el cambio que te propone: solo debe aparecer una línea (dos con el import en Next.js).
Despliega como siempre: commit, push o el comando de tu hosting. Abre tu web publicada: la burbuja está abajo de la pantalla.
El prompt para Claude Code
Añade la burbuja de chat de Hooky a esta web, en todas las páginas. Encuentra la plantilla HTML común a todas las páginas (index.html en React o Vite, app/layout.tsx en Next.js con el componente Script de next/script y strategy="afterInteractive", el layout base en Astro, Nuxt, SvelteKit, Rails o Django) y pega ahí esta etiqueta una sola vez, justo antes de </body>:
<script src="https://heyhooky.com/widget.js" data-site-key="TU_CLAVE_PUBLICA" async></script>
No cambies la dirección del script ni el atributo data-site-key. No añadas ningún otro código: la burbuja aparece sola. Si la web tiene varias plantillas independientes, añade la etiqueta en cada una y dime en cuáles.
Para probar en tu servidor de desarrollo, añade localhost a las direcciones autorizadas del sitio en Hooky (vale para todos los puertos).
Conectar el servidor MCP de Hooky
El servidor MCP de Hooky está en https://api.heyhooky.com/mcp (transporte HTTP). Lo añades una vez y luego inicias sesión con tu cuenta de Hooky: sin clave que copiar.
Añade el servidor en un terminal:
claude mcp add --transport http hooky https://api.heyhooky.com/mcpPor defecto, el servidor solo vale para el proyecto actual. Para tenerlo en todos tus proyectos, añade
--scope user.Inicia sesión: en Claude Code, escribe
/mcp, elige hooky y sigue los pasos. Se abre una página de Hooky en tu navegador: inicia sesión (o crea tu cuenta), elige la cuenta y autoriza el acceso.Comprueba:
claude mcp listen el terminal, o/mcpen Claude Code, muestra hooky conectado. Claude Code ve entonces las herramientas de Hooky (sitios, conversaciones, canales, estadísticas, agente IA).
¿Prefieres una clave API? Créala en Desarrolladores y pásala en una cabecera (la página Desarrolladores te da el comando con tu clave):
claude mcp add --transport http hooky https://api.heyhooky.com/mcp --header "Authorization: Bearer hka_tu_clave_api"
Con --scope project, la configuración va al archivo .mcp.json del proyecto, compartido con tu equipo: no pongas ahí ninguna clave, deja que cada uno inicie sesión con /mcp. Todo está detallado en la documentación del servidor MCP.
Lo que puedes pedirle a Claude Code
- «Añade el chat de Hooky a este proyecto»: crea el sitio en tu cuenta (o encuentra el que ya existe), obtiene su etiqueta y la pone en tu plantilla.
- «Resume mis conversaciones de ayer»: lee tus conversaciones y te dice quién escribió, para qué y qué espera respuesta.
- «Activa el agente IA de mi web»: en los planes de pago, lo activa, le indica la página que debe leer y puede añadir tus instrucciones (horarios, envíos, devoluciones…).
- «Pon la burbuja en azul y abajo a la izquierda»: color, lado, estilo y mensaje de bienvenida se ajustan sin abrir el panel.
- «¿Cuántos registros esta semana?»: lee tus estadísticas de Hooky, incluidos los eventos contados con
Hooky.track(documentación). - «Prepara una respuesta a la última visitante»: la redacta, te la enseña y solo la envía con tu visto bueno.
Mantener el control
Una respuesta enviada por Claude Code llega de verdad a tu visitante, firmada con tu nombre: Claude Code debe enseñártela antes. El inicio de sesión crea una clave con el nombre de la herramienta en Desarrolladores; bórrala para cortarle el acceso. Y tú sigues respondiendo desde la app de Hooky (iPhone, iPad, Mac, Android) o el panel web.
Preguntas frecuentes
¿Hace falta el servidor MCP para tener el chat en mi web?
No. Basta con el prompt: la burbuja solo necesita su etiqueta. El servidor MCP sirve para gestionar tu cuenta de Hooky desde Claude Code.
Todavía no tengo cuenta de Hooky
Ejecuta /mcp: la página de inicio de sesión te propone crear tu cuenta y luego autorizas a Claude Code. Sin MCP, Claude Code también puede crear tu cuenta con la API de registro: dile «Lee https://heyhooky.com/llms.txt, luego créame una cuenta de Hooky con mi email e instala la burbuja» (ver la documentación).
/mcp no muestra hooky
Quizá añadiste el servidor en otro proyecto: la opción por defecto solo vale para la carpeta donde lo añadiste. Ejecuta claude mcp list en tu proyecto, o añádelo con --scope user.
¿Y en claude.ai o en la app de Claude?
Hooky se añade allí como conector, con la misma dirección. Ver la guía Claude y la documentación.
¿Cómo le corto el acceso a Claude Code?
Borra su clave en Desarrolladores, en Hooky. En Claude Code, claude mcp remove hooky quita el servidor.
Otras herramientas
Tus visitantes tienen preguntas. Respóndeles desde donde estés.
Gratis para un sitio, instalado con un prompt. Después, solo tienes que llevar el móvil en el bolsillo.