Para conectar NVIDIA Auto Ontology MCP con Cursor o Claude Desktop, primero necesitas un despliegue de Auto Ontology con una base de datos activa y la capa semántica compilada. Después, Cursor puede apuntar directamente al endpoint /mcp; Claude Desktop usa npx con mcp-remote. El servidor MCP es un cliente HTTP de la API pública de Auto Ontology, no una conexión autónoma a la base de datos. La documentación de NVIDIA detalla estos requisitos y las comprobaciones de disponibilidad.
Antes de depurar el cliente, comprueba que Auto Ontology ya puede responder por sí mismo: el endpoint MCP no sustituye a la conexión de base de datos ni a la compilación semántica.
Qué necesitas antes de conectar el cliente
La configuración de ejemplo de NVIDIA requiere Docker con Compose v2, uv, una clave de API de NVIDIA y la base de datos de muestra Wide World Importers, de Microsoft. También tendrás que preparar el archivo .env con los datos del modelo, la autenticación y la conexión a la base de datos.
Entre las variables del ejemplo están DEFAULT_MODELS_API_KEY, AUTH_SECRET, APP_URL, POSTGRES_PASSWORD, CONNECTION_STRINGS, AUTO_ONTOLOGY_ADMIN_PASSWORD y PGADMIN_PASSWORD. Puedes sustituir o eliminar las claves definidas para modelos concretos para que se use DEFAULT_MODELS_API_KEY. Cambia las contraseñas predeterminadas antes de iniciar los servicios: la configuración de Compose publica PostgreSQL, pgAdmin y la aplicación web en el host.
Prepara Auto Ontology y arranca el endpoint MCP
Sigue este orden para que el cliente no se conecte a un servicio cuya capa de datos todavía no está lista. NVIDIA describe el procedimiento en el README oficial de Auto Ontology.
- Configura el entorno. Clona el repositorio, copia
.env.examplea.envy completa las claves y contraseñas necesarias, incluida una clave larga paraAUTH_SECRET. Revisa también las credenciales de administrador y pgAdmin. - Inicia PostgreSQL y carga los datos de ejemplo. Usa el script de carga indicado por NVIDIA para Wide World Importers; así tendrás una base de datos a la que conectar la aplicación.
- Arranca el resto de la pila de Compose. La arquitectura local asigna el puerto
3000a la aplicación web y la puerta de enlace de la API,3001al backend,3002a la ingestión y compilación semántica,3003al servidor MCP y5432a PostgreSQL con pgvector. - Compila la capa semántica. Inicia sesión en la aplicación web con la cuenta de administrador y activa Settings → Semantic Compilation. La interfaz indica que ha terminado con el mensaje “Semantic compilation is ready”. Una consulta necesita tanto esta capa compilada como una conexión activa a la base de datos.
- Inicia el servidor MCP. Ejecuta con
uvxel paquete de la subcarpetamcpdel repositorio de NVIDIA y apuntaAUTO_ONTOLOGY_API_URLahttp://localhost:3000. El endpoint que configurarán los clientes eshttp://localhost:3003/mcp.
Configura Cursor o Claude Desktop
Los dos clientes usan el mismo endpoint, pero NVIDIA documenta un método distinto para cada uno:
| Cliente | Método de configuración | Ajuste del endpoint |
| Cursor | Añade mcpServers.auto-ontology a ~/.cursor/mcp.json y configura su campo url. | http://localhost:3003/mcp |
| Claude Desktop | En claude_desktop_config.json, configura command como npx y args con mcp-remote y la dirección del endpoint. | http://localhost:3003/mcp |
Guarda la configuración y reinicia el cliente. Cuando aparezca la solicitud, inicia sesión mediante Auto Ontology. No añadas credenciales a la configuración MCP: el cliente gestiona el token de acceso.
Comprueba el inicio de sesión y diagnostica las consultas
Las llamadas MCP se ejecutan con los permisos de la persona que ha iniciado sesión. Para aislar un fallo, comprueba primero que el despliegue está listo, después que la pregunta puede responderse con la semántica disponible y, por último, ejecuta la consulta.
- Ejecuta
check_readiness. El resultado señala si falta la compilación semántica o una conexión activa a la base de datos. Un catálogo con tablas no garantiza que la conexión de origen siga disponible para ejecutar SQL. - Comprueba la cobertura con
check_answerable. Si la instalación está lista pero la pregunta no se resuelve, usasearch_termspara localizar los términos del catálogo que corresponden al vocabulario de la consulta. - Lanza
ask_questioncuando las comprobaciones anteriores estén en orden. La herramienta devuelve una respuesta, el SQL y las filas obtenidas; limita los resultados a 100 filas e indica el recuento y si la salida se ha truncado.
Si el cliente no encuentra el inicio de sesión, comprueba que la dirección de Auto Ontology /.well-known/oauth-authorization-server responde con HTTP 200. Una imagen antigua ya compilada puede no incluir esa ruta. Si aparece un error de dirección del recurso protegido, comprueba que el nombre del host coincide en ambos lados: localhost y 127.0.0.1 no son intercambiables en esa configuración. AUTO_ONTOLOGY_MCP_PUBLIC_URL debe coincidir con la dirección que usa el cliente.
Un 403 de una cuenta viewer al consultar la configuración de conexiones puede deberse a que esa lectura está reservada por defecto al administrador; no implica por sí solo que la instalación o las credenciales estén mal. Auto Ontology MCP ofrece nueve herramientas de solo lectura: no modifica el glosario, el catálogo ni las bases de datos.
Mantén privados el backend y la ingestión
NVIDIA indica que los puertos 3001 y 3002 deben permanecer en una red privada. El backend confía en la identidad que reenvía la aplicación web, y las operaciones del servicio de ingestión no tienen autenticación independiente.