Como Conectar ChatGPT, Claude ou Manus ao Bitrix24 via MCP

O Que é MCP e Por Que o Bitrix24 o Adota

O Model Context Protocol (MCP) é um padrão aberto que permite a um assistente de IA receber uma lista de "ferramentas" disponíveis e chamá-las durante o diálogo - em vez de gerar comandos brutos e torcer para que o formato esteja correto. O resultado prático: você fala com o ChatGPT ou o Claude e eles operam o Bitrix24 diretamente, com suas credenciais.

O protocolo foi criado pela Anthropic e rapidamente adotado por outros fornecedores como padrão de integração entre LLMs e sistemas externos. Do ponto de vista técnico, o servidor MCP expõe funções com assinaturas bem definidas; o modelo de linguagem escolhe qual função chamar e com quais parâmetros, sem precisar "adivinhar" a estrutura da API.

No contexto do Bitrix24, isso significa que um colaborador pode abrir o ChatGPT, digitar "mova o negócio com a Empresa X para a etapa Proposta Enviada" e a ação acontece no CRM - sem abrir o portal, sem clicar em menus.

Os Dois Servidores MCP Oficiais do Bitrix24

O Bitrix24 mantém dois servidores MCP com propósitos distintos: um para usuários finais gerenciarem o portal pelo chat com uma IA externa, e outro voltado a desenvolvedores que precisam consultar a documentação da REST API em tempo real.

O servidor de gestão do portal - documentado em helpdesk.bitrix24.com (27 ago. 2026) - é o que conecta ChatGPT, Manus, Claude e similares ao CRM, tarefas e e-mail reais do portal. O servidor de documentação (mcp-dev.bitrix24.com/mcp) oferece acesso à documentação atualizada da REST API via Streamable HTTP, sem autenticação, e tem configurações prontas para Claude Code, Claude Desktop, Cursor e VS Code - mas não acessa dados do portal.

Existe ainda o pacote @bitrix24/mcp-vibecode-api, que permite a ferramentas de codificação por IA chamar a Vibe API com uma chave vibe_api_. Trata-se de um recurso para desenvolvedores dentro do ecossistema Alaio Vibecode, não de uma integração de usuário final.

Como o administrador ativa a integração MCP no portal?

Apenas um administrador do portal pode liberar a conexão de IAs externas. A ativação leva menos de um minuto, mas exige atenção ao aviso oficial de segurança emitido pelo próprio Bitrix24.

Passo a passo conforme documentação oficial (helpdesk.bitrix24.com/open/25866707/, 27 ago. 2026):

1. Clique no menu ao lado do nome da conta.
2. Acesse Configurações > Servidores MCP.
3. Ative a opção "Permitir conexão de IAs externas ao Bitrix24".
4. Clique em Salvar.

Aviso oficial do Bitrix24: "Essas conexões podem introduzir riscos de segurança e de processamento de dados fora do controle do Bitrix24." Leia o aviso completo antes de ativar em ambientes com dados sensíveis.

Enquanto a opção estiver desligada, nenhum colaborador consegue usar as integrações, mesmo que as tenha configurado anteriormente. Os itens já criados via integração permanecem no portal.

Conectar o ChatGPT via OAuth (Plus e Pro)

A integração com o ChatGPT usa OAuth e está disponível apenas nos planos ChatGPT Plus e Pro. O fluxo exige ativar o modo desenvolvedor dentro do ChatGPT e apontar para o endpoint oficial do Bitrix24.

O processo a seguir flui da ativação no Bitrix24 até o uso dentro do chat:

Detalhamento de cada etapa:

1. No ChatGPT, abra seu perfil e vá em Configurações > Apps e conectores > Configurações avançadas.
2. Ative o Modo desenvolvedor e volte à lista de conectores.
3. Clique em Criar app e preencha: - Nome: qualquer nome descritivo (ex.: "Meu Bitrix24"). - URL do servidor MCP: https://mcp.bitrix24.com/mcp/ - Tipo de autorização: OAuth.
4. Aceite os termos e faça login na sua conta Bitrix24 quando solicitado.
5. Para usar, clique em + > Mais > Bitrix24 no campo de mensagem do ChatGPT.

Conectar Manus, Claude ou Cursor via Token

O Manus e qualquer cliente que suporte "MCP personalizado com token" se conectam ao Bitrix24 gerando um token no portal e configurando o transporte HTTP. Claude e Cursor seguem o mesmo padrão, mas essa é uma configuração própria - não uma integração descrita oficialmente pelo Bitrix24.

O artigo de visão geral do Bitrix24 (helpdesk.bitrix24.com/open/25846367/, 5 ago. 2026) menciona Manus, Cursor e n8n como exemplos de clientes compatíveis. Claude e Cursor funcionam pelo mesmo padrão de MCP remoto com token de cabeçalho - mas sua configuração é considerada uma integração personalizada, não um fluxo oficialmente documentado pelo Bitrix24.

Como gerar o token no Bitrix24:

1. Acesse Aplicativos > Conexões MCP.
2. Clique em Obter token de conexão e copie o token gerado.

Como configurar no cliente de IA (Manus, Claude, Cursor etc.):

Para Claude Code conectar ao servidor de documentação de desenvolvedores (sem acesso a dados reais):

claude mcp add --transport http b24-dev-mcp https://mcp-dev.bitrix24.com/mcp

O Que a IA Consegue Fazer Dentro do Bitrix24

Via MCP, um assistente externo consegue executar operações de CRM, tarefas, e-mail e estrutura organizacional no Bitrix24 - mediante comando explícito do colaborador e dentro de suas permissões de acesso.

Ações disponíveis conforme documentação oficial (ago. 2026):

• CRM: mover negócios entre etapas, criar pipelines, editar estágios.
• Tarefas: localizar, criar e editar tarefas.
• Estrutura da empresa: consultar e atualizar a organização.
• Colaboradores: convidar novos membros para o portal.
• E-mail: localizar, ler e enviar e-mails.
• Comunicação: criar eventos, chats e publicações no feed a partir de e-mails.

O conjunto de ações disponíveis tende a crescer conforme o produto evolui. O próprio Bitrix24 anunciou o MCP Hub para serviços externos (Gmail, Google Drive) como "em breve" - ainda não disponível no momento desta publicação.

Para quem usa ferramentas de IA do Bitrix24 como o CoPilot internamente, o MCP via servidor externo é complementar: permite trazer IAs de outros ecossistemas para operar o portal, enquanto o CoPilot permanece integrado nativamente.

Permissões, Revogação e o Que Acontece com os Dados Criados

A IA age exclusivamente quando o colaborador dá um comando e opera apenas dentro das permissões que esse colaborador já possui no Bitrix24 - sem elevar privilégios.

Pontos importantes sobre o modelo de segurança:

• Um colaborador sem acesso a determinado funil de CRM não consegue fazer a IA acessá-lo via MCP.
• O assistente externo solicita confirmação antes de executar ações, envia um relatório com os resultados no chat.
• Revogar acesso: acesse Aplicativos > Conexões MCP > Meus tokens, localize a conexão e clique em Fechar acesso.
• Itens criados pela integração (negócios, tarefas, e-mails) permanecem no Bitrix24 após a revogação.

Para contexto sobre como a IA do Bitrix24 processa dados, consulte o artigo sobre onde a IA do Bitrix24 processa seus dados e como manter a conformidade.

Em quais planos do Bitrix24 o servidor MCP está disponível?

O servidor MCP de gestão do portal faz parte do plano Vibe+. Planos Essentials não têm acesso a esse recurso conforme documentação oficial (helpdesk.bitrix24.com/open/26027119/).

Antes de ativar, verifique:

• Se o portal está em um plano Vibe+ (cloud).
• Se o cliente de IA externo (ChatGPT, Manus etc.) possui plano compatível com integrações MCP - no caso do ChatGPT, é necessário Plus ou Pro.
• Se há restrições de conformidade no seu setor que exijam avaliar o fluxo de dados entre o Bitrix24 e provedores externos de IA.

Em ambientes com requisitos rigorosos de proteção de dados (LGPD, GDPR), considere revisar a política de retenção do provedor externo antes de conectar IAs de terceiros ao CRM. O Bitrix24 self-hosted oferece uma camada adicional de controle sobre quais dados saem do servidor - veja a comparação em CRM em conformidade com LGPD/GDPR.

Quais verificações de segurança fazer antes de ativar o MCP?

Antes de liberar conexões MCP em produção, revise cada item abaixo - especialmente em portais com dados de clientes, contratos ou informações financeiras.

• O aviso oficial de segurança do Bitrix24 foi lido e comunicado aos gestores responsáveis.
• A ativação foi feita por um administrador com plena consciência dos riscos de processamento de dados fora do Bitrix24.
• Somente colaboradores que realmente precisam do recurso configuraram seus tokens.
• Tokens não utilizados foram revogados em Aplicativos > Conexões MCP > Meus tokens.
• Os colaboradores entendem que a IA age com as permissões deles - não com permissões reduzidas.
• Foi definida uma política de revisão periódica das conexões ativas (recomendado: mensal).
• Para ambientes regulados (saúde, financeiro, jurídico), a integração foi avaliada pelo DPO ou área jurídica antes da ativação.
• O plano do cliente de IA externo (ex.: ChatGPT Plus/Pro) foi confirmado antes de iniciar a configuração.
• Tokens são armazenados de forma segura - nunca em código-fonte ou e-mails.

Para uma visão mais ampla de controles de segurança no Bitrix24, o checklist de hardening para self-hosted traz 25 pontos aplicáveis a instalações on-premise.

Se sua equipe usa o Bitrix24 para automação de vendas e quer entender como as ferramentas de IA se encaixam no funil, o artigo sobre IA para equipes de vendas no Bitrix24 detalha os casos de uso do CoPilot dentro do próprio portal.