Como conectar o Claude ao Bitrix24 com MCP (guia passo a passo)
Conectar o Claude ao Bitrix24 permite consultar e gerenciar o seu CRM falando em linguagem natural: “quais negócios fecho esta semana?”, “crie uma tarefa para a equipe de suporte”, “resuma as últimas conversas do lead 4821”. Neste guia você verá como fazer isso em poucos minutos usando o conector MCP Bridge.
O que você precisa
- Uma conta Bitrix24 (nuvem ou on-premise) onde você possa instalar apps.
- Acesso ao Claude (Claude Desktop, Claude Code ou Claude na web com conectores).
- 2 minutos.
Passo 1 — Instale o conector MCP Bridge
Abra a página do MCP Bridge no Marketplace do
Bitrix24
e instale na sua conta. Ao abrir o app pela primeira vez você verá o seu token
de acesso (mcp_token) e as instruções de configuração para cada cliente.
O token é pessoal: respeita as suas permissões dentro do Bitrix24. Se outro usuário copiá-lo, a IA só verá o que aquele usuário tem permissão de ver.
Passo 2 — Conecte o Claude
Você tem dois caminhos conforme usa o Claude:
Opção A — Claude na web (OAuth, recomendado)
Nas configurações de conectores do Claude, adicione um conector novo com a
URL do seu servidor MCP (você a encontra na tela do conector, normalmente
https://seu-dominio/mcp). O Claude te levará a uma tela de autorização
OAuth 2.1: cole o seu mcp_token, autorize e pronto. Não precisa mexer em
nenhum arquivo.
Opção B — Claude Desktop / Claude Code (arquivo de configuração)
Adicione o servidor MCP à sua configuração local. A própria tela do conector te dá o bloco JSON exato e o comando do Claude Code prontos para copiar, com o seu token já incluído.
Passo 3 — Teste
Abra um novo chat no Claude e peça algo do seu CRM:
“Quantos negócios ganhei no mês passado e qual foi a taxa de conversão?”
O Claude vai descobrir a ferramenta de analítica, executá-la contra o Bitrix24 e devolver os números reais. Experimente também:
- “Liste os 10 negócios em aberto de maior valor.”
- “Quais tarefas estão atrasadas esta semana?”
- “Crie uma tarefa: ligar para o cliente Acme na sexta, prioridade alta.”
O que você pode pedir ao Claude sobre o Bitrix24
Com o conector ativo, o Claude pode consultar (leads, negócios, contatos, empresas, funis, tarefas), analisar (conversão, gargalos, produtividade da equipe) e escrever (criar e atualizar registros, tarefas, comentários, to-dos e processos). São mais de 55 ferramentas no total.
Segurança
O conector usa OAuth 2.1 com PKCE, respeita as permissões por usuário do Bitrix24 e assina cada ação de escrita na timeline do CRM para garantir rastreabilidade. Você pode revogar o acesso quando quiser pelo próprio app.
E se eu usar o ChatGPT?
O mesmo conector funciona com o ChatGPT e qualquer cliente compatível com MCP. Você tem o guia dedicado aqui: ChatGPT + Bitrix24: controle seu CRM com IA.
Ainda não tem? Instale o MCP Bitrix24 ou leia primeiro o que é um servidor MCP para Bitrix24.