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

# Conectar Claude Code e Codex ao Leadzy por MCP

> Conecte seu aplicativo de IA com login Leadzy para consultar o CRM, conversas e métricas, respeitando suas permissões.

O **MCP** conecta um aplicativo de IA à sua conta Leadzy. Você pode buscar registros do CRM, resumir conversas do WhatsApp e consultar métricas de atendimento. As funções disponíveis dependem do seu plano, das permissões da conta e do acesso autorizado ao aplicativo.

Use uma versão atualizada do **Claude Code**, **Codex** ou outro cliente com suporte a MCP remoto e login **OAuth**. Para abrir a configuração na Leadzy, você precisa de permissão para gerenciar integrações.

## Conectar com sua conta

**1. Copie a URL na Leadzy**

Abra **Configurações → MCP**. Em **Conecte seu aplicativo de IA**, clique em **Copiar URL**.

```text theme={null}
https://api-userv2.leadzy.com.br/mcp
```

Para uma configuração guiada pela sua IA, use **Copiar prompt de configuração**. Esse texto pode ser colado na conversa; ele não contém sua senha nem um token.

**2. Adicione o servidor no aplicativo**

Use o nome **leadzy** e o transporte **Streamable HTTP**. Se já houver uma conexão com esse nome, confira a conta antes de substituí-la.

**Claude Code**

No terminal, adicione o servidor à sua configuração pessoal:

```bash theme={null}
claude mcp add --transport http --scope user leadzy https://api-userv2.leadzy.com.br/mcp
```

Dentro do Claude Code, execute `/mcp`, selecione **leadzy** e siga a opção de autenticação para abrir o navegador.

**Codex**

No aplicativo, abra **Configurações → Servidores MCP**, adicione a URL e escolha a conexão com login OAuth. Os rótulos podem variar conforme a versão.

Pelo terminal, adicione o servidor com:

```bash theme={null}
codex mcp add leadzy --url https://api-userv2.leadzy.com.br/mcp
```

Se a autenticação ficar pendente, execute `codex mcp login leadzy`.

**3. Confira e autorize o acesso**

Na página da Leadzy, confira **sua conta, empresa, aplicativo, destino de retorno e permissões**. Clique em **Autorizar conexão** somente se reconhecer a solicitação. Depois, volte ao aplicativo de IA.

No login OAuth, você não precisa criar ou colar um token pessoal.

**4. Teste somente a conexão**

Peça à IA:

> Liste as ferramentas do Leadzy e execute somente leadzy\_me para conferir minha conta e os acessos disponíveis. Não consulte registros, conversas ou métricas e não faça alterações.

Confira se a resposta identifica a conta esperada e informa as funções liberadas. Uma configuração salva ou uma tela de login concluído, sozinha, não confirma esse teste.

> [!WARNING]
>
> O WhatsApp é **somente consulta** pelo MCP: não há envio de mensagens. Criar ou alterar registros do CRM exige acesso de escrita e um pedido explícito seu; essas ações podem acionar as automações configuradas.

## Depois de conectar

Experimente pedidos como:

* “Busque as negociações em aberto do funil que eu indicar.”
* “Resuma o histórico da conversa que eu selecionar.”
* “Mostre minha fila de atendimento atual.”

## Desconectar um aplicativo

Em **Configurações → MCP → Aplicativos conectados**, localize a conexão, clique em **Desconectar** e confirme. Isso revoga o acesso dessa conexão. A autorização vale por até **90 dias**; depois, será necessário autorizar novamente.

## Precisa de ajuda?

[Resolver problemas de conexão ou usar um token manual](/central/configuracoes/mcp-resolver-problemas) · [Gerenciar equipe](/account/team)


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