Instalación del MCP

Esta página describe cómo poner en marcha el MCP de Anjana Data Platform: qué debe preparar la organización en la plataforma y en la red, cómo se configura el cliente de IA y cómo se autentica cada usuario. Para entender qué es el MCP y cómo funciona, consultar antes MCP.

Resumen del proceso

La instalación tiene dos partes con responsables distintos. La primera se realiza una sola vez por entorno; la segunda, una vez por usuario y cliente de IA.

Requisitos previos

• Versión de la plataforma, Anjana Data Platform 26.1 o posterior.

• Cliente de IA compatible con MCP, que admita servidores MCP remotos por HTTP con autenticación OAuth. Por ejemplo Claude (Claude Desktop, claude.ai o Claude Code), Visual Studio Code con GitHub Copilot o Cursor.

• Usuario de la plataforma, con acceso a la plataforma y con los roles necesarios para las operaciones que se quieran realizar.

• Conectividad, el equipo donde se ejecuta el cliente de IA debe alcanzar por HTTPS la URL pública del entorno, igual que alcanza https://<url_entorno>/login para acceder al Portal de Datos.

Paso 1. Habilitar el MCP en la plataforma

El MCP se distribuye como un componente más de la plataforma (adp-mcp). Su habilitación depende del tipo de despliegue:

Rutas que deben ser accesibles

El cliente de IA debe poder alcanzar, a través del dominio público del entorno, las siguientes rutas. Si delante de la plataforma hay un proxy inverso, un balanceador o un WAF, deben estar permitidas y redirigidas al servicio MCP:

Paso 2. Configurar el cliente de IA

La configuración consiste en declarar el servidor MCP en el cliente de IA apuntando a la URL del entorno. No es necesario configurar tokens, claves de API ni contraseñas: la autenticación se realiza en el paso siguiente.

Configuración genérica

La mayoría de clientes aceptan un bloque JSON como el siguiente, donde <url_entorno> se sustituye por el dominio del entorno de Anjana Data Platform:

{
  "mcpServers": {
    "anjana-data": {
      "type": "http",
      "url": "https://<url_entorno>/mcp"
    }
  }
}

Ejemplos por cliente

• Claude Code, desde el terminal: claude mcp add --transport http anjana-data https://<url_entorno>/mcp

• Claude Desktop y claude.ai, añadir un conector personalizado desde la configuración de conectores indicando la URL https://<url_entorno>/mcp.

• Visual Studio Code, en el fichero mcp.json del espacio de trabajo o del usuario, con la clave servers en lugar de mcpServers.

• Otros clientes, consultar su documentación sobre servidores MCP remotos por HTTP.

La ubicación exacta de estas opciones puede variar entre versiones de cada cliente.

Paso 3. Autenticarse

La primera vez que el cliente de IA se conecta al servidor MCP, inicia el flujo de autenticación OAuth 2.0 (Authorization Code con PKCE):

1. El cliente abre en el navegador la pantalla de inicio de sesión de Anjana Data Platform. En algunos clientes hay que activar antes el servidor; por ejemplo, en Claude Code con el comando /mcp.

2. El usuario inicia sesión con su cuenta de la plataforma, con el mismo usuario y contraseña que en el Portal de Datos o con el SSO configurado en la organización.

3. El navegador devuelve el control al cliente de IA, que queda conectado en nombre de ese usuario.

El usuario con el que se inicia sesión determina qué puede hacer el asistente. El MCP aplica exactamente los mismos roles y permisos que la plataforma, gestionados por Zeus. Si un usuario tiene varios perfiles, conviene elegir conscientemente con cuál se conecta.

Paso 4. Verificar la instalación

Con la sesión conectada, basta con pedir al asistente que describa el MCP. Por ejemplo:

Conecta al MCP de Anjana y lista todas sus capacidades y los roles con los que estoy autenticado.

La respuesta debe confirmar la conexión, enumerar las operaciones disponibles (búsqueda, detalle, linaje, catalogación, relaciones, DSAs y auditoría) e indicar los roles del usuario. Si los roles no son los esperados, conviene cerrar sesión y autenticarse con el usuario adecuado.

Resolución de problemas

Esta página está dirigida a administradores técnicos que habilitan el MCP en la plataforma, a equipos de seguridad y redes que deben exponer el servicio, y a usuarios que configuran su cliente de IA para trabajar con Anjana Data Platform.