Integração com o Claude Code
Um chat ao vivo no seu site com o Claude Code
O Claude Code trabalha nos arquivos do seu projeto. Passe o prompt do Hooky: ele encontra o template comum e coloca o balão de chat. Depois conecte o servidor MCP do Hooky e peça suas conversas, suas estatísticas ou um site novo sem sair do terminal.
Duas formas de conectar o Hooky ao Claude Code
A primeira basta para ter um chat no seu site: um prompt, e o Claude Code adiciona uma linha ao seu template. A segunda vai além: com o servidor MCP, o Claude Code fala direto com a sua conta Hooky. Ele cria um site, pega a tag dele, lê suas conversas, liga o agente de IA… Você pode fazer uma sem a outra.
Usa o Claude no claude.ai em vez do terminal? O guia Claude explica o prompt numa conversa e o conector do Hooky.
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 Claude Code na raiz do projeto (
claudeno terminal, ou pelo seu editor).Cole o prompt. O Claude Code procura o template comum a todas as páginas e adiciona a tag. Revise a mudança proposta: só uma linha deve aparecer (duas com o import no Next.js).
Publique como sempre: commit, push ou o comando da sua hospedagem. Abra o site no ar: o balão está embaixo da tela.
O prompt para o Claude Code
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.
Para testar no seu servidor de desenvolvimento, adicione localhost aos endereços autorizados do site no Hooky (vale para todas as portas).
Conectar o servidor MCP do Hooky
O servidor MCP do Hooky fica em https://api.heyhooky.com/mcp (transporte HTTP). Você o adiciona uma vez e depois entra com a sua conta Hooky: nenhuma chave para copiar.
Adicione o servidor num terminal:
claude mcp add --transport http hooky https://api.heyhooky.com/mcpPor padrão, o servidor só vale para o projeto atual. Para tê-lo em todos os seus projetos, adicione
--scope user.Entre na sua conta: no Claude Code, digite
/mcp, escolha hooky e siga os passos. Uma página do Hooky abre no navegador: entre (ou crie sua conta), escolha a conta e autorize o acesso.Confira:
claude mcp listno terminal, ou/mcpno Claude Code, mostra o hooky conectado. O Claude Code passa a ver as ferramentas do Hooky (sites, conversas, canais, estatísticas, agente de IA).
Prefere uma chave de API? Crie em Desenvolvedores e passe num cabeçalho (a página Desenvolvedores dá o comando com a sua chave):
claude mcp add --transport http hooky https://api.heyhooky.com/mcp --header "Authorization: Bearer hka_sua_chave_api"
Com --scope project, a configuração vai para o arquivo .mcp.json do projeto, compartilhado com a sua equipe: não coloque chave nele, deixe cada um entrar com /mcp. Tudo está detalhado na documentação do servidor MCP.
O que você pode pedir ao Claude Code
- «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»: ele lê suas conversas e diz 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 (horários, entrega, trocas…).
- «Deixe o balão azul e no canto inferior esquerdo»: cor, lado, estilo e mensagem de boas-vindas se ajustam sem abrir o painel.
- «Quantos cadastros nesta semana?»: ele lê suas estatísticas do Hooky, inclusive os eventos contados com
Hooky.track(documentação). - «Prepare uma resposta para a última visitante»: ele escreve, mostra para você e só envia com o seu ok.
Manter o controle
Uma resposta enviada pelo Claude Code chega de verdade ao seu visitante, assinada com o seu nome: o Claude Code deve mostrá-la antes. A conexão cria uma chave com o nome da ferramenta em Desenvolvedores; apague-a para cortar o acesso. E 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 Claude Code.
Ainda não tenho conta Hooky
Rode /mcp: a página de login oferece criar sua conta, e depois você autoriza o Claude Code. Sem MCP, o Claude Code também pode criar sua conta 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).
O /mcp não mostra o hooky
Talvez o servidor tenha sido adicionado em outro projeto: a opção padrão só vale para a pasta onde você o adicionou. Rode claude mcp list no seu projeto, ou adicione com --scope user.
E no claude.ai ou no app do Claude?
Lá o Hooky entra como conector, com o mesmo endereço. Veja o guia Claude e a documentação.
Como corto o acesso do Claude Code?
Apague a chave dele em Desenvolvedores, no Hooky. No Claude Code, claude mcp remove hooky remove o servidor.
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.