View Categories

Conectar una IA externa (MCP)

3 minutes

Introducción #

El protocolo MCP (Model Context Protocol) permite conectar un cliente de IA externo (Claude Desktop, Cursor, Windsurf, VS Code, JetBrains…) directamente a su instancia de Kafinea. La IA externa puede entonces consultar sus datos del ERP, ver registros y realizar búsquedas sin salir de su 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 expone un servidor MCP que da acceso 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. Inicie sesión en Kafinea
  2. Acceda a Mis Preferencias (menú de usuario en la parte superior derecha)
  3. Haga clic en el botón Configuración MCP (IA externa)

La página muestra sus credenciales personales y las configuraciones JSON listas para copiar para cada cliente de IA compatible.

3. Sus credenciales #

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

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

Importante: No comparta nunca su clave de acceso. Da acceso a sus datos de Kafinea con sus permisos de usuario.

4. Configurar su cliente de IA #

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

Claude Desktop #

  1. Abra Claude Desktop
  2. Acceda a Settings → Developer → MCP Servers
  3. Pegue la configuración JSON copiada en el archivo claude_desktop_config.json
  4. Reinicie Claude Desktop

Cursor #

  1. Abra Cursor
  2. Acceda a Settings → MCP → Add Server
  3. Elija el tipo JSON
  4. Pegue la configuración copiada

Windsurf #

  1. Abra el archivo mcp_config.json de Windsurf
  2. Pegue la configuración copiada
  3. Reinicie Windsurf

VS Code / GitHub Copilot #

  1. Cree o abra el archivo .vscode/mcp.json en su proyecto
  2. O acceda a los ajustes de usuario de VS Code
  3. Pegue la configuración copiada

JetBrains (IntelliJ, PhpStorm, …) #

  1. Acceda a Settings → Tools → AI Assistant → MCP Servers
  2. Pegue la configuración copiada

5. Probar la conexión #

Una vez aplicada la configuración:

  1. Reinicie su cliente de IA si es necesario
  2. Haga una pregunta que haga referencia a datos de Kafinea (por ejemplo: “Liste 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 solicitudes MCP respetan los derechos de acceso del usuario
  • No publique nunca la configuración JSON en un repositorio público
  • Si su clave de acceso se ve comprometida, genere una nueva desde Mis Preferencias

FAQ #

Mi clave de acceso ha cambiado, ¿qué debo hacer?
Vuelva a la página Configuración MCP y copie de nuevo la configuración con la nueva clave.

El cliente de IA no consigue conectarse
Compruebe que la URL del punto de acceso es correcta y accesible desde su equipo. Compruebe también que el servidor MCP está activado por su administrador.

¿Qué datos puede ver la IA externa?
Únicamente los datos a los que usted tiene acceso en Kafinea, según su perfil y sus permisos.

Referencias asociadas #