Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die PostgreSQL-Erweiterung kann eine MCP-Serverdefinition (Model Context Protocol) in unterstützten KI-fähigen Hosts registrieren. Mit dieser Registrierung kann der Host PostgreSQL-Tools für verbindungsverwaltung, Schemasuche, Abfrageausführung und zugehörige Workflows entdecken, ohne Sie aufzufordern, jedes Tool manuell zu konfigurieren.
Verwenden Sie diese Seite, wenn Sie verstehen möchten, wie DIE MCP-Unterstützung in der Erweiterung funktioniert, welche Hosts heute unterstützt werden und welche Toolfamilien nach der Registrierung verfügbar werden.
Voraussetzungen
Bevor Sie sich auf den MCP-Server verlassen, stellen Sie sicher, dass Sie folgendes haben:
- Die PostgreSQL-Erweiterung wurde in Visual Studio Code oder Cursor installiert.
- Copilot/AI-Features, die in der Erweiterung aktiviert sind (
pgsql.copilot.enableisttrue). Die Einstellungs-ID behält daspgsql.copilot.*Präfix in beiden Editoren bei; die Bezeichnung wird als KI im Cursor angezeigt. - Mindestens ein gespeichertes Verbindungsprofil, wenn MCP-Tools schnell eine Verbindung mit einem Server herstellen sollen.
- Ein unterstützter Host, der eine MCP-Registrierungs-API verfügbar macht.
Verstehen, wie die MCP-Registrierung funktioniert
Die Erweiterung registriert den MCP-Server automatisch, wenn alle folgenden Werte zutreffen:
- Der Host macht eine unterstützte MCP-Registrierungs-API verfügbar.
- Die Erweiterung kann eine gültige MCP-Server-URL und ein Bearertoken aus dem Sprachdienst abrufen.
- Copilot Integration ist aktiviert.
Heute unterstützt der Codepfad explizit Folgendes:
- Visual Studio Code 1.102 und höher über die MCP-Serverdefinitionsanbieter-API
-
Cursor durch die MCP-API des Cursors
registerServer
In Visual Studio Code registriert die Erweiterung den Server als PostgreSQL MCP. In Cursor registriert er den Server als pgsql-mcp.
Important
Die Erweiterung bietet derzeit keinen manuellen Einrichtungsablauf per Kopieren und Einfügen für eigenständige Clients, bei denen Sie die MCP-URL und das Token selbst eingeben müssen. Wenn Ihr Client die Erkennung oder Registrierung auf Hostebene nicht unterstützt, verwenden Sie stattdessen die integrierten KI-Workflows der Erweiterung.
Vorbereiten von Verbindungsprofilen für MCP-Tools
Die meisten nützlichen MCP-Flüsse sind von gespeicherten Verbindungsinformationen abhängig.
- Öffnen Sie Verbindungen und Identität , und erstellen oder aktualisieren Sie die Verbindungsprofile, die der Host verwenden soll.
- Speichern Sie Anmeldeinformationen, bei denen Ihr Workflow sie benötigt.
- Stellen Sie sicher, dass Sie über die Erweiterung eine Verbindung mit der Zieldatenbank herstellen können, bevor Sie sich auf die MCP-basierte Automatisierung verlassen.
Dies ist wichtig, da verbindungsorientierte MCP-Tools das Zielprofil aus dem Verbindungsspeicher der Erweiterung ermitteln, statt aus einer separaten Datenbankkonfiguration im AI-Host.
Verwenden von MCP-Tools in einem unterstützten Host
Nachdem der Host den PostgreSQL MCP-Server entdeckt hat, kann er die Tooloberfläche aufrufen, die von der Erweiterung verfügbar gemacht wird.
| Toolfamilie | Wobei es hilft | Typische Verwendung |
|---|---|---|
| Verbindungsprofile auflisten | Entdecken gespeicherter Profile | Suchen des richtigen Profils vor dem Herstellen einer Verbindung |
| Herstellen einer Verbindung mit der PostgreSQL-Datenbank | Öffnen einer Datenbanksitzung aus einem gespeicherten Profil | Starten einer Aufgabe auf dem richtigen Server oder in der richtigen Datenbank |
| Datenbanken auflisten | Datenbanken auf dem verbundenen Server auflisten | Wechseln des Kontexts oder Überprüfen verfügbarer Datenbanken |
| Abrufen von Datenbankobjekten | Schemakontext abrufen | Identifizieren von Tabellen, Ansichten, Funktionen und anderen Objekten, bevor Sie Nachverfolgungsfragen stellen |
| Ausführen einer Abfrage | Ausführen von leseorientiertem SQL | Überprüfen von Daten oder Überprüfen von Annahmen |
| Datenbank ändern | Ausführen von Daten- oder Schemaänderungen | Anwenden von DDL oder DML in Workflows, die Schreibzugriff erfordern |
| Öffnen des SQL-Skripts | Erstellen eines Skripts zur Überprüfung | Von der Agentenausgabe zu einem von Menschen überprüften Workflow im Abfrage-Editor wechseln |
| Abfrageplan | Überprüfen zwischengespeicherter Plandaten | Performance-Workflows analysieren |
| Visualisieren des Datenbankschemas | Rendern einer Schemaansicht | Grundlegendes zu Beziehungen vor dem Schreiben oder Ändern von SQL |
| Dashboardkontext abrufen | Abrufen des aktiven Dashboardsitzungskontexts, einschließlich verfügbarer Metriken und Konfiguration | Ermitteln, welche Metriken verfügbar sind, bevor Metrikdaten angefordert werden |
| Dashboardmetrikdaten abrufen | Abrufen von zwischengespeicherten Zeitreihendaten aus einem geöffneten Serverdashboard | Analysieren von Serverleistungstrends ohne Ausführen von Liveabfragen |
Tip
Beginnen Sie für sicherere Workflows zunächst mit Erkennungstools wie Verbindungsprofile auflisten, Mit PostgreSQL-Datenbank verbinden und Datenbankobjekte abrufen, bevor Sie Abfragen ausführen oder Änderungen vornehmen.
Wählen Sie zwischen MCP und den integrierten KI-Umgebungen
Verwenden Sie den MCP-Server, wenn Ihr Host die MCP-Erkennung unterstützt und Sie möchten, dass die Erweiterung dort ihre PostgreSQL-Toolschnittstelle bereitstellt.
Verwenden Sie die integrierten Erweiterungsfunktionen in folgenden Fällen:
- Sie möchten direkt mit dem @pgsql Chatteilnehmer chatten (nur Visual Studio Code),
- Sie möchten eine mehrstufige Automatisierung im Agentmodus (Visual Studio Code und Cursor) oder
- Ihr aktueller Host macht die MCP-Registrierung der Erweiterung nicht automatisch sichtbar.
Beheben von Problemen mit der MCP-Verfügbarkeit
Der Host zeigt keinen PostgreSQL MCP-Server an.
Vergewissern Sie sich, dass Sie einen unterstützten Host ausführen und dass Copilot/AI-Integration in der Erweiterung aktiviert ist. Laden Sie das Fenster bei Bedarf neu, nachdem Sie sich angemeldet haben, oder ändern Sie Copilot/AI-Einstellungen.
Die Registrierung wird übersprungen.
Die Erweiterung überspringt die Registrierung, wenn sie keine verwendbare MCP-URL oder ein Token aus dem Sprachdienst abrufen kann. Überprüfen Sie die Erweiterungsausgabeprotokolle, wenn der Host den Server nach dem Erneutladen nie entdeckt.
Ein Tool kann keine Verbindung mit meiner Datenbank herstellen.
Stellen Sie sicher, dass das Zielverbindungsprofil vorhanden ist und dass die Erweiterung es direkt verwenden kann. MCP-Abläufe hängen von demselben Verbindungsspeicher und derselben Auflösung von Anmeldeinformationen ab wie der Rest der Erweiterung.
Ich benötige einen manuellen Endpunkt für einen anderen MCP-Client
Die Erweiterung stellt derzeit keinen benutzerseitigen manuellen Workflow für Endpunkte für eigenständige MCP-Clients bereit. Verwenden Sie einen unterstützten Host oder greifen Sie auf die integrierten KI-Erfahrungen zurück, die in diesem Dokumentsatz dokumentiert sind.