Ver categorías

Conectar una IA externa (MCP)

3 minutos

Introducción

El protocolo MCP (Model Context Protocol) permite conectar un cliente de IA externo (Claude Desktop, Cursor, Windsurf, VS Code, JetBrains…) directamente a tu instancia de Kafinea. De este modo, la IA externa puede consultar tus datos de ERP, ver registros y realizar búsquedas sin salir de tu herramienta de trabajo habitual.

1. ¿Qué es MCP? #

MCP es un protocolo estándar que permite a los clientes de IA conectarse a servidores de herramientas. Kafinea ofrece un servidor MCP que permite acceder a los datos del ERP de forma segura, respetando los derechos de acceso del usuario conectado.

2. Acceder a la página de configuración #

  1. Inicia sesión en Kafinea
  2. Accede a «Mis preferencias » (menú de usuario en la esquina superior derecha)
  3. Haga clic en el botón «Configuración de MCP (IA externa)»

La página muestra tus datos de identificación personales y las configuraciones JSON listas para copiar para cada cliente de IA compatible.

3. Tus datos de acceso #

La página de configuración muestra tres datos esenciales:

  • Punto de acceso (URL): la dirección del servidor MCP de tu instancia de Kafinea
  • Nombre de usuario: tu nombre de usuario de Kafinea
  • Clave de acceso: tu clave de acceso personal (Access Key)

Importante: Nunca compartas tu clave de acceso. Esta te permite acceder a tus datos de Kafinea con tus derechos de usuario.

4. Configurar tu cliente de IA #

Para cada cliente de IA, la página ofrece un bloque de configuración JSON listo para copiar. Haz clic en el botón «Copiar» situado junto al cliente deseado.

Claude Desktop #

  1. Abre Claude Desktop
  2. Ve a Ajustes → Desarrollador → Servidores MCP
  3. Pega la configuración JSON que has copiado en el archivo claude_desktop_config.json
  4. Reinicia Claude Desktop

Cursor #

  1. Abre Cursor
  2. Ve a Ajustes → MCP → Añadir servidor
  3. Selecciona el tipo JSON
  4. Pega la configuración copiada

Windsurf #

  1. Abre el archivo mcp_config.json de windsurf
  2. Pega la configuración copiada
  3. Reinicia Windsurf

VS Code / GitHub Copilot #

  1. Crea o abre el archivo .vscode/mcp.json en su proyecto
  2. O bien, accede a la configuración de usuario de VS Code
  3. Pega la configuración copiada

JetBrains (IntelliJ, PhpStorm, …) #

  1. Ve a Configuración → Herramientas → Asistente de IA → Servidores MCP
  2. Pega la configuración copiada

5. Comprobar la conexión #

Una vez realizada la configuración:

  1. Reinicie su cliente de IA si es necesario
  2. Haz una pregunta relacionada con los datos de Kafinea (por ejemplo: «Mostrar mis últimas facturas»)
  3. El cliente de IA debería poder consultar Kafinea y mostrar los resultados

6. Seguridad #

  • Cada usuario tiene su propia clave de acceso
  • Las consultas MCP respetan los derechos de acceso del usuario
  • Nunca publiques la configuración JSON en un repositorio público
  • Si tu clave de acceso se ha visto comprometida, genera una nueva desde «Mis preferencias»

Preguntas frecuentes n. º

Mi clave de acceso ha cambiado, ¿qué debo hacer?
Vuelve a la página de configuración de MCP y vuelve a copiar la configuración con la nueva clave.

El cliente IA no consigue conectarse a
Comprueba que la URL del punto de acceso sea correcta y que se pueda acceder a ella desde tu equipo. Comprueba también que tu administrador haya habilitado el servidor MCP.

¿A qué datos tiene acceso la IA externa?
Solo a los datos a los que tú tienes acceso en Kafinea, según tu perfil y tus derechos.

Referencias relacionadas #