Artículo de ayuda · Waclis

Servidores MCP (Model Context Protocol) para conectar agentes de IA externos a Inbox

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

  1. Suscripción activa en Plan Evolución y rol de Administrador en Waclis Inbox.
  2. Para Ajustes > Servidor MCP: cliente compatible con MCP y tu token de autenticación de Waclis Inbox.
  3. 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

  1. En el menú lateral izquierdo, ingresa a Ajustes > Servidor MCP.
  2. Copia la URL del endpoint MCP y revisa los parámetros de conexión.
  3. Obtén tu credencial siguiendo las instrucciones de Ajustes > Servidor MCP.
  4. Registra el servidor en tu cliente MCP externo (Claude Desktop, Cursor u orquestador IA) con su URL y cabecera de autorización.
  5. 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)

  1. En el menú lateral izquierdo, abre Capitán y selecciona Servidores MCP (Beta) (Capitán → Servidores MCP).
  2. Haz clic en + Conectar servidor MCP arriba a la derecha.
  3. 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 ... o X-API-Key).
  1. 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 MCP son módulos nativos de Inbox.
  • Con el ecosistema Waclis (Waclis Connect y panel.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 en panel.waclis.com.

Buenas prácticas

Importante: Aplica mínimo privilegio en los Servidores MCP conectados a Capitán: Expón en Capitán → Servidores MCP únicamente herramientas seguras de consulta o acción autorizada, sin exponer operaciones destructivas.
Consejo: Cuida el 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

¿Necesitas más ayuda?

Si este artículo no resolvió tu consulta, nuestro equipo puede ayudarte personalmente.

Soporte por WhatsApp