Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Rozšíření PostgreSQL může v podporovaných hostitelských aplikacích s podporou AI zaregistrovat definici serveru MCP (Model Context Protocol). Tato registrace umožňuje hostiteli zjistit nástroje PostgreSQL pro správu připojení, zkoumání schématu, spouštění dotazů a související pracovní postupy, aniž byste museli konfigurovat každý nástroj ručně.
Na této stránce se dozvíte, jak podpora MCP v rozšíření funguje, jaké hostitele se dnes podporují a které rodiny nástrojů budou po registraci k dispozici.
Prerequisites
Než se budete spoléhat na server MCP, ujistěte se, že máte:
- Rozšíření PostgreSQL nainstalované v aplikaci Visual Studio Code nebo Cursor.
- Funkce Copilot/AI povolené v rozšíření (
pgsql.copilot.enablejetrue). ID nastavení uchovávápgsql.copilot.*předponu v obou editorech; popisek se zobrazí jako AI v kurzoru. - Alespoň jeden uložený profil připojení, pokud chcete, aby se nástroje MCP připojily k serveru rychle.
- Podporovaný hostitel, který zveřejňuje rozhraní API pro registraci MCP.
Vysvětlení fungování registrace MCP
Rozšíření zaregistruje server MCP automaticky, pokud jsou splněny všechny následující podmínky:
- Hostitel zveřejňuje podporované rozhraní API pro registraci MCP.
- Rozšíření může ze své jazykové služby získat platnou adresu URL serveru MCP a bearer token.
- Integrace Copilotu je povolená.
Dnes cesta kódu explicitně podporuje:
- Visual Studio Code 1.102 a novější prostřednictvím rozhraní API poskytovatele definic serveru MCP
-
Kurzor přes rozhraní API MCP kurzoru
registerServer
V Visual Studio Code rozšíření zaregistruje server jako PostgreSQL MCP. V kurzoru zaregistruje server jako pgsql-mcp.
Important
Rozšíření v současné době nenabízí ruční postup nastavení pomocí zkopírování a vložení pro samostatné klientské aplikace, které vyžadují, abyste sami zadali URL adresu MCP a token. Pokud váš klient nepodporuje zjišťování nebo registraci na úrovni hostitele, použijte místo toho integrované pracovní postupy AI rozšíření.
Příprava profilů připojení pro nástroje MCP
Nejužitečnější toky MCP závisí na uložených informacích o připojení.
- Otevřete Připojení a identitu a vytvořte nebo aktualizujte profily připojení, které má hostitel používat.
- Uložte přihlašovací údaje tam, kde je pracovní postup vyžaduje.
- Než budete spoléhat na automatizaci založenou na MCP, ověřte, že se můžete připojit k cílové databázi z rozšíření.
To je důležité, protože nástroje MCP s orientací na připojení určují cílový profil z úložiště připojení rozšíření, nikoli ze samostatné konfigurace databáze v hostiteli AI.
Použití nástrojů MCP v podporovaném hostiteli
Jakmile host objeví server PostgreSQL MCP, může volat rozhraní nástrojů zpřístupněné rozšířením.
| Řada nástrojů | S čím pomáhá | Typické použití |
|---|---|---|
| Výpis profilů připojení | Zjišťování uložených profilů | Vyhledání správného profilu před připojením |
| Připojení k databázi PostgreSQL | Otevření databázové relace z uloženého profilu | Spuštění úlohy na správném serveru nebo databázi |
| Výpis databází | Vytvoření výčtu databází na připojeném serveru | Přepnutí kontextu nebo kontrola dostupných databází |
| Získání databázových objektů | Načtení kontextu schématu | Identifikace tabulek, zobrazení, funkcí a dalších objektů před kladení následných otázek |
| Spuštění dotazu | Spuštění SQL orientovaného na čtení | Kontrola dat nebo ověření předpokladů |
| Upravit databázi | Provádění změn dat nebo schématu | Použití DDL nebo DML v pracovních postupech, které vyžadují přístup k zápisu |
| Otevření skriptu SQL | Vytvoření skriptu pro kontrolu | Přechod z výstupu agenta na tok editoru dotazů kontrolovaný člověkem |
| Plán dotazů | Kontrola dat plánu uložených v mezipaměti | Analyzujte pracovní postupy výkonu |
| Vizualizace schématu databáze | Vykreslení zobrazení schématu | Vysvětlení relací před zápisem nebo změnou SQL |
| Získat kontext panelu | Načíst kontext aktivní relace dashboardu, včetně dostupných metrik a konfigurace | Zjistěte, které metriky jsou k dispozici, než si vyžádáte data metrik. |
| Získání dat metrik řídicího panelu | Načtení dávkových dat časových řad uložených v mezipaměti z otevřeného řídicího panelu serveru | Analýza trendů výkonu serveru bez spouštění živých dotazů |
Tip
Pro bezpečnější pracovní postupy začněte nástroji zjišťování, jako jsou profily připojení k seznamu, připojení k databázi PostgreSQL a získání databázových objektů před spuštěním dotazů nebo úprav.
Volba mezi MCP a integrovanými prostředími AI
Server MCP použijte, když váš hostitel podporuje zjišťování MCP a chcete, aby rozšíření zpřístupnilo jeho plochu nástroje PostgreSQL.
Integrované prostředí rozšíření použijte v následujících případech:
- chcete chatovat přímo s účastníkem chatu @pgsql (pouze Visual Studio Code),
- Chcete provést vícekrokovou automatizaci v režimu agenta (Visual Studio Code a kurzor) nebo
- vaše aktuální hostitelské prostředí automaticky nezpřístupňuje registraci rozšíření MCP.
Řešení potíží s dostupností MCP
Hostitel nezobrazuje server PostgreSQL MCP.
Ověřte, že používáte podporovaného hostitele a že v rozšíření je povolená integrace Copilot/AI. V případě potřeby znovu načtěte okno po přihlášení nebo změňte nastavení Copilot/AI.
Registrace se přeskočí
Rozšíření přeskočí registraci, pokud ze jazykové služby nemůže získat použitelnou adresu URL MCP nebo token. Zkontrolujte protokoly výstupu rozšíření, pokud hostitel po opětovném načtení server nenajde.
Nástroj se nemůže připojit k databázi
Ověřte, že profil cílového připojení existuje a jestli ho rozšíření může používat přímo. Toky MCP závisejí na stejném úložišti připojení a mechanismu určování přihlašovacích údajů jako zbytek rozšíření.
Potřebuji ruční koncový bod pro jiného klienta MCP
Rozšíření v současnosti nenabízí pro samostatné klienty MCP ruční pracovní postup pro endpoint určený pro uživatele. Použijte podporovaného hostitele nebo se vraťte k integrovaným prostředím AI zdokumentovaným v této sadě dokumentace.