Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Rozszerzenie PostgreSQL może zarejestrować definicję serwera protokołu MCP (Model Context Protocol) na obsługiwanych hostach obsługujących sztuczną inteligencję. Ta rejestracja umożliwia hostowi odnajdywanie narzędzi PostgreSQL na potrzeby zarządzania połączeniami, eksploracji schematu, wykonywania zapytań i powiązanych przepływów pracy bez konieczności ręcznego konfigurowania każdego narzędzia.
Użyj tej strony, aby dowiedzieć się, jak działa obsługa mcp w rozszerzeniu, jakie hosty są obecnie obsługiwane i które rodziny narzędzi stają się dostępne po rejestracji.
Wymagania wstępne
Przed rozpoczęciem korzystania z serwera MCP upewnij się, że masz następujące elementy:
- Rozszerzenie PostgreSQL zainstalowane w programie Visual Studio Code lub Cursor.
- Funkcje Copilot/AI są włączone w rozszerzeniu (
pgsql.copilot.enabletotrue). Identyfikator ustawienia zachowuje prefikspgsql.copilot.*w obu edytorach. Etykieta jest wyświetlana jako sztuczna inteligencja w kursorze. - Co najmniej jeden zapisany profil połączenia, jeśli chcesz, aby narzędzia MCP szybko nawiązały połączenie z serwerem.
- Obsługiwany host, który udostępnia interfejs API rejestracji MCP.
Dowiedz się, jak działa rejestracja MCP
Rozszerzenie automatycznie rejestruje serwer MCP, gdy wszystkie następujące elementy są spełnione:
- Host udostępnia obsługiwany interfejs API rejestracji MCP.
- Rozszerzenie może pobrać prawidłowy adres URL serwera MCP oraz token uwierzytelniający Bearer ze swojej usługi językowej.
- Integracja z Copilotem jest włączona.
Obecnie ścieżka kodu jawnie obsługuje:
- Visual Studio Code 1.102 i nowsze wersje za pośrednictwem interfejsu API dostawcy definicji serwera MCP
-
Cursor za pośrednictwem interfejsu API MCP Cursor
registerServer
W Visual Studio Code rozszerzenie rejestruje serwer jako McP PostgreSQL. W kursorze rejestruje serwer jako pgsql-mcp.
Ważna
Rozszerzenie nie udostępnia obecnie ręcznego procesu konfiguracji metodą kopiuj-wklej dla samodzielnych klientów, w których należy samodzielnie wprowadzić adres URL MCP i token. Jeśli aplikacja kliencka nie obsługuje wykrywania ani rejestracji na poziomie hosta, zamiast tego skorzystaj z wbudowanych obiegów pracy AI dostępnych w rozszerzeniu.
Przygotowywanie profilów połączeń dla narzędzi MCP
Najbardziej przydatne przepływy MCP zależą od zapisanych informacji o połączeniu.
- Otwórz Połączenia i tożsamość i utwórz lub zaktualizuj profile połączeń, których host ma używać.
- Zapisz poświadczenia tam, gdzie wymaga tego przepływ pracy.
- Przed rozpoczęciem korzystania z automatyzacji opartej na programie MCP sprawdź, czy możesz nawiązać połączenie z docelową bazą danych z rozszerzenia .
Ma to znaczenie, ponieważ narzędzia MCP zorientowane na połączenie rozpoznają profil docelowy z magazynu połączeń rozszerzenia, a nie z oddzielnej konfiguracji bazy danych na hoście sztucznej inteligencji.
Korzystanie z narzędzi MCP na obsługiwanym hoście
Gdy host wykryje serwer MCP PostgreSQL, może wywołać interfejs narzędzia udostępniany przez rozszerzenie.
| Rodzina narzędzi | W czym pomaga | Typowe użycie |
|---|---|---|
| Wyświetl listę profili połączeń | Odnajdywanie zapisanych profilów | Znajdź odpowiedni profil przed nawiązaniem połączenia |
| Nawiązywanie połączenia z bazą danych PostgreSQL | Otwieranie sesji bazy danych z zapisanego profilu | Uruchamianie zadania na odpowiednim serwerze lub bazie danych |
| Wyświetl listę baz danych | Wyliczanie baz danych na połączonym serwerze | Przełączanie kontekstu lub inspekcja dostępnych baz danych |
| Pobieranie obiektów bazy danych | Pobieranie kontekstu schematu | Zidentyfikuj tabele, widoki, funkcje i inne obiekty przed zadaniem kolejnych pytań |
| Uruchamianie zapytania | Wykonywanie kodu SQL zorientowanego na odczyt | Sprawdzanie danych lub weryfikowanie założeń |
| Modyfikowanie bazy danych | Wykonywanie zmian danych lub schematu | Stosowanie języka DDL lub DML w przepływach pracy wymagających dostępu do zapisu |
| Otwórz skrypt SQL | Tworzenie skryptu do przeglądu | Przejdź z wyników działania agenta do trybu edytora zapytań weryfikowanego przez człowieka |
| Plan zapytania | Inspekcja buforowanych danych planu | Analizować przepływy pracy związane z wydajnością |
| Wizualizowanie schematu bazy danych | Renderowanie widoku schematu | Omówienie relacji przed napisaniem lub zmianą języka SQL |
| Pobierz kontekst pulpitu nawigacyjnego | Pobierz kontekst aktywnej sesji pulpitu nawigacyjnego, w tym dostępne wskaźniki i konfigurację | Dowiedz się, które wskaźniki są dostępne, zanim zażądasz danych wskaźników |
| Pobierz dane wskaźników pulpitu nawigacyjnego | Pobierz partiami dane szeregów czasowych z pamięci podręcznej z panelu otwartego serwera | Analizowanie trendów wydajności serwera bez uruchamiania zapytań na żywo |
Wskazówka
Aby uzyskać bezpieczniejsze przepływy pracy, zacznij od narzędzi odnajdywania, takich jak profile połączeń listy, połącz się z bazą danych PostgreSQL i pobierz obiekty bazy danych przed uruchomieniem zapytań lub modyfikacji.
Wybór między MCP a wbudowanymi funkcjami AI
Użyj serwera MCP, gdy host obsługuje wykrywanie MCP i chcesz, aby rozszerzenie udostępniało tam swoje narzędzia PostgreSQL.
Użyj wbudowanych mechanizmów rozszerzeń, gdy:
- chcesz porozmawiać bezpośrednio z uczestnikiem czatu @pgsql (tylko Visual Studio Code),
- potrzebujesz wieloetapowej automatyzacji w Agent mode (Visual Studio Code i Cursor) lub
- Twój obecny host nie udostępnia automatycznie rejestracji MCP rozszerzenia.
Rozwiązywanie problemów z dostępnością MCP
Host nie pokazuje serwera MCP PostgreSQL
Upewnij się, że korzystasz z obsługiwanego hosta i że integracja Copilot/sztucznej inteligencji jest włączona w rozszerzeniu. W razie potrzeby załaduj ponownie okno po zalogowaniu się lub zmianie ustawień Copilot/sztucznej inteligencji.
Rejestracja została pominięta
Rozszerzenie pomija rejestrację, gdy nie może pobrać użytecznego adresu URL lub tokenu MCP z usługi językowej. Sprawdź logi wyjściowe rozszerzenia, jeśli host po ponownym załadowaniu nigdy nie wykryje serwera.
Narzędzie nie może nawiązać połączenia z moją bazą danych
Sprawdź, czy profil połączenia docelowego istnieje i czy rozszerzenie może używać go bezpośrednio. Przepływy MCP zależą od tego samego magazynu połączeń i rozpoznawania poświadczeń co reszta rozszerzenia.
Potrzebuję ręcznego punktu końcowego dla innego klienta MCP
Rozszerzenie obecnie nie udostępnia przeznaczonej dla użytkownika ręcznej procedury obsługi punktu końcowego dla samodzielnych klientów MCP. Użyj obsługiwanego hosta lub wróć do wbudowanych środowisk sztucznej inteligencji opisanych w tym zestawie dokumentacji.