--- title: El servidor MCP description: "--- ## Introducción El **servidor MCP** (Model Context Protocol) de Kafinea permite a los clientes IA externos (Claude Desktop, Cursor, Windsurf, VS Code, JetBrains…) conectarse a la instancia ERP para consultar los datos mediante un protocolo estandarizado. Esta página describe…" url: "https://www.kafinea.com/es/documentacion/configuracion/el-servidor-mcp/" updated: "2026-04-13" category: Configuración --- # El servidor MCP --- ## Introducción El **servidor MCP** (Model Context Protocol) de Kafinea permite a los clientes IA externos (Claude Desktop, Cursor, Windsurf, VS Code, JetBrains…) conectarse a la instancia ERP para consultar los datos mediante un protocolo estandarizado. Esta página describe la arquitectura técnica, la seguridad y la configuración del servidor MCP para los administradores. --- ## 1. Arquitectura El servidor MCP de Kafinea está compuesto por varios componentes: | Componente | Función | | --- | --- | | Punto de entrada HTTP | Recepción de las solicitudes MCP (protocolo Streamable HTTP) | | Herramientas (Tools) | Funciones expuestas a los clientes IA (búsqueda, lectura, navegación) | | Recursos (Resources) | Datos de contexto consultables por el cliente IA | | Autenticación | Validación de las credenciales de usuario en cada solicitud | | Seguridad | Aplicación de los derechos de acceso y de los controles de seguridad | | Configuración | Parámetros de activación y de limitación del servidor | --- ## 2. Autenticación La autenticación se realiza mediante el encabezado HTTP `X-Kafinea-Credentials` con el formato: ``` X-Kafinea-Credentials: username:accesskey ``` - El **username** es el nombre de usuario de Kafinea - La **accesskey** es la clave de acceso del usuario (visible en Mis Preferencias) El servidor valida las credenciales y establece el contexto de usuario para la solicitud. --- ## 3. Seguridad ### Derechos de acceso Cada solicitud MCP se ejecuta en el contexto del usuario autenticado. Se respetan los derechos de acceso a los módulos, registros y campos. ### Controles de seguridad adicionales Además de los derechos de acceso de usuario, el servidor MCP aplica controles adicionales: - Validación de los parámetros de entrada - Filtrado de los módulos y campos sensibles - Protección contra las inyecciones ### Recomendaciones - Implemente el servidor MCP únicamente sobre conexiones HTTPS - No publique nunca las credenciales en un repositorio público - Supervise los registros de acceso para detectar usos anómalos - Utilice claves de acceso dedicadas para las integraciones MCP si es posible --- ## 4. Herramientas expuestas (Tools) Las herramientas expuestas por el servidor MCP permiten a los clientes IA: - **Buscar** registros en los módulos de Kafinea - **Leer** el detalle de un registro específico - **Navegar** las relaciones entre registros - **Listar** los módulos y campos disponibles Cada herramienta respeta los derechos de acceso del usuario conectado. --- ## 5. Recursos expuestos (Resources) Los recursos exponen datos de contexto que el cliente IA puede consultar: - Información sobre la instancia de Kafinea - Estructura de los módulos disponibles - Metadatos de los campos --- ## 6. Configuración La configuración del servidor MCP es gestionada por el administrador del servidor. Los parámetros incluyen: - Activación/desactivación del servidor - Lista de los módulos expuestos - Límites de solicitudes > **Nota:** Contacte con su administrador del servidor si desea modificar la lista de los módulos expuestos o los límites de solicitudes. --- ## 7. Activación El servidor MCP se activa mediante los feature flags de Kafinea. Para activarlo: 1. Verifique que el feature flag MCP esté activado en la configuración 2. Asegúrese de que el endpoint `mcp/index.php` sea accesible desde el exterior (o desde la red de los usuarios) 3. Informe a los usuarios de que pueden recuperar su configuración desde **Mis Preferencias > Configuración MCP** --- ## 8. Diagnóstico En caso de problema de conexión: 1. Verifique que el endpoint MCP sea accesible desde el puesto del usuario 2. Verifique las credenciales de usuario (username + accesskey válidos) 3. Verifique que el feature flag MCP esté activado 4. Consulte el Explorador de Agentes IA para identificar posibles errores --- ## FAQ **¿El servidor MCP es compatible con todos los clientes IA?** El servidor implementa el protocolo MCP estándar (Streamable HTTP). Cualquier cliente compatible con MCP puede conectarse a él. **¿Puedo limitar los módulos accesibles mediante MCP?** Sí, mediante los derechos de acceso de los perfiles de usuario en Kafinea. El administrador del servidor también puede restringir la lista de los módulos expuestos a nivel de la configuración del servidor. **¿Las solicitudes MCP se registran?** Sí, la actividad MCP puede consultarse desde el Explorador de Agentes IA en Kafinea. --- ## Referencias asociadas - [Conectar una IA externa (MCP)](/205_intelligence-artificielle/040_connecter-une-ia-externe-mcp.md) - [Los agentes IA](https://www.kafinea.com/es/documentation/configuracion/los-agentes-ia/)