Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
De PostgreSQL-extensie kan een MCP-serverdefinitie (Model Context Protocol) registreren bij ondersteunde hosts met AI. Met deze registratie kan de host PostgreSQL-hulpprogramma's detecteren voor verbindingsbeheer, schemaverkenning, queryuitvoering en gerelateerde werkstromen zonder u te vragen om elk hulpprogramma handmatig te configureren.
Gebruik deze pagina als u wilt weten hoe MCP-ondersteuning werkt in de extensie, welke hosts vandaag worden ondersteund en welke hulpprogrammafamilies beschikbaar worden na registratie.
Prerequisites
Voordat u op de MCP-server vertrouwt, moet u het volgende doen:
- De in Visual Studio Code of Cursor geïnstalleerde PostgreSQL-extensie.
- Copilot/AI-functies ingeschakeld in de extensie (
pgsql.copilot.enableistrue). De instellings-id behoudt hetpgsql.copilot.*voorvoegsel in beide editors. Het label wordt weergegeven als AI in Cursor. - Ten minste één opgeslagen verbindingsprofiel als u wilt dat MCP-hulpprogramma's snel verbinding maken met een server.
- Een ondersteunde host die een MCP-registratie-API beschikbaar maakt.
Meer informatie over hoe MCP-registratie werkt
De extensie registreert de MCP-server automatisch wanneer aan alle volgende voorwaarden wordt voldaan:
- De host maakt een ondersteunde MCP-registratie-API beschikbaar.
- De extensie kan een geldige MCP-server-URL en bearer-token ophalen uit de taalservice.
- Copilot integratie is ingeschakeld.
Vandaag ondersteunt het codepad expliciet het volgende:
- Visual Studio Code 1.102 en hoger via de API van de MCP-serverdefinitieprovider
-
Cursor door de MCP-API van
registerServercursor
In Visual Studio Code registreert de extensie de server als PostgreSQL MCP. In Cursor wordt de server geregistreerd als pgsql-mcp.
Important
De extensie maakt momenteel geen handmatige installatiestroom voor kopiëren en plakken beschikbaar voor zelfstandige clients die verwachten dat u de MCP-URL en het token zelf invoert. Als uw client geen ondersteuning biedt voor detectie of registratie op hostniveau, gebruikt u in plaats daarvan de ingebouwde AI-werkstromen van de extensie.
Verbindingsprofielen voorbereiden voor MCP-hulpprogramma's
De meest nuttige MCP-stromen zijn afhankelijk van opgeslagen verbindingsgegevens.
- Open Verbindingen en identiteit en maak of werk de verbindingsprofielen bij die de host moet gebruiken.
- Sla referenties op waar uw werkstroom ze nodig heeft.
- Controleer of u vanuit de extensie verbinding kunt maken met de doeldatabase voordat u gebruikmaakt van automatisering op basis van MCP.
Dit is belangrijk omdat verbindingsgerichte MCP-hulpprogramma's het doelprofiel oplossen vanuit het verbindingsarchief van de extensie in plaats van vanuit een afzonderlijke databaseconfiguratie in de AI-host.
MCP-hulpprogramma's gebruiken in een ondersteunde host
Nadat de host de PostgreSQL MCP-server heeft ontdekt, kan deze de tools aanroepen die door de extensie beschikbaar worden gesteld.
| Toolfamilie | Waarbij het helpt | Typisch gebruik |
|---|---|---|
| Verbindingsprofielen weergeven | Opgeslagen profielen detecteren | Het juiste profiel zoeken voordat u verbinding maakt |
| Verbinding maken met PostgreSQL-database | Een databasesessie openen vanuit een opgeslagen profiel | Een taak starten op de juiste server of database |
| Databases weergeven | Databases opsommen op de verbonden server | Van context wisselen of beschikbare databases bekijken |
| Databaseobjecten ophalen | Schemacontext ophalen | Tabellen, weergaven, functies en andere objecten identificeren voordat u vervolgvragen stelt |
| Een query uitvoeren | Leesgerichte SQL uitvoeren | Gegevens controleren of veronderstellingen valideren |
| Database wijzigen | Gegevens- of schemawijzigingen uitvoeren | DDL of DML toepassen in werkstromen waarvoor schrijftoegang is vereist |
| SQL-script openen | Maak een script ter beoordeling | Ga van de output van de agent naar een door mensen beoordeelde queryeditorworkflow |
| Query Plan | Plangegevens in de cache controleren | Prestatiewerkstromen analyseren |
| Databaseschema visualiseren | Een schemaweergave weergeven | Relaties begrijpen voordat u SQL schrijft of wijzigt |
| Dashboardcontext ophalen | Actieve dashboardsessiecontext ophalen, inclusief beschikbare metrische gegevens en configuratie | Ontdekken welke metrische gegevens beschikbaar zijn voordat u metrische gegevens aanvraagt |
| Metrische dashboardgegevens ophalen | Tijdreeksgegevens in batches uit de cache ophalen vanaf een open serverdashboard | Trends in serverprestaties analyseren zonder livequery's uit te voeren |
Tip
Voor veiligere werkstromen begint u met detectiehulpprogramma's zoals Lijstverbindingsprofielen, verbinding maken met PostgreSQL-database en Databaseobjecten ophalen voordat u query's of wijzigingen uitvoert.
Kiezen tussen MCP en de ingebouwde AI-ervaringen
Gebruik de MCP-server wanneer uw host ONDERSTEUNING biedt voor MCP-detectie en u wilt dat de extensie het PostgreSQL-hulpprogramma daar beschikbaar maakt.
Gebruik de ingebouwde extensie-ervaringen wanneer:
- u rechtstreeks wilt chatten met de @pgsql chatdeelnemer (alleen Visual Studio Code),
- u wilt automatisering met meerdere stappen in de agentmodus (Visual Studio Code en Cursor) of
- uw huidige host maakt de MCP-registratie van de extensie niet automatisch zichtbaar.
Problemen met MCP-beschikbaarheid oplossen
De host toont geen PostgreSQL MCP-server
Controleer of u een ondersteunde host uitvoert en of Copilot/AI-integratie is ingeschakeld in de extensie. Laad het venster zo nodig opnieuw nadat u zich hebt aangemeld of Copilot/AI-instellingen hebt gewijzigd.
Registratie wordt overgeslagen
De extensie slaat de registratie over wanneer er geen bruikbare MCP-URL of -token kan worden opgehaald uit de taalservice. Controleer de uitvoerlogboeken van de extensie als de host de server nooit detecteert na het opnieuw laden.
Een hulpprogramma kan geen verbinding maken met mijn database
Controleer of het doelverbindingsprofiel bestaat en of de extensie het rechtstreeks kan gebruiken. MCP-flows zijn afhankelijk van dezelfde verbindingsopslag en afhandeling van referenties als de rest van de extensie.
Ik heb een handmatig eindpunt nodig voor een andere MCP-client
De extensie biedt momenteel geen gebruikersgerichte workflow voor een handmatig eindpunt voor zelfstandige MCP-clients. Gebruik een ondersteunde host of ga terug naar de ingebouwde AI-ervaringen die in deze documentenset worden beschreven.