Skip to main content
Comece pelo guia de conexão. Para conferir o resultado, peça à IA para listar as ferramentas e executar somente leadzy_me, sem consultar registros ou fazer alterações.
Confira se leadzy está habilitado no aplicativo e recarregue essa conexão. No Claude Code, verifique o estado em /mcp; no Codex, confira o servidor nas configurações MCP. Se o aplicativo pedir uma reinicialização, encerre-o completamente e abra novamente.Se o Codex informar timeout de inicialização, você pode acrescentar startup_timeout_sec = 60 à entrada existente em sua configuração pessoal:
Preserve os outros servidores e recarregue o Leadzy. Esse ajuste aumenta o tempo de espera; o teste leadzy_me ainda precisa passar.
Confira se o aplicativo e o CLI usado no terminal estão atualizados: eles podem ter versões diferentes. No Codex, codex --version mostra a versão do comando do terminal. Atualize pelo canal oficial e inicie um novo login.Não remova a validação do emissor para contornar o erro. Se persistir, encaminhe a mensagem ao suporte.
A solicitação de autorização dura cinco minutos e só pode ser usada uma vez. Inicie a conexão novamente pelo aplicativo e autorize na nova aba, conferindo sua conta e empresa. No Codex, use codex mcp login leadzy; no Claude Code, abra /mcp e autentique o servidor.
Confira os acessos retornados por leadzy_me. O login não amplia seu plano nem suas permissões:
  • CRM: exige acesso ao CRM e permissão para os registros. Alterações também exigem escrita autorizada.
  • Conversas do WhatsApp: exigem acesso à Central, autorização para consultar conversas e permissão sobre cada conversa.
  • Métricas de atendimento: exigem Central e permissão para visualizar métricas. Relatórios comerciais também exigem leitura do CRM; detalhes exigem leitura de conversas e acesso aos registros.
Peça ao administrador para conferir seu papel e suas permissões. Se faltou uma permissão na autorização do aplicativo, faça uma nova conexão com os acessos necessários.
PAT significa token de acesso pessoal. Esse é o caminho manual para clientes que usam autenticação Bearer:
  1. Na Leadzy, abra Configurações → MCP → Configuração manual com token · avançado. Crie um token com nome, validade e apenas as permissões necessárias.
  2. Use Copiar token na criação: a chave completa aparece uma única vez. O prefixo abreviado da lista não autentica.
  3. Informe a chave somente no campo de credenciais do aplicativo ou em uma entrada local oculta. Nunca a cole em conversas, comandos salvos ou arquivos do projeto.
No Codex, a opção bearer_token_env_var = "LEADZY_MCP_TOKEN" exige que essa variável esteja disponível ao processo do aplicativo. Um export em outro terminal não basta para o desktop; siga a configuração de credenciais do seu ambiente e reabra o aplicativo quando necessário.Não misture PAT com OAuth na mesma entrada. Se a chave foi exposta, revogue-a na Leadzy e crie outra. Repita o teste apenas com leadzy_me.
Confira sua conexão e a mensagem exibida pelo cliente. Um 401 pede verificação do login ou da validade do token; um 403 pode vir das permissões ou de uma proteção de rede. Um bloqueio Cloudflare 1010 acontece antes de chegar à Leadzy e não comprova que o token esteja inválido.Se persistir, informe ao suporte o aplicativo, a versão, o horário e o identificador da requisição, se houver. Oculte credenciais, URLs de retorno OAuth e dados de clientes. Não desative proteções para tentar conectar.

​
Próximos passos

Conectar Claude Code e Codex · Falar com o suporte