El protocolo MCP (Model Context Protocol) permite que los agentes de inteligencia artificial descubran y ejecuten herramientas operativas de forma segura. Waclis Inbox implementa MCP en dos modalidades reales: exponer Waclis Inbox como Servidor MCP desde Ajustes > Servidor MCP para que clientes de IA externos operen tu cuenta, y conectar Servidores MCP externos a Capitán desde Capitán > Servidores MCP (Beta) (Capitán → Servidores MCP) para que tu asistente nativo ejecute herramientas externas dinámicamente.
Qué puedes hacer
- Exponer Waclis Inbox como Servidor MCP en Ajustes > Servidor MCP para que clientes externos (Claude Desktop, Cursor u orquestadores IA corporativos) consulten y operen conversaciones, contactos, Kanban y tareas.
- Conectar Servidores MCP externos a Capitán desde Capitán > Servidores MCP (Beta) (
Capitán→Servidores MCP) mediante el botón + Conectar servidor MCP. - Descubrir y ejecutar herramientas en vivo sobre transporte SSE / HTTP, configurando Nombre, URL SSE/HTTP y cabeceras de autenticación.
- Garantizar aislamiento seguro respetando los permisos y el alcance de tu cuenta en cada llamada.
Cuándo conviene usarla
- Operación desde clientes IA externos (Modalidad 1 - Inbox como Servidor MCP): Cuando un supervisor quiere pedirle en lenguaje natural a Claude Desktop, Cursor o un orquestador IA que busque contactos, resuma chats abiertos, actualice tarjetas Kanban o cree Tareas en Waclis Inbox.
- Ampliar capacidades de Capitán (Modalidad 2 - Capitán como Cliente MCP): Cuando necesitas que Capitán consulte stock, envíos o sistemas propios conectándose a tu servidor MCP externo durante una charla.
- Catálogo unificado de herramientas IA: Cuando prefieres exponer un único servidor MCP en lugar de mantener herramientas HTTP sueltas.
Disponibilidad por plan
- Plan Estándar: No incluye conectividad MCP (utiliza API REST y Webhooks).
- Plan Premium: Incluye Capitán con herramientas HTTP individuales, sin Servidores MCP.
- Plan Evolución: Habilita ambas modalidades: Ajustes > Servidor MCP y Capitán > Servidores MCP (Beta) (
Capitán→Servidores MCP).
Requisitos previos
- Suscripción activa en Plan Evolución y rol de Administrador en Waclis Inbox.
- Para Ajustes > Servidor MCP: cliente compatible con MCP y tu token de autenticación de Waclis Inbox.
- Para Capitán > Servidores MCP (Beta): asistente creado en Capitán, URL SSE/HTTP (
https://) del servidor MCP externo y sus cabeceras de autorización.
Cómo funciona en Waclis Inbox paso a paso
Modalidad 1: Exponer Waclis Inbox como Servidor MCP
- En el menú lateral izquierdo, ingresa a Ajustes > Servidor MCP.
- Copia la URL del endpoint MCP y revisa los parámetros de conexión.
- Obtén tu credencial siguiendo las instrucciones de Ajustes > Servidor MCP.
- Registra el servidor en tu cliente MCP externo (Claude Desktop, Cursor u orquestador IA) con su URL y cabecera de autorización.
- Desde el cliente externo podrás pedir en lenguaje natural que opere conversaciones, contactos, Kanban y Tareas.
Modalidad 2: Conectar Servidores MCP externos a Capitán (Capitán → Servidores MCP)
- En el menú lateral izquierdo, abre Capitán y selecciona Servidores MCP (Beta) (
Capitán→Servidores MCP). - Haz clic en + Conectar servidor MCP arriba a la derecha.
- Completa los campos:
- Nombre: Identificador del servidor (
MCP Logística ERP). - URL SSE/HTTP: Dirección
https://del servidor MCP externo. - Cabeceras de autenticación: Cabeceras requeridas (
Authorization: Bearer ...oX-API-Key).
- Haz clic en Guardar / Conectar. Capitán descubrirá y ejecutará las herramientas expuestas.
Opciones y configuraciones disponibles
| Modalidad / Parámetro | Ruta en la interfaz | Dirección del flujo | Qué permite hacer |
|---|---|---|---|
| Inbox como Servidor MCP | Ajustes > Servidor MCP | Cliente IA externo a Waclis Inbox | Operar conversaciones, contactos, Kanban y tareas desde IAs externas. |
| Capitán como Cliente MCP | Capitán > Servidores MCP (Beta) (Capitán → Servidores MCP) |
Capitán a Servidor MCP externo | Descubrir y ejecutar herramientas externas durante el chat. |
Botón + Conectar servidor MCP |
Capitán → Servidores MCP |
Alta de servidor externo | Define Nombre, URL SSE/HTTP y cabeceras de autenticación. |
| Transporte SSE / HTTP | Protocolo MCP sobre HTTPS | Bidireccional JSON-RPC | Lista (tools/list) e invoca (tools/call) herramientas en vivo. |
Alternativas y cuándo elegir cada una
| Mecanismo | Quién ejecuta la herramienta | Cuándo elegirlo |
|---|---|---|
| Ajustes > Servidor MCP | Clientes MCP externos (Claude Desktop, Cursor, copilotos). | Para consultar y operar Waclis Inbox desde un asistente externo. |
Capitán > Servidores MCP (Capitán → Servidores MCP) |
El agente nativo Capitán atendiendo clientes. | Para darle a Capitán acceso dinámico a herramientas de tu backend. |
| Herramientas HTTP de Capitán | El agente nativo Capitán. | Cuando solo necesitas llamar a 1 o 2 endpoints REST simples. |
Cómo se combina con otras funciones
- Base de conocimiento de Capitán: Capitán une el conocimiento documental (RAG) con datos en tiempo real obtenidos desde Servidores MCP (
Capitán→Servidores MCP). - Kanban y Tareas: Un cliente conectado a Ajustes > Servidor MCP puede revisar chats del día y crear tarjetas en Kanban o Tareas.
- Traspaso a humano: Si una herramienta MCP reporta una excepción, Capitán transfiere el chat a un agente humano.
Relación con otros productos Waclis
- En Waclis Inbox (Nativo): Tanto Ajustes > Servidor MCP como
Capitán→Servidores MCPson módulos nativos de Inbox. - Con el ecosistema Waclis (
Waclis Connectypanel.waclis.com): La identidad federada y el cambio entre aplicaciones operan mediante Waclis Connect, mientras que los servidores MCP permiten conectar agentes de IA compatibles bajo los permisos de tu cuenta. - Con
panel.waclis.com: La suscripción al Plan Evolución que habilita MCP se administra enpanel.waclis.com.
Buenas prácticas
Capitán → Servidores MCP únicamente herramientas seguras de consulta o acción autorizada, sin exponer operaciones destructivas.description y el inputSchema de cada tool MCP: La precisión con que la IA elige una herramienta depende de la claridad de sus descripciones en el servidor MCP.Errores frecuentes y solución de problemas
| Síntoma | Causa raíz | Solución |
|---|---|---|
| Falla al pulsar + Conectar servidor MCP | La URL SSE/HTTP no usa HTTPS o fallan las cabeceras de autenticación. | Verifica que el endpoint sea https:// público y las credenciales sean válidas. |
| Capitán no invoca la herramienta MCP | Descripción ambigua del tool o servidor desactivado. | Mejora el description en el servidor MCP y verifica su estado en Capitán → Servidores MCP. |
| Cliente externo no conecta a Ajustes > Servidor MCP | Token inválido o URL mal copiada en el cliente MCP. | Revisa los datos en Ajustes > Servidor MCP y actualiza el token. |
| No aparece el menú Servidor MCP | La cuenta no está en Plan Evolución. | Actualiza tu plan en panel.waclis.com. |
Preguntas frecuentes
¿Cuál es la diferencia entre Ajustes > Servidor MCP y Capitán > Servidores MCP (Beta)?
En Ajustes > Servidor MCP, Waclis Inbox expone sus herramientas para que una IA externa opere tu cuenta. En Capitán > Servidores MCP (Beta) (Capitán → Servidores MCP), Capitán se conecta a un servidor MCP tuyo para usar tus herramientas al atender chats.
¿Qué datos permite gestionar Ajustes > Servidor MCP?
Permite consultar y operar conversaciones, mensajes, contactos, Kanban y Tareas bajo los permisos del usuario autenticado.
¿Cómo protejo la conexión entre Capitán y mi servidor MCP externo?
Al pulsar + Conectar servidor MCP en Capitán → Servidores MCP, defines cabeceras HTTP seguras (Authorization o X-API-Key).
¿Debo reconfigurar Capitán si sumo una herramienta nueva en mi servidor MCP?
No. Capitán descubre dinámicamente las herramientas publicadas por el servidor MCP.
Artículos relacionados
- Agente de IA Capitán: configuración de asistentes, base de conocimiento y traspaso humano
- Herramientas HTTP personalizadas y acciones externas en Capitán
- API REST de Cuenta y Client API: autenticación, tokens y endpoints principales
¿Necesitas más ayuda?
Si este artículo no resolvió tu consulta, nuestro equipo puede ayudarte personalmente.
Soporte por WhatsApp