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.

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

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 mindone-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. Cada usuario genera y gestiona sus propias claves desde Perfil → API Keys. La clave hereda tu rol, así que el agente actúa con tus permisos.

En claude.ai web el conector usa login con Mind One (OAuth) y no necesitas pegar la clave. El header Authorization: Bearer mk_... es una alternativa para clientes que se configuran a mano (Claude Desktop, Cursor, Windsurf).

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á al login de Mind One. Inicia sesión con tu cuenta (incluido Google SSO) y autoriza el acceso en la pantalla de consentimiento. El conector actuará como tú, con tu rol — no necesitas pegar ninguna API Key.

Claude Desktop — MCP local (npx)

{
  "mcpServers": {
    "mind-one": {
      "command": "npx",
      "args": ["-y", "mindone-mcp-server"],
      "env": {
        "MINDONE_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.

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

Grupos

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

Hojas

Herramienta	Descripción
`mindone_list_datagrids`	Lista todas las hojas
`mindone_get_datagrid`	Obtiene una hoja por ID
`mindone_search_datagrids`	Busca hojas por nombre
`mindone_create_datagrid`	Crea una nueva hoja
`mindone_update_datagrid`	Actualiza la metadata de una hoja
`mindone_update_datagrid_fields`	Reemplaza el schema de campos de una hoja
`mindone_insert_rows`	Inserta uno o varios registros (asíncrono — devuelve `jobId`)
`mindone_update_row`	Actualiza campos de un registro (asíncrono — devuelve `jobId`)
`mindone_replace_row`	Reemplaza un registro completo (asíncrono — devuelve `jobId`)
`mindone_patch_rows`	Añade, actualiza y elimina varios registros en una sola llamada síncrona
`mindone_replace_datagrid_data`	Reemplaza todos los registros de una hoja
`mindone_delete_datagrid`	Elimina una hoja

Listas válidas

Herramienta	Descripción
`mindone_list_value_lists`	Lista todas las listas válidas
`mindone_get_value_list`	Obtiene una lista válida por ID
`mindone_create_value_list`	Crea una nueva lista válida
`mindone_update_value_list`	Actualiza una lista válida

Jobs

Herramienta	Descripción
`mindone_get_job_status`	Consulta el estado de un job asíncrono
`mindone_wait_for_job`	Espera a que un job asíncrono termine (sondeo automático) y devuelve el resultado

Operaciones asíncronas

Las herramientas que modifican registros de una en una — mindone_insert_rows, mindone_update_row y mindone_replace_row — no se completan de forma inmediata. En lugar de devolver el resultado final, responden con un código 202 y un identificador de trabajo ({ "jobId": "..." }).

Para conocer el resultado real de la operación debes consultar el estado del job con mindone_get_job_status, pasándole ese jobId, hasta que status alcance un estado terminal:

queued — el job está en cola, esperando a ser procesado.
running — el job se está ejecutando.
succeeded — el job terminó correctamente (consulta el campo result).
failed — el job falló (consulta el campo error para ver el motivo).

No des por buena la operación con solo recibir el jobId: el trabajo aún puede estar en curso o fallar. El agente debe sondear mindone_get_job_status cada 1-2 segundos hasta obtener succeeded o failed antes de reportar el resultado.

Las operaciones en bloque mindone_patch_rows y mindone_replace_datagrid_data son síncronas: devuelven el resultado directamente y no requieren sondeo.

Ejemplos de uso con Claude

Consultar datos:

“¿Cuántos clientes activos hay en la hoja 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 una hoja:

“Mueve la hoja de Tarifas temporada verano 2025 a estado Approved.”

Auditoría:

“¿Quién fue el último en modificar la hoja de Proveedores y cuándo?”

Gestión multi-workspace:

“Lista todas las hojas 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 hojas — desde lenguaje natural.

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

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, grupos y hojas
Create	`/mindone-create`	Crea workspaces, grupos y hojas desde lenguaje natural
Import	`/mindone-import`	Inserta o reemplaza datos en una hoja
Search	`/mindone-search`	Busca hojas 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é hojas tengo?”
“Crea un workspace nuevo para el equipo de ingeniería con una hoja de tareas.”
“Encuentra todas las hojas relacionadas con facturas.”

Seguridad

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

Autenticación: la API Key pertenece a un usuario y el agente actúa con su rol. La API pública/MCP aplica ese rol: lectura para todos los roles; escritura de registros a partir de Contributor; creación y edición de estructura (hojas, grupos, workspaces, listas válidas) a partir de Modeller; acceso completo para Admin.
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.

Recomendamos usar una API Key dedicada para el MCP (revocable de forma independiente sin afectar a otras integraciones). Su alcance viene dado por el rol de tu usuario.

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í. El agente hereda el rol del usuario dueño de la API Key. Por ejemplo, si te conectas con un usuario con rol Data Viewer, el agente solo podrá consultar datos; con Contributor podrá además editar registros, pero no crear ni borrar estructura.

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

Conexiones Documentación API