ES
Iniciar sesión Empieza gratis

Integración con Codex

Un chat en vivo en tu web con Codex

Codex escribe el código en tu proyecto, desde el terminal, tu editor o la app de escritorio. Dale el prompt de Hooky: pone la burbuja de chat en tu plantilla. Añade después el servidor MCP de Hooky, y Codex lee tus conversaciones y estadísticas, o crea un sitio por ti.

Dos formas de conectar Hooky a Codex

Para tener un chat en tu web basta con un prompt: Codex añade una línea a tu plantilla, despliegas y respondes desde el móvil. El servidor MCP es un extra: da a Codex acceso a tu cuenta de Hooky (sitios, conversaciones, canales, estadísticas, agente IA). Puedes hacer una cosa sin la otra.

¿Tu web salió de una conversación en chatgpt.com, sin repositorio? La guía ChatGPT es para ti.

Instalar la burbuja con un prompt

  1. Crea tu cuenta de Hooky (gratis para un sitio), añade tu web y copia su prompt en Sitios: la clave ya está dentro.

  2. Abre Codex en tu proyecto: codex en la raíz del repositorio, la extensión en tu editor o la app de escritorio en esa carpeta.

  3. Pega el prompt. Codex encuentra la plantilla común y añade la etiqueta. Revisa el cambio: solo debe aparecer una línea (dos con el import en Next.js).

  4. Despliega como siempre: commit, push o el comando de tu hosting. Si encargas la tarea a Codex en tu repositorio de GitHub, revisa el cambio propuesto y fusiónalo.

El prompt para Codex

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.

Empieza el prompt con «Lee primero https://heyhooky.com/llms.txt»: Codex sabrá además contar tus registros o pedidos con Hooky.track.

Añadir el servidor MCP de Hooky

El servidor MCP de Hooky está en https://api.heyhooky.com/mcp (transporte HTTP). El CLI de Codex, la extensión para tu editor y la app de escritorio de ChatGPT leen la misma configuración: la escribes una vez.

  1. Añade el servidor en ~/.codex/config.toml (crea el archivo si no existe):

    [mcp_servers.hooky]
    url = "https://api.heyhooky.com/mcp"
  2. Inicia sesión en un terminal:

    codex mcp login hooky

    Se abre una página de Hooky en tu navegador: inicia sesión (o crea tu cuenta), elige la cuenta y autoriza el acceso. En la app de escritorio o la extensión, el botón Authenticate hace lo mismo.

  3. Comprueba: codex mcp list en el terminal, o /mcp en Codex, muestra hooky.

¿Prefieres una clave API? Créala en Desarrolladores, ponla en una variable de entorno (export HOOKY_API_KEY=hka_…) e indica a Codex que la envíe en la cabecera Authorization: Bearer:

[mcp_servers.hooky]
url = "https://api.heyhooky.com/mcp"
bearer_token_env_var = "HOOKY_API_KEY"

Así la clave queda fuera del archivo de configuración. Todo está detallado en la documentación del servidor MCP.

Lo que puedes pedirle a Codex

  • «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»: 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.
  • «Añade mi dominio de pruebas a las direcciones autorizadas»: los ajustes del sitio (direcciones, color, lado, estilo) sin abrir el panel.
  • «Busca las notificaciones de pedidos de ayer»: lee los canales de tus sitios, donde llegan tus alertas.
  • «Prepara una respuesta al último visitante»: la redacta, te la enseña y solo la envía con tu visto bueno.

Mantener el control

Una respuesta enviada por Codex llega de verdad a tu visitante, firmada con tu nombre: Codex 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. 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 Codex.

Todavía no tengo cuenta de Hooky

Ejecuta codex mcp login hooky: la página de inicio de sesión te propone crear tu cuenta. Sin MCP, Codex también puede crearla 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).

Mi máquina no tiene navegador

Ejecuta codex mcp login hooky --no-browser, pensado para este caso, o usa la clave API con bearer_token_env_var.

¿Y en ChatGPT en la web?

ChatGPT en la web no lee la configuración local de Codex. Para una web hecha en una conversación, sigue la guía ChatGPT.

¿Cómo le corto el acceso a Codex?

Borra su clave en Desarrolladores, en Hooky, y quita la sección [mcp_servers.hooky] de tu config.toml.

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.