NVIDIA Auto Ontology MCP instellen begint bij de Auto Ontology-omgeving: een werkende databaseverbinding en een gecompileerde semantische laag zijn nodig voordat een vraag data kan opleveren. Daarna verbind je Cursor rechtstreeks met het MCP-eindpunt, of laat je Claude Desktop dat doen via mcp-remote. NVIDIA beschrijft beide configuraties en de werking van de MCP-server.
Een verbinding met de MCP-server is pas een bruikbare data-opstelling als ook de semantische laag en de database gereed zijn.
Wat je nodig hebt
Voor NVIDIA’s voorbeeldopstelling heb je Docker met Compose v2, uv, een NVIDIA API-sleutel en de voorbeelddatabase Wide World Importers van Microsoft nodig. De opstelling gebruikt Auto Ontology als laag tussen de database en de MCP-client. De MCP-server werkt als HTTP-client van de openbare Auto Ontology-API; hij bewaart zelf geen databasegegevens.
Kopieer .env.example naar .env en vul de benodigde instellingen in. Daaronder vallen DEFAULT_MODELS_API_KEY, AUTH_SECRET, APP_URL, POSTGRES_PASSWORD, CONNECTION_STRINGS, AUTO_ONTOLOGY_ADMIN_PASSWORD en PGADMIN_PASSWORD. Vervang de standaardwachtwoorden voordat je de diensten start: Docker Compose publiceert PostgreSQL, pgAdmin en de webapp op de host. API-sleutels per modelrol kun je vervangen of weghalen; zonder die afzonderlijke waarden valt de configuratie terug op DEFAULT_MODELS_API_KEY. De NVIDIA-repository bevat de quickstart en omgevingsinstellingen.
Auto Ontology voorbereiden en het MCP-eindpunt starten
Werk de stappen in deze volgorde af. De webapp en MCP-server hebben verschillende adressen: de webapp/API-gateway staat in de lokale opstelling op poort 3000, terwijl de MCP-server op poort 3003 bereikbaar is.
- Configureer
.env. Stel de API-sleutel,AUTH_SECRET,APP_URL, databaseverbinding en wachtwoorden in. Zo staan de benodigde toegangsgegevens klaar voordat de diensten starten. - Start PostgreSQL en laad de voorbeelddatabase. Gebruik hiervoor NVIDIA’s seed-script voor Wide World Importers. De voorbeeldomgeving heeft dan databasegegevens om mee te werken.
- Start de overige Compose-diensten. Daarmee komt de Auto Ontology-webapp beschikbaar.
- Meld je aan bij de webapp met het administratoraccount. Dit account gebruik je om de semantische compilatie in te stellen.
- Schakel semantische compilatie in. Open Settings → Semantic Compilation en wacht tot de status “Semantic compilation is ready” verschijnt. Deze semantische laag koppelt zakelijke begrippen aan de gegevens in de database.
- Start het MCP-pakket en wijs het naar de webapp. NVIDIA beschrijft installatie vanuit de
mcp-submap van de GitHub-repository metuvx --from ...; stel daarbijAUTO_ONTOLOGY_API_URL=http://localhost:3000in. Het MCP-adres voor clients ishttp://localhost:3003/mcp. - Voeg het MCP-adres toe aan je client. Gebruik de passende configuratie uit de tabel en sla het bestand op.
- Herstart de client en rond de aanmelding af. Cursor of Claude Desktop vraagt je vervolgens om aan te melden bij Auto Ontology.
| Client | Configuratie | MCP-eindpunt |
| Cursor | In ~/.cursor/mcp.json stel je mcpServers.auto-ontology.url in. | http://localhost:3003/mcp |
| Claude Desktop | In claude_desktop_config.json stel je command in op npx en gebruik je mcp-remote met het MCP-eindpunt als argument. | http://localhost:3003/mcp |
Cursor krijgt het HTTP-adres rechtstreeks in de configuratie. Claude Desktop start daarnaast mcp-remote via npx. De clientconfiguratie bevat geen inloggegevens: de aanmelding verloopt via Auto Ontology en de client beheert het toegangstoken. Iedere MCP-aanroep gebruikt de rechten van de aangemelde gebruiker. NVIDIA’s MCP-documentatie legt de aanmelding en autorisatie uit.
Een mislukte query gericht opsporen
Begin met check_readiness: die controleert of de semantische compilatie klaar is en of er een actieve databaseverbinding bestaat. Is de omgeving gereed, controleer dan met check_answerable of de vraag in de semantische laag te beantwoorden is. Gebruik daarna ask_question. Als de vraagtermen niet worden herkend, helpt search_terms om de gebruikte woordenschat te onderzoeken.
Een databasecatalogus die nog tabellen toont, bewijst op zichzelf niet dat de databaseverbinding nog actief is. Catalogusgegevens kunnen blijven staan nadat de oorspronkelijke verbinding is weggevallen. Ook kan een kijkersaccount een 403 krijgen bij het bekijken van databaseverbindingen omdat die instelling standaard alleen voor beheerders toegankelijk is; zo’n fout betekent dus niet automatisch dat de hele opstelling defect is.
Loopt het aanmelden vast, controleer dan of de lokale omgeving /.well-known/oauth-authorization-server aanbiedt. Voor de beschreven aanmeldroute verwacht NVIDIA daar een HTTP-status 200; een oudere, al gebouwde image kan die route missen. Krijg je een fout over het adres van een beveiligde resource, vergelijk dan de hostnaam in beide configuraties. localhost en 127.0.0.1 moeten overeenkomen; stel AUTO_ONTOLOGY_MCP_PUBLIC_URL in op het adres dat de client gebruikt.
De negen MCP-tools zijn alleen-lezen. ask_question retourneert een antwoord, SQL en rijen; de uitvoer is begrensd op 100 rijen en bevat velden voor row_count en truncated. NVIDIA documenteert deze functies en controles.
Houd backend- en ingestiepoorten privé
Laat poorten 3001 en 3002 op een privénetwerk staan. De backend vertrouwt op een identiteitsgegeven dat de frontend doorstuurt, terwijl de ingestiehandelingen geen eigen authenticatie hebben. De MCP-server bevat zelf geen databasegegevens, en de rechten van elke aanroep blijven gekoppeld aan de gebruiker die zich bij Auto Ontology heeft aangemeld. NVIDIA licht deze netwerkgrens toe in de repository.