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
- Configurez l’environnement. Copiez
.env.exampledans.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. - 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.
- Lancez le reste de la pile Compose. Une fois la base préparée, démarrez les autres services du déploiement.
- 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
- Lancez le serveur MCP. Utilisez la commande
uvxdocumentée par NVIDIA, qui récupère le paquet dans le sous-répertoiremcpde son dépôt, et pointez-le vers l’application avecAUTO_ONTOLOGY_API_URL=http://localhost:3000. Dans cette architecture locale, l’application web utilise le port3000et le serveur MCP le port3003.
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 :
| Client | Fichier de configuration | Méthode | Point de terminaison |
| Cursor | ~/.cursor/mcp.json | Définir mcpServers.auto-ontology.url avec une URL HTTP directe | http://localhost:3003/mcp |
| Claude Desktop | claude_desktop_config.json | Utiliser npx avec mcp-remote dans les arguments | http://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 :
- Lancez
check_readinesspour repérer un blocage de compilation ou de connexion à la base. - Si le déploiement est prêt, utilisez
check_answerablepour vérifier si la couche sémantique peut traiter la question. - Appelez
ask_questionlorsque 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. - 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