Pour connecter NVIDIA Auto Ontology MCP à Cursor ou à Claude Desktop, préparez d’abord un déploiement Auto Ontology avec une base de données active et une couche sémantique compilée. Configurez ensuite le client avec le point de terminaison http://localhost:3003/mcp : Cursor utilise directement cette adresse, tandis que l’exemple de NVIDIA pour Claude Desktop passe par mcp-remote. README de NVIDIA · Documentation MCP de NVIDIA

MCP, pour Model Context Protocol, permet au client de communiquer avec le serveur. Celui-ci relaie les demandes vers l’API publique d’Auto Ontology : il ne remplace ni le déploiement ni la connexion à la base.

Préparer les dépendances et les identifiants

Le démarrage rapide de NVIDIA nécessite Docker avec Compose v2, uv, une clé API NVIDIA et la base d’exemple Wide World Importers. Dans le fichier .env, configurez notamment DEFAULT_MODELS_API_KEY, AUTH_SECRET, APP_URL, POSTGRES_PASSWORD, CONNECTION_STRINGS, AUTO_ONTOLOGY_ADMIN_PASSWORD et PGADMIN_PASSWORD. NVIDIA précise que les clés propres aux différents rôles de modèle peuvent être remplacées ou supprimées pour utiliser DEFAULT_MODELS_API_KEY. README de NVIDIA

Remplacez les mots de passe par défaut avant de démarrer les services. La configuration Compose expose PostgreSQL, pgAdmin et l’application web sur l’hôte ; conserver les mots de passe d’exemple laisserait ces services avec des identifiants prévisibles.

Démarrer Auto Ontology dans le bon ordre

  1. Configurez l’environnement. Copiez .env.example dans .env, puis définissez les clés API, le secret d’authentification, l’URL de l’application, la chaîne de connexion à la base et les mots de passe. Ces paramètres préparent les services et leur authentification.
  2. Démarrez PostgreSQL et chargez la base d’exemple. NVIDIA indique d’utiliser son script d’initialisation pour importer Wide World Importers, la base de ventes d’exemple de Microsoft.
  3. Lancez le reste de la pile Compose. Une fois la base préparée, démarrez les autres services du déploiement.
  4. Connectez-vous à l’application web et compilez la couche sémantique. Dans l’application, ouvrez Settings → Semantic Compilation et attendez le message « Semantic compilation is ready ». La couche sémantique relie les concepts métier aux données ; une réponse exploitable exige aussi une connexion active à la base. README de NVIDIA · Documentation MCP de NVIDIA
  5. Lancez le serveur MCP. Utilisez la commande uvx documentée par NVIDIA, qui récupère le paquet dans le sous-répertoire mcp de son dépôt, et pointez-le vers l’application avec AUTO_ONTOLOGY_API_URL=http://localhost:3000. Dans cette architecture locale, l’application web utilise le port 3000 et le serveur MCP le port 3003.
Avant de modifier la configuration de Cursor ou Claude Desktop, vérifiez que la compilation sémantique est prête et que la base est bien connectée : un serveur MCP joignable ne suffit pas à produire des réponses aux questions sur les données.

Configurer Cursor ou Claude Desktop

Les deux clients utilisent le même point de terminaison, mais pas la même méthode de configuration. NVIDIA donne ces exemples dans son README officiel :

ClientFichier de configurationMéthodePoint de terminaison
Cursor~/.cursor/mcp.jsonDéfinir mcpServers.auto-ontology.url avec une URL HTTP directehttp://localhost:3003/mcp
Claude Desktopclaude_desktop_config.jsonUtiliser npx avec mcp-remote dans les argumentshttp://localhost:3003/mcp

Pour Cursor, l’entrée à ajouter est de la forme "mcpServers": { "auto-ontology": { "url": "http://localhost:3003/mcp" } }. Pour Claude Desktop, l’exemple configure "command": "npx" et les arguments "mcp-remote" et "http://localhost:3003/mcp".

Après avoir modifié le fichier, redémarrez le client et terminez la connexion lorsqu’il vous la demande. L’authentification passe par Auto Ontology : les identifiants ne sont pas à inscrire dans la configuration MCP, et chaque appel utilise les permissions du compte connecté. Documentation MCP de NVIDIA

Diagnostiquer une connexion ou une requête qui échoue

Si le client ne trouve pas le service de connexion, NVIDIA recommande de vérifier la route /.well-known/oauth-authorization-server du déploiement. Le flux de connexion documenté attend une réponse HTTP 200 ; une ancienne image précompilée peut ne pas fournir cette route.

Une erreur de correspondance avec l’adresse de la ressource protégée peut venir de noms d’hôte différents, par exemple localhost et 127.0.0.1. Faites correspondre AUTO_ONTOLOGY_MCP_PUBLIC_URL à l’adresse réellement utilisée par le client. Documentation MCP de NVIDIA

Si une question échoue, procédez par étapes :

  1. Lancez check_readiness pour repérer un blocage de compilation ou de connexion à la base.
  2. Si le déploiement est prêt, utilisez check_answerable pour vérifier si la couche sémantique peut traiter la question.
  3. Appelez ask_question lorsque la question est prise en charge. L’outil renvoie une réponse, la requête SQL et les lignes obtenues ; le résultat est limité à 100 lignes.
  4. Si les termes ne correspondent pas au vocabulaire de la couche sémantique, essayez search_terms.

Un catalogue non vide ne garantit pas que les requêtes SQL peuvent s’exécuter : ses métadonnées peuvent subsister après la perte de la connexion à la base. De même, un compte viewer peut recevoir une erreur 403 en consultant les paramètres de connexion, car cette lecture est réservée aux administrateurs par défaut. Documentation MCP de NVIDIA

Garder les services sensibles sur un réseau privé

NVIDIA recommande de conserver les ports 3001 (backend) et 3002 (ingestion et compilation sémantique) sur un réseau privé. Le backend fait confiance à l’identité transmise par l’application web, tandis que les opérations du service d’ingestion n’ont pas d’authentification indépendante. Le serveur MCP n’héberge pas les identifiants de la base ; les appels suivent les permissions de la personne connectée. README de NVIDIA · Documentation MCP de NVIDIA