PT
Entrar Comece grátis

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

  1. Crie sua conta Hooky (grátis para um site), cadastre seu site e copie o prompt dele em Sites: a chave já está dentro.

  2. Abra o Claude Code na raiz do projeto (claude no terminal, ou pelo seu editor).

  3. 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).

  4. 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.

  1. Adicione o servidor num terminal:

    claude mcp add --transport http hooky https://api.heyhooky.com/mcp

    Por padrão, o servidor só vale para o projeto atual. Para tê-lo em todos os seus projetos, adicione --scope user.

  2. 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.

  3. Confira: claude mcp list no terminal, ou /mcp no 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.