MCP
El MCP (Model Context Protocol) de Mind One expone control total de la plataforma como herramientas para agentes de IA. Esto significa que puedes consultar, crear, editar y aprobar datos maestros desde lenguaje natural — sin abrir la interfaz de Mind One.
Es la primera plataforma de gobierno del dato que se puede controlar desde un agente de IA de forma nativa.
Qué es el Model Context Protocol
El Model Context Protocol (MCP) es un estándar abierto desarrollado por Anthropic que permite a los agentes de IA interactuar con herramientas y datos externos de forma estructurada y segura. En lugar de que el agente tenga que navegar una interfaz o llamar a una API manualmente, el MCP expone las capacidades de Mind One como herramientas que el agente puede invocar directamente.
Mind One implementa un servidor MCP que expone todas las operaciones de la plataforma como herramientas disponibles para cualquier cliente compatible.
Clientes compatibles
| Cliente | Estado | Notas |
|---|---|---|
| Claude (Anthropic) | ✓ Probado | Claude Desktop y claude.ai con proyectos |
| Cursor | ✓ Compatible | Configuración estándar MCP |
| Windsurf | ✓ Compatible | Configuración estándar MCP |
| Cualquier cliente MCP | ✓ Compatible | Sigue la especificación estándar |
Instalación y configuración
Con Claude Desktop
Paso 1 — Abre la configuración de Claude Desktop:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Paso 2 — Añade la configuración del servidor MCP de Mind One:
{
"mcpServers": {
"mind-one": {
"command": "npx",
"args": ["-y", "@mind/mcp-server"],
"env": {
"MIND_ONE_API_KEY": "mk_tu_api_key_aqui"
}
}
}
}Paso 3 — Sustituye mk_tu_api_key_aqui por tu API Key de Mind One. Puedes generarla desde Configuración cuenta → API Keys.
Paso 4 — Reinicia Claude Desktop. El servidor MCP de Mind One aparecerá en la lista de herramientas disponibles.
Con Cursor o Windsurf
Añade la misma configuración en el fichero MCP de tu cliente. La estructura es idéntica a Claude Desktop.
Qué puedes hacer con el MCP
Consultas
- Listar workspaces, datagrids y datagroups disponibles
- Consultar registros de un datagrid con filtros
- Buscar un registro específico por campo
- Ver el estado de sincronización de un datagrid
- Consultar value lists y sus valores
Gestión de datos
- Crear nuevos registros en un datagrid
- Editar registros existentes
- Eliminar registros
- Importar múltiples registros de una vez
Workflow y aprobación
- Cambiar el estado de un datagrid de Draft a Approved
- Crear una nueva versión de un datagrid
- Consultar el historial de versiones
Estructura
- Crear workspaces y datagrids
- Gestionar value lists
- Consultar el schema de un workspace
Ejemplos de uso con Claude
Consultar datos:
“¿Cuántos clientes activos hay en el datagrid de Clientes maestro?”
Aprobar un datagrid:
“Aprueba el datagrid de Tarifas temporada verano 2025.”
Crear un registro:
“Añade un nuevo tipo de habitación al workspace de Productos hoteleros: Suite Junior, capacidad 2, vista mar.”
Auditoría:
“¿Quién fue el último en modificar el datagrid de Proveedores y cuándo?”
Gestión multi-workspace:
“Lista todos los datagrids en estado Draft de todos los workspaces y dime cuáles llevan más de 7 días sin aprobarse.”
Seguridad
El MCP de Mind One hereda el modelo de seguridad completo de la plataforma:
- Autenticación: el agente de IA actúa con los permisos de la API Key configurada. Si la API Key pertenece a un usuario con rol Contributor, el agente solo podrá hacer lo que un Contributor puede hacer.
- Aislamiento por tenant: el agente solo tiene acceso a los datos del tenant de la API Key. No puede acceder a datos de otros tenants.
- Auditoría: todas las operaciones realizadas por el agente quedan registradas en el historial de cambios con el identificador de la API Key.
- Rate limiting: las mismas limitaciones de rate que la API REST aplican al MCP.
Preguntas frecuentes
¿Qué pasa si el agente comete un error? Todas las operaciones quedan registradas en el historial de auditoría. Puedes ver exactamente qué hizo el agente, cuándo y con qué valores. Para operaciones críticas, usa el workflow de aprobación — el agente puede mover un datagrid a Draft pero necesita confirmación humana para aprobarlo si así lo configuras en tu proceso.
¿Puedo limitar qué puede hacer el agente? Sí. Asigna a la API Key del MCP el rol con los permisos mínimos necesarios. Por ejemplo, si quieres que el agente solo consulte datos, usa una API Key con rol Visor.
¿Funciona con cualquier modelo de IA? Funciona con cualquier cliente que implemente el estándar MCP. Claude, Cursor y Windsurf están probados. Otros clientes compatibles con MCP funcionarán sin configuración adicional.
¿El MCP tiene acceso a mis credenciales de data warehouse? No. El MCP accede a los datos de Mind One, no directamente al data warehouse. Las credenciales de Autosync están gestionadas de forma separada y no son accesibles a través del MCP.
Relacionado
- Documentación API — Acceso programático directo a Mind One vía REST.
- Conexiones — Sincronización automática con data warehouses vía Autosync.
- Usuarios y Roles — Gestión de permisos para API Keys del MCP.