Neon MCP einrichten: Projekt, Branch und Leserechte

Bei Neon reicht die Frage nach dem richtigen Projekt nicht aus. Ein Projekt kann mehrere Branches enthalten, und derselbe Tabellenname kann in verschiedenen Branches vorkommen. Notieren Sie vor dem Start Projektkennung, Branch und Datenbank sowie einen erwarteten Testwert. Verwenden Sie eine Entwicklungsumgebung mit unkritischen Daten. Die hier beschriebenen Schritte sind ein eigener Prüfplan, kein Nachweis eines angemeldeten Kontotests.

Projektgrenze und Lesemodus setzen

Neon dokumentiert https://mcp.neon.tech/mcp als Remote-Endpunkt. Der Parameter readonly=true begrenzt den Werkzeugumfang auf Leseoperationen; projectId bindet den Zugriff an ein Projekt. Die OAuth-Freigabe übernimmt die bestätigten Grenzen. Wenn Sie den gewünschten Umfang ändern, prüfen Sie deshalb auch die erneute Autorisierung. Eine geänderte URL erweitert einen bereits ausgestellten Token nicht automatisch.

VS-Code-Beispiel für den Remote-Zugang

Ersetzen Sie YOUR_PROJECT_ID durch die Kennung Ihres Testprojekts. Fügen Sie den Eintrag in .vscode/mcp.json ein und starten Sie die Verbindung. Schließen Sie die Anmeldung mit dem vorgesehenen Konto ab und lesen Sie die angezeigte Freigabe. Das Beispiel braucht weder einen lokalen Paketstart noch einen Datenbankschlüssel in der Datei. Es nutzt den interaktiven OAuth-Weg.

{
  "servers": {
    "neon": {
      "type": "http",
      "url": "https://mcp.neon.tech/mcp?readonly=true&projectId=YOUR_PROJECT_ID"
    }
  }
}

Eine Projektkennung ist kein Passwort, gehört aber dennoch nur in die dafür vorgesehene Konfiguration. Kontrollieren Sie bei mehreren angemeldeten Konten die tatsächlich bestätigte Organisation. Die VS-Code-Anleitung erklärt die Dateiauswahl; der Read-only-Leitfaden ordnet die verschiedenen Berechtigungsebenen ein. Ein freigeschaltetes Lesewerkzeug sagt noch nicht, welcher Datenstand in seiner Antwort steckt.

Projekt und Branch am Ergebnis prüfen

1. Öffnen Sie das Testprojekt in Neon und notieren Sie Projekt, Branch, Datenbank sowie die erwartete Testtabelle. Prüfen Sie den Testwert unabhängig von MCP.

2. Kontrollieren Sie nach der Anmeldung die Verbindung und Werkzeugliste. Wählen Sie bei der Datenabfrage ausdrücklich den vorbereiteten Branch und die Datenbank.

3. Beginnen Sie mit der Tabellenstruktur. Lesen Sie anschließend wenige bekannte Felder mit einer begrenzten Abfrage und einer passenden Filterbedingung.

4. Vergleichen Sie den Wert mit Ihrer Notiz. Halten Sie den tatsächlich verwendeten Branch fest, bevor Sie einen weiteren Datenbereich erschließen.

Leere Ergebnisse und geänderte Freigaben

Wenn die erwartete Tabelle fehlt, prüfen Sie zuerst Branch, Datenbank und Schema. Legen Sie nicht sofort eine neue Tabelle an: Vielleicht wurde lediglich ein anderer Datenstand ausgewählt. Wenn schon die Anmeldung scheitert, kontrollieren Sie Konto und Freigabe vor der SQL-Abfrage. Für diese Trennung stehen der Fehler-Navigator und der Datenbank-Assistent bereit.

Nach einer Änderung der Verbindung wiederholen Sie denselben kleinen Test. Erweitern Sie den Umfang erst dann um zusätzliche Tabellen oder Berichte. Ein erfolgreicher Abruf ist keine Zusage über eine spätere Migration oder Branch-Erstellung; diese Vorgänge brauchen eine eigene Prüfung. Die Neon-Registersuche erschließt weitere Einträge. Über die App-Auswahl für Daten können Sie auch MongoDB, Supabase und lokale Dateizugänge vergleichen.

Ist projectId schon eine Branch-Auswahl?

Nein. Der Parameter begrenzt das Projekt. Prüfen Sie Branch und Datenbank zusätzlich beim konkreten Abruf.

Welcher Parameter aktiviert den Leseweg?

Neon dokumentiert readonly=true. Er begrenzt den Werkzeugumfang; Projekt und Datenstand müssen Sie zusätzlich festlegen.

Erweitert eine geänderte URL einen OAuth-Token?

Nicht automatisch. Prüfen Sie die bestätigte Freigabe und autorisieren Sie die Verbindung erneut, wenn sich der gewünschte Umfang ändert.

Brauche ich für dieses Beispiel npx?

Nein. Das Beispiel verwendet einen direkt angebundenen HTTP-Endpunkt mit OAuth.

Herstellerquellen geprüft am 2. Oktober 2026. Die Testabläufe sind redaktionelle Vorschläge.

1. Neon: MCP server, scopes and URL parameters
   Abrufbefehl anzeigen

   curl -s https://github.com/neondatabase/mcp-server-neon
2. Neon: Connect MCP clients
   Abrufbefehl anzeigen

   curl -s https://neon.com/docs/ai/connect-mcp-clients-to-neon

Alle Beiträge