Conectar un agente de IA con el servidor MCP (Enterprise)

El servidor MCP permite que un agente de IA externo trabaje en tu centro de soporte con un token de bot de permisos limitados. Es un endpoint del Model Context Protocol, así que cualquier agente que hable MCP (por ejemplo, un bot de OpenClaw) puede leer conversaciones, responderlas, dejar notas privadas, redactar borradores de respuesta para que una persona los apruebe, gestionar contactos, iniciar conversaciones salientes y consultar una lista de eventos. Lo activas en Configuración, creas un token y le das a tu agente la URL de conexión. El servidor MCP es parte del plan Enterprise. Durante la prueba de 7 días con la que empieza cada cuenta nueva, un agente puede conectarse, pero solo responde whoami; todas las demás herramientas necesitan un plan Enterprise de pago.

¿Para qué sirve el servidor MCP?

Es el puente entre un agente de IA externo y Deskwoot. En lugar de crear tu propia integración con la API REST, conectas un cliente MCP y el agente recibe un conjunto definido de herramientas que puede usar. Es como darle a un bot una llave limitada y revocable para una parte concreta de tu bandeja de entrada, en lugar de entregarle tus datos de inicio de sesión. El agente actúa con una identidad de bot, así que sus mensajes y notas aparecen a nombre de ese bot, no de alguien de tu equipo.

¿Cómo activo el servidor MCP?

1. Ve a Configuración > Servidor MCP.
2. Activa el servidor MCP para tu espacio de trabajo.
3. Crea un token de bot. Ponle un nombre claro (por ejemplo Bot de clasificación OpenClaw) para reconocerlo después.
4. Elige los permisos que debe tener el token y limítalo a ciertas bandejas de entrada si el agente solo necesita trabajar en algunas.
5. Copia el token de inmediato. Por seguridad, es posible que no se vuelva a mostrar completo cuando salgas de la página.

¿Cuál es la URL de conexión?

Configura tu cliente MCP con esta dirección:

https://<your-host>/api/mcp

Reemplaza <your-host> por tu propio host de Deskwoot. Envía el token de bot como lo pida tu cliente MCP (por lo general, como token bearer en el encabezado de autorización). Cuando el cliente se conecte, el agente verá las herramientas que puede usar según los permisos del token.

¿Qué puede hacer un agente externo a través de MCP?

Un agente conectado, dentro de los permisos que le des, puede:

• Leer conversaciones y sus mensajes.
• Responder conversaciones.
• Agregar notas privadas que solo ve tu equipo.
• Crear borradores de respuesta que alguien de tu equipo revisa y envía.
• Leer, crear y actualizar contactos.
• Iniciar conversaciones salientes.
• Consultar una lista de eventos para reaccionar a la actividad nueva.
• Trabajar con tickets y tickets colectivos (ver más abajo).

Tickets y tickets colectivos

Los tickets vienen con Enterprise; un administrador puede desactivarlos en Configuración > Tickets. Un agente conectado también recibe herramientas para tickets. Para leer tickets basta el permiso Leer todo, y para cambiarlos se necesita Responder y gestionar conversaciones. Las herramientas siguen las mismas reglas que las pantallas de tickets de Deskwoot:

• Listar y leer tickets, con el hilo del ticket, la conversación de la que salió y sus incidencias de Jira, y listar tus categorías y estados de tickets.
• Crear un ticket a partir de los mensajes de una conversación, agregar comentarios internos y cambiar el estado, el responsable, el equipo, la categoría, la prioridad o el título de un ticket.
• Responder al cliente desde un ticket. La respuesta se envía en la conversación de la que salió el ticket. Un token en Modo solo borradores (supervisado) no puede hacerlo.
• Vincular una incidencia de Jira existente a un ticket, o desvincularla.
• Crear un ticket colectivo, vincularle conversaciones y tickets, desvincularlos y listar lo que está vinculado.

Dos cosas quedan en manos de las personas, en el panel: crear una nueva incidencia de Jira, porque se crea con la cuenta de Atlassian de una persona, y enviar la actualización de un ticket colectivo a todos los clientes vinculados. Un token limitado a algunas bandejas de entrada trabaja con los tickets cuya conversación está en esas bandejas, y solo un token con todas las bandejas puede crear un ticket colectivo o cambiar sus vínculos.

¿Qué no puede hacer?

El servidor MCP es limitado a propósito. No da acceso a la configuración de tu espacio de trabajo ni a la facturación, y no elimina nada. En concreto, un token de bot no puede cambiar ajustes ni configuración, tocar la facturación, eliminar registros, hacer envíos masivos ni gestionar webhooks. Si tu agente necesita hacer algo fuera de ese límite, el servidor MCP no lo hará, y es a propósito.

¿Cómo funcionan los permisos y los límites por bandeja de entrada?

Cada token tiene un conjunto de permisos que decide qué herramientas puede usar el agente. Da solo lo que el agente realmente necesita. Por ejemplo, un bot que redacta borradores para que una persona los apruebe no necesita permiso para enviar mensajes por su cuenta. Además de los permisos, puedes limitar un token a ciertas bandejas de entrada, así un agente que atiende tu bandeja de facturación nunca ve las conversaciones de otra. Si un token se filtra o dejas de usar un agente, revócalo en Configuración > Servidor MCP y el acceso desaparece al instante.

¿Qué planes incluyen el servidor MCP?

El servidor MCP es una función de Enterprise. Durante la prueba de 7 días puedes activarlo, crear un token y conectar un agente, pero solo responde whoami (confirma la conexión); todas las demás herramientas necesitan un plan Enterprise de pago. Si necesitas acceso desde código sin MCP, la API REST cubre los mismos datos y también es una función de Enterprise (los tokens de API necesitan un plan Enterprise de pago; la prueba no los incluye), y los tokens se gestionan en Configuración > Tokens de API.

Preguntas frecuentes