NVIDIA Auto Ontology MCP lässt sich erst sinnvoll mit Cursor oder Claude Desktop verbinden, wenn eine Auto-Ontology-Instanz läuft, eine Datenbankverbindung besteht und die semantische Ebene kompiliert ist. Cursor erhält die MCP-Adresse direkt; Claude Desktop nutzt dafür npx und mcp-remote. NVIDIAs README und MCP-Dokumentation beschreiben die Einrichtung und die nötigen Bereitschaftsprüfungen.
Erst die Datenbank und die semantische Ebene bereitstellen, dann den Client verbinden: Eine erreichbare MCP-Adresse allein macht noch keine Datenabfrage möglich.
Was vor dem Start bereitstehen muss
Auto Ontology MCP ist ein HTTP-Client für die öffentliche Auto-Ontology-API. Die MCP-Komponente hält selbst weder Datenbankzugangsdaten noch Modellkonfigurationen; sie verbindet den Client mit einer Auto-Ontology-Bereitstellung. Für das dokumentierte Beispiel brauchst du Docker mit Compose v2, uv, einen NVIDIA-API-Schlüssel und die Microsoft-Beispieldatenbank Wide World Importers. NVIDIA führt die Voraussetzungen und den lokalen Aufbau im Repository auf.
Lege anhand der Datei .env.example eine .env-Datei an und trage die benötigten Werte ein. Dazu gehören der Modell-API-Schlüssel, ein langer AUTH_SECRET, APP_URL, POSTGRES_PASSWORD, CONNECTION_STRINGS, AUTO_ONTOLOGY_ADMIN_PASSWORD und PGADMIN_PASSWORD. Ersetze die Standardpasswörter vor dem Start: Der Compose-Aufbau stellt PostgreSQL, pgAdmin und die Webanwendung auf dem Host bereit.
Die Vorlage enthält außerdem API-Schlüssel-Einträge für einzelne Modellrollen. Du kannst diese Einträge ersetzen oder löschen und stattdessen den allgemeinen DEFAULT_MODELS_API_KEY verwenden.
Auto Ontology vorbereiten und den MCP-Endpunkt starten
Halte die Reihenfolge ein: Erst die Datenbank und die semantische Ebene bereitstellen, danach den MCP-Dienst starten. NVIDIA beschreibt den lokalen Webdienst auf Port 3000 und den MCP-Dienst auf Port 3003; die Client-Adresse lautet http://localhost:3003/mcp.
- Umgebung konfigurieren. Erstelle
.envaus.env.exampleund setze die benötigten Schlüssel, Passwörter,APP_URLund Datenbankverbindungswerte. So sind die Dienste vor dem Start konfiguriert. - PostgreSQL starten und Beispieldaten laden. Verwende für den dokumentierten Schnellstart die Wide-World-Importers-Datenbank und das Seed-Skript aus dem Projekt. Damit erhält Auto Ontology eine Datenquelle.
- Die übrigen Compose-Dienste starten. Öffne anschließend die lokale Webanwendung und melde dich mit dem Administratorkonto an.
- Semantische Kompilierung aktivieren. Wähle in der Webanwendung Settings → Semantic Compilation und warte, bis die Kompilierung abgeschlossen ist. Die semantische Ebene ordnet Geschäftsbegriffe den Datenbankfeldern und SQL-Attributen zu.
- Den MCP-Dienst starten. Führe das MCP-Paket mit
uvxaus demmcp-Unterverzeichnis des NVIDIA-Repositorys aus und setzeAUTO_ONTOLOGY_API_URL=http://localhost:3000. So verweist der Dienst auf die lokale Web-API. NVIDIA beschreibt den Start im Repository. - Den passenden MCP-Client konfigurieren. Trage die MCP-Adresse in Cursor oder Claude Desktop ein. Beide verwenden
http://localhost:3003/mcp, aber unterschiedliche Konfigurationsmethoden.
Eine Datenfrage kann erst beantwortet werden, wenn sowohl die semantische Ebene kompiliert ist als auch eine aktive Datenbankverbindung besteht. NVIDIAs MCP-Dokumentation beschreibt beide Bedingungen als Voraussetzungen.
Cursor oder Claude Desktop konfigurieren
Cursor bindet den HTTP-Endpunkt direkt ein. NVIDIA zeigt dafür den Eintrag mcpServers.auto-ontology.url in ~/.cursor/mcp.json. Claude Desktop startet dagegen npx mit mcp-remote und übergibt dieselbe MCP-Adresse als Argument. Die beiden Konfigurationsbeispiele stehen im NVIDIA-Repository.
| Client | Konfigurationsmethode | MCP-Adresse |
| Cursor | Direkte HTTP-URL unter mcpServers.auto-ontology.url in ~/.cursor/mcp.json | http://localhost:3003/mcp |
| Claude Desktop | command: npx; Argumente: mcp-remote und die MCP-Adresse | http://localhost:3003/mcp |
Für Cursor sieht der Eintrag in der Konfigurationsdatei so aus:
{
"mcpServers": {
"auto-ontology": {
"url": "http://localhost:3003/mcp"
}
}
}
Für Claude Desktop lautet das entsprechende Muster:
{
"mcpServers": {
"auto-ontology": {
"command": "npx",
"args": ["mcp-remote", "http://localhost:3003/mcp"]
}
}
}
Starte den jeweiligen Client nach der Änderung neu und melde dich an, wenn die Anmeldung erscheint. Zugangsdaten gehören nicht in die MCP-Konfiguration: Der Anmeldefluss läuft über Auto Ontology, und der Client verwaltet das dabei entstehende Token. Jeder Aufruf verwendet die Berechtigungen des angemeldeten Nutzers.
Anmeldung und fehlgeschlagene Fragen prüfen
Beginne bei einer Anfrage ohne brauchbares Ergebnis mit check_readiness. Das Werkzeug meldet, ob die Kompilierung oder eine aktive Datenbankverbindung fehlt. Eine Datenbank kann noch im Katalog erscheinen, obwohl ihre ursprüngliche Verbindung nicht mehr besteht; ein sichtbarer Katalogeintrag reicht daher nicht aus, damit SQL ausgeführt werden kann.
Wenn check_readiness keine Blocker meldet, prüfe mit check_answerable, ob die semantische Ebene die Frage abdecken kann. Löst sie einen Geschäftsbegriff nicht auf, hilft search_terms bei der Suche nach der passenden Terminologie. Erst danach sollte ask_question die Abfrage ausführen. Das Werkzeug gibt Antwort, SQL und Ergebniszeilen zurück; die Ausgabe ist auf 100 Zeilen begrenzt und kennzeichnet mit row_count und truncated, ob weitere Zeilen vorliegen. NVIDIA beschreibt insgesamt neun schreibgeschützte MCP-Werkzeuge; sie verändern weder Glossar noch Katalog oder zugrunde liegende Datenbanken. Details zu Werkzeugen und Diagnose nennt die MCP-Dokumentation.
Schlägt die Anmeldung fehl, prüfe den Endpunkt /.well-known/oauth-authorization-server deiner Bereitstellung. Für den beschriebenen Anmeldefluss sollte er eine erfolgreiche HTTP-Antwort mit Status 200 liefern. Eine ältere vorgefertigte Anwendungsversion kann diese Autorisierungsroute noch nicht bereitstellen.
Meldet der Client eine Abweichung der geschützten Ressourcenadresse, vergleiche die verwendete Host-Adresse genau: localhost und 127.0.0.1 sind unterschiedliche Schreibweisen. AUTO_ONTOLOGY_MCP_PUBLIC_URL muss der Adresse entsprechen, die der Client tatsächlich aufruft.
Ein 403 beim Lesen der Datenbankverbindungen bedeutet für Nutzer mit Viewer-Rolle nicht zwangsläufig, dass die Bereitstellung fehlerhaft ist: Der Zugriff auf diese Einstellung kann Administratoren vorbehalten sein.
Backend- und Ingestion-Ports privat halten
NVIDIA empfiehlt, Backend-Port 3001 und Ingestion-Port 3002 in einem privaten Netzwerk zu belassen. Das Backend vertraut einer Identität, die vom Frontend weitergeleitet wird; Ingestion-Vorgänge haben keine eigene Authentifizierung. Die MCP-Aufrufe folgen zugleich den Berechtigungen des angemeldeten Nutzers. NVIDIAs README beschreibt diese Netzwerkgrenze.