Easy8

Interactúa con herramientas de Easy8 como issues y proyectos.

Documentación

Servidor MCP ¶

El servidor MCP de Easy8 permite que asistentes de IA como Claude, ChatGPT, Microsoft Copilot Studio o Cursor trabajen con tu Easy8. Un usuario conecta el asistente una vez, inicia sesión con su cuenta de Easy8 y luego pregunta:

"¿Qué tareas me están asignadas esta semana?"
"Crea una tarea en el proyecto Website para actualizar la página de precios y asígnala a Jane."
"Registra 2 horas en la tarea 1234 para ayer."
"Resume los comentarios y adjuntos de la tarea 1234."
"¿Cuál de mis oportunidades no tuvo actividad de ventas el mes pasado?"

El asistente actúa como el usuario que ha iniciado sesión: solo ve lo que ese usuario puede ver y solo cambia lo que ese usuario puede modificar. Herramientas enumera todo lo que puede hacer.

Configuración ¶

Un administrador hace esto una vez.

1. Activar MCP ¶

En Administración → Configuración → IA, marca Habilitar MCP y guarda.

La dirección del servidor es tu dirección de Easy8 seguida de /mcp, por ejemplo https://yourcompany.easy8.com/mcp.

2. Elegir cómo inician sesión los asistentes ¶

Método	Úsalo para	Dónde
Autorregistro	Asistentes que se conectan solo con la dirección del servidor, como Claude o Copilot Studio	Administración → Easy SSO → Aplicaciones que usan cuentas de Easy8 → Autorregistro de aplicaciones
Aplicación manual	Asistentes que piden un ID de cliente y un secreto	Administración → Easy SSO → Aplicaciones que usan cuentas de Easy8 → Agregar aplicación
Clave API	Scripts y herramientas de desarrollo que envían una cabecera en lugar de iniciar sesión, como Claude Code o Cursor	Mi perfil → Clave de acceso API de cada usuario; requiere que la API REST esté activada en Administración → Configuración → API

Autorregistro tiene tres modos:

Desactivado (predeterminado): los asistentes no pueden registrarse por sí mismos. Agrega cada uno como aplicación manual.
Se requiere aprobación: un asistente recién registrado espera a un administrador. Los administradores reciben un correo electrónico y el asistente aparece en Esperando aprobación con Aprobar y Rechazar.
Automático: cualquier asistente puede registrarse y conectar a las personas de inmediato. Úsalo solo cuando confíes en tu red.

Aplicación manual: haz clic en Agregar aplicación, introduce un nombre y el sitio web del asistente y guarda. La página de la aplicación muestra el ID de cliente y el Secreto de cliente para introducir en el asistente.

Con ambos métodos, cada usuario inicia sesión en Easy8 y confirma el acceso la primera vez que se conecta.

La Política de acceso de una aplicación limita lo que puede hacer, además de los permisos del usuario. Cámbiala en la página de la aplicación:

Política de acceso	Permite
Todo lectura/escritura, Todo solo lectura	MCP y API REST
MCP lectura/escritura, MCP solo lectura	Solo MCP
API lectura/escritura, API solo lectura	Solo API REST; MCP se rechaza

Conectar un asistente ¶

Agrega Easy8 al asistente como servidor MCP remoto con la dirección https://yourcompany.easy8.com/mcp. El asistente abre entonces la página de inicio de sesión de Easy8; inicia sesión y haz clic en Autorizar.

Claude (web y escritorio): Configuración → Conectores → Agregar conector personalizado. Para una aplicación manual, introduce su ID de cliente y su Secreto de cliente en Configuración avanzada.
Microsoft Copilot Studio: agrega el servidor MCP y elige OAuth 2.0 → Descubrimiento dinámico. Consulta la documentación de Microsoft.
Claude Code: claude mcp add --transport http easy8 https://yourcompany.easy8.com/mcp, luego inicia sesión con /mcp. Iniciar sesión requiere autorregistro. Sin él, usa una clave API: agrega --header "X-Easy8-API-Key: <your API key>".
Otros asistentes: las herramientas que piden una cabecera en lugar de iniciar sesión aceptan la clave API en la cabecera X-Easy8-API-Key.

Seguridad ¶

El asistente tiene los permisos del usuario que ha iniciado sesión, nunca más.
Una política de acceso de solo lectura o la Clave de acceso API de solo lectura de Mi perfil permite que el asistente lea sin cambiar nada.
Ninguna herramienta elimina tareas, proyectos, registros de tiempo o registros de CRM.
Los cambios se guardan en el historial bajo el nombre del usuario que los hizo a través del asistente.
Para aplicaciones con autorregistro, para desconectar a un usuario, abre la aplicación en Aplicaciones que usan cuentas de Easy8 y haz clic en Desconectar usuario. Desactivar o eliminar la aplicación desconecta a todos los que la usan.
Desactivar Habilitar MCP detiene todas las conexiones MCP a la vez. Las aplicaciones con una política de acceso Todo, la predeterminada, mantienen su acceso a la API REST hasta que las desactives. WebMCP tiene su propia configuración.
Las descripciones y comentarios escritos por otras personas pueden contener instrucciones destinadas a engañar a un asistente. Prefiere asistentes que pregunten antes de cambiar datos.

Solución de problemas ¶

Problema	Comprueba
El asistente no encuentra el servidor (HTTP 404)	Habilitar MCP está activado.
La conexión falla antes de que aparezca la página de inicio de sesión	El autorregistro no está en Desactivado, o agrega el asistente como aplicación manual.
El asistente dice que está esperando aprobación	Un administrador lo aprueba en Esperando aprobación.
HTTP 401 con una clave API	La clave es correcta y la API REST está activada en Administración → Configuración → API.
HTTP 403	La política de acceso de la aplicación es API lectura/escritura o API solo lectura, que rechaza MCP.
El asistente puede leer pero no cambiar datos	La política de acceso o la clave API es de solo lectura, o el usuario no tiene el permiso en Easy8.
Faltan herramientas de un módulo, como CRM	Tu Easy8 no incluye ese módulo.
El asistente no puede abrir adjuntos	El asistente descarga archivos de Easy8 para analizarlos. En Claude, activa la ejecución de código y permite el acceso de red a tu dirección de Easy8. Un inicio de sesión proxy frente a Easy8 debe permitir que la descarga del asistente pase.

Easy8 registra las solicitudes MCP en log/mcp.log, con el usuario, la herramienta y el motivo por el que se rechazó una solicitud. Un rechazo por la política de acceso (HTTP 403) solo está en log/production.log. En Docker, lee los registros con docker compose exec app tail -f log/mcp.log.

Volver arriba