> ## Documentation Index
> Fetch the complete documentation index at: https://ajuda.leadzy.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Resolver problemas de conexão com o MCP Leadzy

> Confira o que fazer quando o login expira, as ferramentas não aparecem ou o aplicativo exige um token pessoal.

Comece pelo [guia de conexão](/central/configuracoes/mcp). Para conferir o resultado, peça à IA para listar as ferramentas e executar **somente `leadzy_me`**, sem consultar registros ou fazer alterações.

> **O login terminou, mas as ferramentas não aparecem**
>
> 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:
>
> ```toml theme={null}
> [mcp_servers.leadzy]
> url = "https://api-userv2.leadzy.com.br/mcp"
> startup_timeout_sec = 60
> ```
>
> Preserve os outros servidores e recarregue o Leadzy. Esse ajuste aumenta o tempo de espera; o teste `leadzy_me` ainda precisa passar.

> **Aparece um erro de issuer ou emissor OAuth**
>
> 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 expirou ou o resultado não foi confirmado**
>
> 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.

> **A conexão funciona, mas faltam dados ou ações**
>
> 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.

> **Meu aplicativo exige um token pessoal (PAT)**
>
> **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`.

> **Há erro de rede, bloqueio ou rejeição HTTP**
>
> 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](/central/configuracoes/mcp) · [Falar com o suporte](mailto:contato@leadzy.com.br)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.