Servidor MCP para asistentes de IA

IllusionDB también es un servidor MCP (Model Context Protocol): tu asistente de IA – Claude Code, Claude Desktop u otro cliente MCP – consulta los datos por sí mismo, los analiza y mantiene registros. Típico: «¿Qué proyectos están atrasados?», «Suma de horas por cliente en octubre» o «Marca todas las tareas del proyecto X como hechas».

El punto de acceso es POST /mcp de tu instancia (fuera de /api/v1, Streamable HTTP). En Ajustes → Mi cuenta la tarjeta Servidor MCP muestra la dirección con comandos listos; justo después de crear un token, ya aparece en ellos.

Configuración

Claude Code (una vez, en la carpeta del proyecto; con --scope user en todos los proyectos):

claude mcp add --transport http illusiondb https://db.example.com/mcp --header "Authorization: Bearer <TOKEN>"

Claude Desktop (Ajustes → Desarrollador → Editar configuración; necesita Node.js), después reinicia:

{
  "mcpServers": {
    "illusiondb": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://db.example.com/mcp", "--header", "Authorization: Bearer <TOKEN>"]
    }
  }
}

Herramientas

• Lectura (cualquier token): list_datasources, list_tables, get_table, query_records, get_record, list_views, distinct_values. query_records entiende los mismos filtros, ordenaciones, agrupaciones y resúmenes que GET /tables/{id}/records, p. ej. el árbol de filtros {"and":[{"col":"status","op":"eq","val":"open"}]}. Las tablas se pueden indicar por ID o por nombre (tasks, main.tasks, Demo/tasks).
• Cambios (tokens sin Solo lectura): create_record, update_record, add_link, remove_link.

Permisos

• El token actúa con los permisos de su cuenta: el rol y los permisos de tablas se aplican a cada herramienta – las tablas sin permiso de lectura no aparecen, escribir requiere permiso de escritura. Lo mejor es crear para el asistente una cuenta propia con exactamente los permisos necesarios.
• Un token de Solo lectura solo recibe las herramientas de lectura.
• A propósito no por MCP: eliminar registros, cambiar columnas, tablas o vistas, SQL, importaciones, fuentes de datos, scripts, webhooks, usuarios, grupos, tokens y ajustes.
• Solo tokens de API; las cookies de sesión, ?token= y el MASTER_TOKEN no cuentan aquí. Las solicitudes de otras páginas del navegador (Origin) se rechazan, como máximo 600 llamadas por token en 10 minutos. El servidor MCP también funciona sin interfaz de administración.

Privacidad

Lo que el asistente consulta llega a su proveedor de IA. Los registros pueden venir de usuarios o sistemas externos – el servidor indica al asistente que los trate como datos, no como instrucciones.