Ligar o Claude Code ao seu estúdio
O que é
Seção intitulada “O que é”O Claude Code é o Claude da Anthropic que funciona no terminal do computador. Com o conector de IA, consulta os dados do seu estúdio (vendas, clientes, agenda, finanças) quando faz perguntas, com as permissões do utilizador da chave. Só consulta: não altera nada no sistema.
Quando usar
Seção intitulada “Quando usar”- Já utiliza o Claude Code no computador e quer fazer perguntas sobre o movimento do estúdio sem sair dele.
- Quer criar um resumo ou uma folha de cálculo com os números do sistema, pedindo-o em linguagem corrente.
Antes de começar
Seção intitulada “Antes de começar”Tenha à mão o endereço do conector, copiado conforme o artigo Ligar a sua IA. O Claude Code tem de estar instalado no computador. A ligação é feita através do início de sessão no sistema; a chave de API é opcional, para quem prefere não iniciar sessão (por exemplo, num computador sem navegador).
Passo a passo
Seção intitulada “Passo a passo”Passo 1 — Adicionar o conector
Seção intitulada “Passo 1 — Adicionar o conector”No terminal, execute o comando abaixo, substituindo o endereço pelo que copiou em Copiar endereço:
claude mcp add --transport http heya https://seu-dominio/mcpNo Claude Code, escreva /mcp, escolha heya e a opção de autenticação: abre-se a página de início de sessão do sistema no navegador. Inicie sessão, escolha a Empresa e clique em Autorizar.
Se preferir usar a chave de API (criada com Permitir utilização como conector de IA), adicione o cabeçalho ao comando: --header "Authorization: Bearer hk_...".
Para usar o conector em todas as pastas do computador, e não apenas na pasta atual, adicione --scope user ao comando.
Passo 2 — Confirmar a ligação
Seção intitulada “Passo 2 — Confirmar a ligação”Execute claude mcp list. O conector heya deve aparecer como ligado. No Claude Code, o comando /mcp mostra o mesmo.
Passo 3 — Fazer uma pergunta
Seção intitulada “Passo 3 — Fazer uma pergunta”Abra o Claude Code e faça uma pergunta, por exemplo: «Quanto vendi ontem no estúdio?». Da primeira vez, o Claude pode pedir a sua aprovação para usar as ferramentas do conector.
O que acontece depois
Seção intitulada “O que acontece depois”- O Claude procura a consulta certa para a pergunta, executa-a e responde com os números do sistema.
- A chave aparece no separador API Key com o Último uso atualizado.
- Para cortar o acesso, revogue a chave no separador API Key: o Claude Code perde o acesso em até 30 segundos.
Erros comuns e dúvidas
Seção intitulada “Erros comuns e dúvidas”P: O claude mcp list mostra “Failed to connect”. O que devo fazer?
R: Confirme se o endereço termina em /mcp e se a chave foi colada na íntegra, com Bearer e um espaço a seguir.
O comando guarda a configuração sem testar a chave: o erro só aparece quando o Claude tenta estabelecer a ligação.
P: O Claude diz que a chave tem de ter a opção “Permitir uso como conector de IA”. Porquê? R: A chave foi criada sem essa opção. Edite a chave no separador API Key e selecione Permitir utilização como conector de IA.
P: Como altero a chave?
R: Remova o conector com claude mcp remove heya e volte a adicioná-lo com a nova chave.
P: Posso partilhar a configuração com a minha equipa através do repositório?
R: Não coloque a chave num ficheiro partilhado (--scope project guarda a configuração em .mcp.json). Cada pessoa deve usar a sua própria chave, com as permissões do seu próprio utilizador.
P: O Claude disse que não encontrou uma informação que consigo ver no sistema. Porquê? R: O utilizador da chave não tem acesso a esse ecrã, ou a informação está fora do conector por motivos de segurança (conversas do WhatsApp, anamnese, fotografias e conta digital). Consulte o artigo Conector de IA.