Mejor compañero de IA para Bitrix CMS — Guía de configuración de MCP

Mejor compañero de IA para Bitrix CMS: conecta a Mia vía MCP

Bitrix Site Manager impulsa millones de sitios empresariales en todo el mundo — y con Model Context Protocol (MCP), ahora habla directamente con Mia, tu secretaria personal de IA. En esta guía, recorreremos la configuración completa: desde instalar el módulo MCP oficial hasta conectarlo con tu chat de Mia.

Una vez conectada, puedes pedirle a Mia que gestione noticias, iblocks, usuarios, pedidos y más — todo desde una única conversación en Telegram. Sin pestañas del navegador, sin paneles de administración, sin cambios de contexto.

¿Qué es MCP y por qué deberías preocuparte?

El Model Context Protocol es un estándar abierto que permite que los agentes de IA se comuniquen con servicios externos mediante una interfaz estructurada y segura.

Un servidor MCP expone las capacidades de un sistema. Un cliente MCP (Mia) se conecta a ese servidor e invoca esas capacidades en tu nombre.

Para los propietarios de sitios de Bitrix, esto significa que puedes hacer cosas como:

Pedirle a Mia que publique artículos de noticias o actualice entradas de iblock
Buscar pedidos, clientes o productos por criterios
Generar reportes sobre ventas, tráfico o rendimiento del contenido
Crear usuarios, asignar roles o gestionar permisos
Consultar analíticas o extraer métricas de rendimiento

Todo desde un solo chat de Telegram.

Requisitos previos

Antes de comenzar, asegúrate de tener:

Un sitio 1C-Bitrix (con licencia, con la instalación de módulos habilitada)
Acceso de administrador para instalar módulos y configurar ajustes
Una cuenta de Mia Handles con al menos un plan Standard (las conexiones MCP requieren acceso a API)
Un certificado SSL en tu sitio de Bitrix (HTTPS es obligatorio para el endpoint MCP)

Paso 1 — Instala el módulo hiweb.site_mcp

El módulo recomendado es hiweb.site_mcp del Bitrix Marketplace. Proporciona la implementación oficial del servidor MCP para Bitrix.

Enlace del marketplace: https://marketplace.1c-bitrix.ru/hiweb.site_mcp

Nota: La página del marketplace está actualmente en construcción, pero se publicará pronto. Si ya tienes el módulo, ve al Paso 2.

Desde tu panel de administración de Bitrix:

Ve a Settings → Marketplace
Busca hiweb.site_mcp o usa el enlace directo anterior
Instala y activa el módulo
Después de activarlo, ve a Settings → Settings of the Site → MCP Server

Ahí encontrarás:

Endpoint URL — la URL pública para el endpoint MCP (típicamente https://yoursite.com/api/mcp/)
Authentication — configuración de token bearer
Tools to expose — activa qué capacidades de Bitrix puede acceder Mia (iblocks, news, users, orders, analytics, etc.)

Paso 2 — Genera un token Bearer

El módulo Bitrix MCP usa autenticación de Bearer token para acceso seguro a la API.

Ve a Settings → Settings of the Site → MCP Server
Haz clic en Generate Token o Create New Token
Dale un nombre, por ejemplo Mia MCP Integration
Establece la expiración del token (recomendado: sin expiración para uso en producción)
Copia el token generado — solo lo verás una vez

Este token se convierte en la credencial que Mia usa para conectarse a tu sitio de Bitrix.

Paso 3 — Expón el endpoint de forma segura

El endpoint MCP solo debería poder alcanzarse para los servicios en los que confías. Opciones típicas:

Bearer token auth — cada solicitud debe incluir el encabezado Authorization con el bearer token
IP allowlist — restringe la ruta MCP al rango de IP del backend de Mia
Red privada / VPC — para configuraciones empresariales

Si tu sitio de Bitrix está detrás de Cloudflare u otro WAF, asegúrate de que la ruta MCP esté permitida mediante métodos POST. Prueba el endpoint primero con curl (consulta el Paso 5) antes de conectar Mia.

Paso 4 — Conecta el servidor de Bitrix en Mia Handles

Ahora viene lo divertido. En tu chat de Mia:

Abre la Mia miniapp (toca tu foto de perfil o usa el menú)
Ve a Settings → Tools → MCP Servers → Add (o edita un servidor existente)
Rellena el formulario de conexión:

Server name:   My Bitrix Site
Endpoint URL:  https://example.com/hiweb-site-mcp/
Transport:     JSON POST (stateless)
Auth:          Bearer token
Token:         (pega el bearer token generado)

Importante: Selecciona JSON POST (stateless) como tipo de transporte. NO uses Streamable HTTP o SSE — el módulo MCP de Bitrix solo acepta solicitudes POST JSON-RPC.

Toca Connect. Mia validará el endpoint, listará las herramientas disponibles y agregará el servidor a tu chat.

Paso 5 — Prueba la conexión

Una vez conectada, prueba un comando simple en tu chat de Mia:

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

Mia debería devolver un resumen obtenido directamente de tu sitio. Si aparece un error, revisa:

Validez y expiración del bearer token
El módulo MCP está activo y las herramientas están habilitadas
El Endpoint URL es accesible desde el backend de Mia (firewall, certificado SSL)
El tipo de transporte está configurado como JSON POST (stateless)

También puedes probar manualmente con 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/"

Deberías recibir una lista de herramientas en JSON — eso significa que el servidor está vivo.

Paso 6 — Qué puedes hacer después de la configuración

Una vez conectada, Mia se convierte en tu copiloto para Bitrix. Estas son las cosas más comunes que puedes hacer:

Operaciones de contenido — crear, actualizar o publicar artículos de noticias y entradas de iblock
Gestión de medios — listar, subir o reemplazar imágenes en archivos
Gestión de usuarios — crear cuentas, restablecer contraseñas, asignar roles
Pedidos y CRM — consultar pedidos, clientes, tratos o leads
Analíticas — extraer reportes de tráfico, métricas de conversión o resúmenes de ventas
Publicación programada — poner contenido en cola para fechas futuras mediante el calendario de Mia

Y como Mia ya conoce tu calendario, tus tareas y tus archivos, puede orquestar el trabajo en Bitrix junto con el resto de tu día — por ejemplo:

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

Mia se encargará de las tres cosas de una sola vez.

Solución de problemas

Síntoma	Causa probable	Solución
"Connection failed"	Endpoint bloqueado o URL incorrecta	Revisa las reglas del firewall y el certificado SSL
"No tools available"	Módulo deshabilitado o no se activaron herramientas	Vuelve a habilitar y selecciona al menos una herramienta
"Unauthorized"	Bearer token no válido	Regenera en la configuración de MCP y actualiza en Mia
"HTTP 404"	Ruta de endpoint incorrecta	Verifica la URL del endpoint configurada del módulo
"Transport error"	Tipo de transporte incorrecto	Usa JSON POST (stateless), no SSE ni Streamable
Respuestas lentas	Demasiadas herramientas habilitadas	Deshabilita herramientas no usadas, habilita paginación

WordPress y Drupal funcionan de la misma manera

Si también ejecutas un sitio de WordPress o Drupal, el mismo patrón aplica. Cada CMS tiene su propio adaptador MCP, pero el flujo de conexión en Mia es idéntico: instala el módulo, expone un endpoint, pega credenciales en Mia. Incluso puedes conectar las tres plataformas al mismo chat de Mia, y ella se dirigirá a cada una por su nombre.

Para las otras guías, consulta:

Para finalizar

Conectar Bitrix con Mia vía MCP convierte tu CMS de un panel independiente en una extensión conversacional de tu flujo de trabajo diario. Una vez configurado, funciona solo — de forma silenciosa, en segundo plano, cada vez que lo necesites.

Si tienes preguntas o quieres ayuda para configurarlo, solo pídeselo directamente a Mia en el chat. Ella ya conoce el protocolo.