Melhor IA Companheira para o Bitrix CMS — Guia de Configuração do MCP

Melhor IA Companheira para o Bitrix CMS: Conecte a Mia via MCP

O Bitrix Site Manager administra milhões de sites corporativos no mundo — e com o Model Context Protocol (MCP), agora ele se comunica diretamente com a Mia, sua secretária pessoal de IA. Neste guia, vamos passar por toda a configuração: da instalação do módulo MCP oficial até conectá-lo ao seu chat da Mia.

Depois de conectado, você pode pedir à Mia para gerenciar notícias, iblocks, usuários, pedidos e muito mais — tudo a partir de uma única conversa no Telegram. Sem abas do navegador, sem painéis de administração, sem alternar contextos.

O que é MCP e por que você deve se importar?

O Model Context Protocol é um padrão aberto que permite que agentes de IA se comuniquem com serviços externos por meio de uma interface estruturada e segura.

Um servidor MCP expõe as capacidades de um sistema. Um cliente MCP (Mia) se conecta a esse servidor e invoca essas capacidades em seu nome.

Para proprietários de sites Bitrix, isso significa que você pode fazer coisas como:

Pedir à Mia para publicar notícias ou atualizar entradas de iblock
Buscar pedidos, clientes ou produtos por critérios
Gerar relatórios sobre vendas, tráfego ou desempenho de conteúdo
Criar usuários, atribuir papéis ou gerenciar permissões
Consultar análises ou extrair métricas de desempenho

Tudo a partir de um único chat no Telegram.

Pré-requisitos

Antes de começar, certifique-se de que você tem:

Um site 1C-Bitrix (licenciado, com a instalação de módulos habilitada)
Acesso de administrador para instalar módulos e configurar as configurações
Uma conta Mia Handles com pelo menos um plano Standard (conexões MCP exigem acesso via API)
Um certificado SSL no seu site Bitrix (HTTPS é necessário para o endpoint do MCP)

Etapa 1 — Instale o módulo hiweb.site_mcp

O módulo recomendado é hiweb.site_mcp do Bitrix Marketplace. Ele fornece a implementação oficial do servidor MCP para o Bitrix.

Link do marketplace: https://marketplace.1c-bitrix.ru/hiweb.site_mcp

Observação: a página do marketplace está atualmente em construção, mas será publicada em breve. Se você já tiver o módulo, pule para a Etapa 2.

No seu painel administrativo do Bitrix:

Vá para Settings → Marketplace
Pesquise hiweb.site_mcp ou use o link direto acima
Instale e ative o módulo
Após a ativação, navegue até Settings → Settings of the Site → MCP Server

Lá você encontrará:

Endpoint URL — a URL pública para o endpoint do MCP (tipicamente https://yoursite.com/api/mcp/)
Authentication — configuração de token bearer
Tools to expose — opção para definir quais capacidades do Bitrix a Mia pode acessar (iblocks, notícias, usuários, pedidos, analytics etc.)

Etapa 2 — Gere um Bearer Token

O módulo MCP do Bitrix usa autenticação Bearer token para acesso seguro via API.

Vá para Settings → Settings of the Site → MCP Server
Clique em Generate Token ou Create New Token
Dê a ele um nome, por exemplo Mia MCP Integration
Defina a validade do token (recomendado: sem expiração para uso em produção)
Copie o token gerado — você só verá uma vez

Esse token se torna o credencial que a Mia usa para se conectar ao seu site Bitrix.

Etapa 3 — Exponha o endpoint de forma segura

O endpoint do MCP deve ser acessível apenas para serviços em que você confia. Opções típicas:

Autenticação por bearer token — cada requisição precisa trazer o cabeçalho Authorization com o bearer token
IP allowlist — restringe o caminho do MCP ao intervalo de IPs do backend da Mia
Rede privada / VPC — para configurações corporativas

Se o seu site Bitrix estiver atrás do Cloudflare ou de outro WAF, certifique-se de que o caminho do MCP seja permitido via POST com POST métodos. Teste o endpoint primeiro com curl (veja a Etapa 5) antes de conectar a Mia.

Etapa 4 — Conecte o servidor Bitrix no Mia Handles

Agora vem a parte divertida. No seu chat da Mia:

Abra a Mia miniapp (toque na sua foto de perfil ou use o menu)
Vá para Settings → Tools → MCP Servers → Add (ou edite um servidor existente)
Preencha o formulário de conexão:

Server name:   Meu site Bitrix
Endpoint URL:  https://example.com/hiweb-site-mcp/
Transport:     JSON POST (stateless)
Auth:          Bearer token
Token:         (cole o bearer token gerado)

Importante: selecione JSON POST (stateless) como o tipo de transporte. NÃO use Streamable HTTP ou SSE — o módulo MCP do Bitrix aceita apenas requisições JSON-RPC via POST.

Toque em Connect. A Mia validará o endpoint, listará as ferramentas disponíveis e adicionará o servidor ao seu chat.

Etapa 5 — Teste a conexão

Depois de conectar, tente um comando simples no seu chat da Mia:

"List the last 5 news items on my Bitrix site"

A Mia deve retornar um resumo obtido diretamente do seu site. Se você receber um erro, verifique:

Validade e expiração do bearer token
O módulo MCP está ativo e as ferramentas estão habilitadas
O Endpoint URL é acessível a partir do backend da Mia (firewall, certificado SSL)
O tipo de transporte está definido como JSON POST (stateless)

Você também pode testar manualmente com curl:

curl -H "Authorization: Bearer YOUR_TOKEN" \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}' \
  "https://example.com/hiweb-site-mcp/"

Você deve receber de volta uma lista de ferramentas em JSON — isso significa que o servidor está ativo.

Etapa 6 — O que você pode fazer depois da configuração

Depois de conectado, a Mia vira sua copilota para o Bitrix. Aqui estão as coisas mais comuns que você pode fazer:

Operações de conteúdo — criar, atualizar ou publicar artigos de notícias e entradas de iblock
Gerenciamento de mídia — listar, enviar ou substituir imagens nos arquivos
Gerenciamento de usuários — criar contas, redefinir senhas, atribuir papéis
Pedidos & CRM — consultar pedidos, clientes, negócios ou leads
Analytics — puxar relatórios de tráfego, métricas de conversão ou resumos de vendas
Publicação agendada — colocar conteúdo em fila para datas futuras via o calendário da Mia

E como a Mia já sabe do seu calendário, tarefas e arquivos, ela pode orquestrar o trabalho no Bitrix junto com o resto do seu dia — por exemplo:

"Create a news post about the product launch I sent you, schedule it for Wednesday at 14:00, and add a task for the marketing team to review it."

A Mia cuidará das três coisas de uma vez.

Solução de problemas

Sintoma	Causa provável	Correção
"Connection failed"	Endpoint bloqueado ou URL incorreta	Verifique as regras do firewall e o certificado SSL
"No tools available"	Módulo desativado ou nenhuma ferramenta selecionada	Reative e selecione pelo menos uma ferramenta
"Unauthorized"	Bearer token inválido	Recrie nas configurações do MCP e atualize no Mia
"HTTP 404"	Caminho do endpoint incorreto	Verifique a URL do endpoint configurada no módulo
"Transport error"	Tipo de transporte incorreto	Use JSON POST (stateless), não SSE nem Streamable
Respostas lentas	Muitas ferramentas habilitadas	Desative ferramentas não utilizadas e habilite paginação

WordPress e Drupal funcionam da mesma forma

Se você também usa um site WordPress ou Drupal, o mesmo padrão se aplica. Cada CMS tem seu próprio adaptador MCP, mas o fluxo de conexão no Mia é idêntico — instale o módulo, exponha um endpoint, cole as credenciais no Mia. Você até pode conectar as três plataformas ao mesmo chat da Mia, e ela tratará cada uma pelo nome.

Para os outros guias, veja:

Encerrando

Conectar o Bitrix à Mia via MCP transforma seu CMS de um painel isolado para uma extensão conversacional do seu fluxo de trabalho diário. Depois de configurado, funciona — silenciosamente, em segundo plano, sempre que você precisar.

Se você tiver perguntas ou quiser ajuda para configurar, basta perguntar à Mia diretamente no chat. Ela já conhece o protocolo.