Servidor MCP

El MCP (Model Context Protocol) de Mind One expone control total de la plataforma como herramientas para agentes de IA. 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.

info

El MCP de Mind One está disponible en todos los planes, incluyendo Free.

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 (claude.ai web)	✓ Probado	Via MCP remoto
Claude Desktop	✓ Probado	Via MCP remoto o local
Cursor	✓ Compatible	Configuración estándar MCP
Windsurf	✓ Compatible	Configuración estándar MCP
Cualquier cliente MCP	✓ Compatible	Sigue la especificación estándar

Modos de conexión

El MCP de Mind One soporta dos modos de conexión. En ambos casos las herramientas disponibles son idénticas.

Remoto (recomendado)

El servidor MCP está alojado en mcp.getmindapp.io. El cliente se conecta directamente a esa URL sin instalar nada. Es el modo más sencillo y el único que funciona en claude.ai web.

https://mcp.getmindapp.io/mcp

Local (npx)

El cliente ejecuta un proceso local que actúa como servidor MCP y llama a la API de Mind One. Requiere Node.js y acceso a internet para conectarse a la API.

npx -y @mind/mcp-server

Instalación y configuración

Claude Desktop — MCP remoto

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:

{
  "mcpServers": {
    "mind-one": {
      "url": "https://mcp.getmindapp.io/mcp",
      "headers": {
        "Authorization": "Bearer mk_tu_api_key_aqui"
      }
    }
  }
}

Paso 3 — Sustituye mk_tu_api_key_aqui por tu API Key. Puedes generarla desde Configuración cuenta → API Keys.

Paso 4 — Reinicia Claude Desktop.

claude.ai web — MCP remoto

Paso 1 — En claude.ai, ve a Personalizar → Conectores → Añadir Conector.

Paso 2 — Introduce la URL del servidor:

https://mcp.getmindapp.io/mcp

Paso 3 — Claude te redirigirá a la página de login OAUTH de para solicitarte la autenticación, introduce tu API Key de Mind One.

Claude Desktop — MCP local (npx)

{
  "mcpServers": {
    "mind-one": {
      "command": "npx",
      "args": ["-y", "@mind/mcp-server"],
      "env": {
        "MIND_ONE_API_KEY": "mk_tu_api_key_aqui"
      }
    }
  }
}

Cursor o Windsurf

Añade la configuración del modo remoto o local en el fichero MCP de tu cliente. La estructura es idéntica a Claude Desktop.

warning

Nunca compartas tu API Key ni la incluyas en código público. Usa variables de entorno o el gestor de secretos de tu sistema.

Herramientas disponibles

Las herramientas expuestas por el servidor MCP se corresponden con las operaciones de la API pública de Mind One.

Cuenta

Herramienta	Descripción
`mindone_get_account`	Devuelve información del tenant y usuario asociados a la API Key

Workspaces

Herramienta	Descripción
`mindone_list_workspaces`	Lista todos los workspaces del tenant
`mindone_get_workspace`	Obtiene un workspace por ID
`mindone_create_workspace`	Crea un nuevo workspace
`mindone_update_workspace`	Actualiza un workspace

Datagroups

Herramienta	Descripción
`mindone_list_datagroups`	Lista todos los datagroups
`mindone_get_datagroup`	Obtiene un datagroup por ID
`mindone_create_datagroup`	Crea un nuevo datagroup
`mindone_update_datagroup`	Actualiza un datagroup

Datagrids

Herramienta	Descripción
`mindone_list_datagrids`	Lista todos los datagrids
`mindone_get_datagrid`	Obtiene un datagrid por ID
`mindone_create_datagrid`	Crea un nuevo datagrid
`mindone_update_datagrid`	Actualiza un datagrid
`mindone_insert_rows`	Inserta uno o varios registros
`mindone_update_row`	Actualiza campos de un registro
`mindone_replace_row`	Reemplaza un registro completo

Value Lists

Herramienta	Descripción
`mindone_list_value_lists`	Lista todas las value lists
`mindone_get_value_list`	Obtiene una value list por ID
`mindone_create_value_list`	Crea una nueva value list
`mindone_update_value_list`	Actualiza una value list

Jobs

Herramienta	Descripción
`mindone_get_job_status`	Consulta el estado de un job asíncrono

Ejemplos de uso con Claude

Consultar datos:

“¿Cuántos clientes activos hay en el datagrid de Clientes maestro?”

Crear un registro:

“Añade un nuevo tipo de habitación al workspace de Productos hoteleros: Suite Junior, capacidad 2, vista mar.”

Aprobar un datagrid:

“Mueve el datagrid de Tarifas temporada verano 2025 a estado Approved.”

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.”

Skills para Claude Code

Además del servidor MCP, Mind One publica un conjunto de skills para Claude Code: instrucciones de alto nivel construidas sobre las herramientas MCP. En lugar de invocar las herramientas una a una, las skills guían a Claude paso a paso para completar tareas — explorar tu cuenta, crear estructuras de datos, importar registros o buscar datagrids — desde lenguaje natural.

Las skills siguen el estándar abierto Agent Skills, por lo que funcionan en cualquier herramienta de IA compatible.

info

Las skills requieren tener el servidor MCP de Mind One configurado. Sigue los pasos de Instalación y configuración de esta misma página antes de usarlas.

Requisitos

Claude Code v2.1 o superior
Servidor MCP de Mind One configurado (ver sección Instalación y configuración)

Instalación

El repositorio de skills está disponible en GitHub:

https://github.com/Mind-Analytics-SL/mind_one_mcp_skills

Opción 1 — Cargar al iniciar la sesión (sin copiar nada)

Clona el repositorio una vez y pásalo con --add-dir cada vez que inicies Claude Code:

git clone https://github.com/Mind-Analytics-SL/mind_one_mcp_skills ~/mind_one_mcp_skills
claude --add-dir ~/mind_one_mcp_skills

Para actualizar a la última versión, ejecuta git pull dentro de la carpeta clonada.

Opción 2 — Instalar de forma permanente

Clona y ejecuta el script de instalación para copiar las skills a ~/.claude/skills/, dejándolas disponibles en todas tus sesiones de Claude Code:

git clone https://github.com/Mind-Analytics-SL/mind_one_mcp_skills
cd mind_one_mcp_skills
./install.sh

Reinicia Claude Code después de instalar. Para actualizar, haz git pull y vuelve a ejecutar ./install.sh.

Skills disponibles

Skill	Comando	Descripción
Explore	`/mindone-explore`	Explora tus workspaces, datagroups y datagrids
Create	`/mindone-create`	Crea workspaces, datagroups y datagrids desde lenguaje natural
Import	`/mindone-import`	Inserta o reemplaza datos en un datagrid
Search	`/mindone-search`	Busca datagrids en todos tus workspaces

Uso

Invoca cualquier skill directamente con su comando:

/mindone-explore
/mindone-create un workspace para el equipo de ventas con un datagrid de contactos
/mindone-import pedidos en el datagrid Ventas Q1
/mindone-search cliente

O simplemente pregunta a Claude de forma natural — invocará la skill adecuada cuando sea relevante:

“¿Qué datagrids tengo?”
“Crea un workspace nuevo para el equipo de ingeniería con un datagrid de tareas.”
“Encuentra todos los datagrids relacionados con facturas.”

Seguridad

El MCP hereda el modelo de seguridad completo de la plataforma:

Autenticación: el agente 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.
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.

info

Recomendamos crear una API Key específica para el MCP con el rol mínimo necesario. Así puedes revocarla independientemente sin afectar a otras integraciones.

Preguntas frecuentes

¿Qué diferencia hay entre el modo remoto y el local? El resultado es idéntico — las mismas herramientas con el mismo comportamiento. La diferencia es dónde se ejecuta el servidor: en la infraestructura de Mind One (remoto) o en tu máquina (local). El modo remoto es más sencillo y funciona en claude.ai web. El modo local requiere Node.js pero no depende de la disponibilidad del servidor MCP.

¿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.

¿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

Skills para Claude Code — Repositorio de skills que automatizan tareas de Mind One desde Claude Code.
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.

Qué es Mind One

Datagroups

Servidor MCP

Qué es el Model Context Protocol link

Clientes compatibles link

Modos de conexión link

Remoto (recomendado) link

Local (npx) link

Instalación y configuración link

Claude Desktop — MCP remoto link

claude.ai web — MCP remoto link

Claude Desktop — MCP local (npx) link

Cursor o Windsurf link

Herramientas disponibles link

Cuenta link

Workspaces link

Datagroups link

Datagrids link

Value Lists link

Jobs link

Ejemplos de uso con Claude link

Skills para Claude Code link

Requisitos link

Instalación link

Skills disponibles link

Uso link

Seguridad link

Preguntas frecuentes link

Relacionado link

Qué es el Model Context Protocol

Clientes compatibles

Modos de conexión

Remoto (recomendado)

Local (npx)

Instalación y configuración

Claude Desktop — MCP remoto

claude.ai web — MCP remoto

Claude Desktop — MCP local (npx)

Cursor o Windsurf

Herramientas disponibles

Cuenta

Workspaces

Datagroups

Datagrids

Value Lists

Jobs

Ejemplos de uso con Claude

Skills para Claude Code

Requisitos

Instalación

Skills disponibles

Uso

Seguridad

Preguntas frecuentes

Relacionado