Integração com o Codex
Um chat ao vivo no seu site com o Codex
O Codex escreve o código no seu projeto, pelo terminal, pelo seu editor ou pelo app de desktop. Passe o prompt do Hooky: ele coloca o balão de chat no seu template. Depois adicione o servidor MCP do Hooky, e o Codex lê suas conversas e estatísticas, ou cria um site para você.
Duas formas de conectar o Hooky ao Codex
Para ter um chat no seu site, um prompt basta: o Codex adiciona uma linha ao seu template, você publica e responde pelo celular. O servidor MCP é um extra: dá ao Codex acesso à sua conta Hooky (sites, conversas, canais, estatísticas, agente de IA). Você pode fazer uma coisa sem a outra.
Seu site saiu de uma conversa no chatgpt.com, sem repositório? O guia ChatGPT é para você.
Instalar o balão com um prompt
Crie sua conta Hooky (grátis para um site), cadastre seu site e copie o prompt dele em Sites: a chave já está dentro.
Abra o Codex no seu projeto:
codexna raiz do repositório, a extensão no seu editor, ou o app de desktop nessa pasta.Cole o prompt. O Codex encontra o template comum e adiciona a tag. Revise a mudança: só uma linha deve aparecer (duas com o import no Next.js).
Publique como sempre: commit, push ou o comando da sua hospedagem. Se você passar a tarefa ao Codex no seu repositório do GitHub, revise a mudança proposta e faça o merge.
O prompt para o Codex
Adicione o balão de chat do Hooky a este site, em todas as páginas. Encontre o template HTML comum a todas as páginas (index.html em React ou Vite, app/layout.tsx no Next.js com o componente Script de next/script e strategy="afterInteractive", o layout base em Astro, Nuxt, SvelteKit, Rails ou Django) e cole lá esta tag uma única vez, logo antes de </body>:
<script src="https://heyhooky.com/widget.js" data-site-key="SUA_CHAVE_PUBLICA" async></script>
Não altere o endereço do script nem o atributo data-site-key. Não adicione nenhum outro código: o balão aparece sozinho. Se o site tiver vários templates independentes, adicione a tag em cada um e me diga em quais.
Comece o prompt com «Leia primeiro https://heyhooky.com/llms.txt»: o Codex também vai saber contar seus cadastros ou pedidos com Hooky.track.
Adicionar o servidor MCP do Hooky
O servidor MCP do Hooky fica em https://api.heyhooky.com/mcp (transporte HTTP). O CLI do Codex, a extensão para o seu editor e o app de desktop do ChatGPT leem a mesma configuração: você escreve uma vez.
Adicione o servidor em
~/.codex/config.toml(crie o arquivo se ele não existir):[mcp_servers.hooky] url = "https://api.heyhooky.com/mcp"Entre na sua conta num terminal:
codex mcp login hookyUma página do Hooky abre no navegador: entre (ou crie sua conta), escolha a conta e autorize o acesso. No app de desktop ou na extensão, o botão Authenticate faz o mesmo.
Confira:
codex mcp listno terminal, ou/mcpno Codex, mostra o hooky.
Prefere uma chave de API? Crie em Desenvolvedores, coloque numa variável de ambiente (export HOOKY_API_KEY=hka_…) e diga ao Codex para enviá-la no cabeçalho Authorization: Bearer:
[mcp_servers.hooky]
url = "https://api.heyhooky.com/mcp"
bearer_token_env_var = "HOOKY_API_KEY"
Assim a chave fica fora do arquivo de configuração. Tudo está detalhado na documentação do servidor MCP.
O que você pode pedir ao Codex
- «Adicione o chat do Hooky a este projeto»: ele cria o site na sua conta (ou encontra o que já existe), pega a tag e coloca no seu template.
- «Resuma minhas conversas de ontem»: quem escreveu, sobre o quê, e o que espera resposta.
- «Ligue o agente de IA do meu site»: nos planos pagos, ele ativa o agente, indica a página que ele deve ler e pode adicionar suas instruções.
- «Adicione meu domínio de teste aos endereços autorizados»: as configurações do site (endereços, cor, lado, estilo) sem abrir o painel.
- «Procure as notificações de pedidos de ontem»: ele lê os canais dos seus sites, onde chegam seus alertas.
- «Prepare uma resposta para o último visitante»: ele escreve, mostra para você e só envia com o seu ok.
Manter o controle
Uma resposta enviada pelo Codex chega de verdade ao seu visitante, assinada com o seu nome: o Codex deve mostrá-la antes. A conexão cria uma chave com o nome da ferramenta em Desenvolvedores; apague-a para cortar o acesso. Você continua respondendo pelo app Hooky (iPhone, iPad, Mac, Android) ou pelo painel web.
Perguntas frequentes
Preciso do servidor MCP para ter o chat no meu site?
Não. O prompt basta: o balão só precisa da tag. O servidor MCP serve para gerenciar sua conta Hooky pelo Codex.
Ainda não tenho conta Hooky
Rode codex mcp login hooky: a página de login oferece criar sua conta. Sem MCP, o Codex também pode criá-la pela API de cadastro: diga «Leia https://heyhooky.com/llms.txt, depois crie uma conta Hooky com o meu e-mail e instale o balão» (veja a documentação).
Minha máquina não tem navegador
Rode codex mcp login hooky --no-browser, feito para esse caso, ou use a chave de API com bearer_token_env_var.
E no ChatGPT na web?
O ChatGPT na web não lê a configuração local do Codex. Para um site feito numa conversa, siga o guia ChatGPT.
Como corto o acesso do Codex?
Apague a chave dele em Desenvolvedores, no Hooky, e remova a seção [mcp_servers.hooky] do seu config.toml.
Outras ferramentas
Seus visitantes têm perguntas. Responda de onde você estiver.
Grátis para um site, instalado com um prompt. Depois, é só deixar o celular no bolso.