Conectar o Claude Code ao seu estúdio

O que é

O Claude Code é o Claude da Anthropic que roda no terminal do computador. Com o conector de IA, ele consulta os dados do seu estúdio (vendas, clientes, agenda, financeiro) quando você pergunta, com as permissões do usuário da chave. Ele só consulta: não altera nada no sistema.

Quando usar

Você já usa o Claude Code no computador e quer perguntar sobre o movimento do estúdio sem sair dele.
Você quer montar um resumo ou uma planilha com números do sistema, pedindo em linguagem normal.

Antes de começar

Tenha em mãos o endereço do conector, copiado conforme o artigo Conecte sua IA. O Claude Code precisa estar instalado no computador. Ele entra pelo login do sistema; a chave de API é opcional, para quem prefere não usar o login (por exemplo, numa máquina sem navegador).

Passo a passo

Passo 1 — Adicionar o conector

No terminal, rode o comando abaixo, trocando o endereço pelo que você copiou em Copiar endereço:

claude mcp add --transport http heya https://seu-dominio/mcp

Dentro do Claude Code, digite /mcp, escolha heya e a opção de autenticar: abre a tela de login do sistema no navegador. Entre, escolha a Empresa e clique em Autorizar.

Se preferir a chave de API (criada com Permitir uso como conector de IA), acrescente o cabeçalho ao comando: --header "Authorization: Bearer hk_...".

Para usar o conector em todas as pastas do computador, e não só na pasta atual, acrescente --scope user ao comando.

Passo 2 — Conferir a conexão

Rode claude mcp list. O conector heya deve aparecer como conectado. Dentro do Claude Code, o comando /mcp mostra o mesmo.

Passo 3 — Perguntar

Abra o Claude Code e pergunte, por exemplo: “quanto vendi ontem no estúdio?”. Na primeira vez, o Claude pode pedir sua aprovação para usar as ferramentas do conector.

O que acontece depois

O Claude busca a consulta certa para a pergunta, executa e responde com os números do sistema.
A chave aparece na aba API Key com o Último uso atualizado.
Para cortar o acesso, revogue a chave na aba API Key: o Claude Code perde o acesso em até 30 segundos.

Erros comuns e dúvidas

P: O claude mcp list mostra “Failed to connect”. O que faço? R: Confira se o endereço termina em /mcp e se a chave foi colada inteira, com Bearer e um espaço antes. O comando grava a configuração sem testar a chave: um erro só aparece quando o Claude tenta conectar.

P: O Claude diz que a chave precisa ter “Permitir uso como conector de IA”. Por quê? R: A chave foi criada sem essa opção. Edite a chave na aba API Key e marque Permitir uso como conector de IA.

P: Como troco a chave? R: Remova o conector com claude mcp remove heya e adicione de novo com a chave nova.

P: Posso compartilhar a configuração com a minha equipe pelo repositório? R: Não coloque a chave num arquivo compartilhado (--scope project grava em .mcp.json). Cada pessoa deve usar a própria chave, com as permissões do próprio usuário.

P: O Claude disse que não encontrou uma informação que eu vejo no sistema. Por quê? R: O usuário da chave não tem acesso a essa tela, ou ela fica fora do conector por segurança (conversas do WhatsApp, anamnese, fotos e conta digital). Veja o artigo Conector de IA.