Server MCP

L'estensione PostgreSQL può registrare una definizione del server MCP (Model Context Protocol) negli host supportati abilitati per l'intelligenza artificiale. Tale registrazione consente all'host di individuare gli strumenti PostgreSQL per la gestione delle connessioni, l'esplorazione dello schema, l'esecuzione di query e i flussi di lavoro correlati senza chiedere di configurare ogni strumento a mano.

Usare questa pagina quando si vuole comprendere il funzionamento del supporto MCP nell'estensione, quali host sono attualmente supportati e quali famiglie di strumenti diventano disponibili dopo la registrazione.

Prerequisiti

Prima di basarsi sul server MCP, assicurarsi di disporre di:

  • L'estensione PostgreSQL installata in Visual Studio Code o Cursor.
  • Copilot/funzionalità di intelligenza artificiale abilitate nell'estensione (pgsql.copilot.enable è true). L'ID dell'impostazione mantiene il prefisso pgsql.copilot.* in entrambi gli editor; l'etichetta appare come AI in Cursor.
  • Almeno un profilo di connessione salvato se si vuole che gli strumenti MCP si connettano rapidamente a un server.
  • Host supportato che espone un'API di registrazione MCP.

Informazioni sul funzionamento della registrazione MCP

L'estensione registra automaticamente il server MCP quando sono soddisfatte tutte le condizioni seguenti:

  1. L'host espone un'API di registrazione MCP supportata.
  2. L'estensione può recuperare un URL valido del server MCP e un token bearer dal suo servizio linguistico.
  3. L'integrazione con Copilot è abilitata.

Attualmente, il percorso del codice supporta in modo esplicito:

  • Visual Studio Code 1.102 e versioni successive tramite l'API del provider di definizioni del server MCP
  • Cursor tramite l'API MCP di Cursor

In Visual Studio Code l'estensione registra il server come MCP PostgreSQL. In Cursore registra il server come pgsql-mcp.

Importante

L'estensione attualmente non espone un flusso di installazione manuale di copia e incolla per i client autonomi che prevedono di immettere manualmente l'URL e il token MCP. Se il client non supporta l'individuazione o la registrazione a livello di host, usare invece i flussi di lavoro di intelligenza artificiale predefiniti dell'estensione.

Preparare i profili di connessione per gli strumenti MCP

I flussi MCP più utili dipendono dalle informazioni di connessione salvate.

  1. Aprire Connessioni e identità e creare o aggiornare i profili di connessione che l'host deve usare.
  2. Salva le credenziali dove il flusso di lavoro lo richiede.
  3. Verificare che sia possibile connettersi al database di destinazione dall'estensione prima di basarsi sull'automazione basata su MCP.

Ciò è importante perché gli strumenti MCP basati sulla connessione determinano il profilo di destinazione dall'archivio delle connessioni dell'estensione anziché da una configurazione separata del database nell'host di intelligenza artificiale.

Usare gli strumenti MCP in un host supportato

Dopo che l'host rileva il server MCP PostgreSQL, può chiamare l'interfaccia dello strumento esposta dall'estensione.

Famiglia di strumenti A cosa serve Uso tipico
Elencare i profili di connessione Scopri i profili salvati Trovare il profilo corretto prima di connettersi
Connettersi al database PostgreSQL Aprire una sessione di database da un profilo salvato Avviare un'attività nel server o nel database destro
Elenco di database Enumerare i database nel server connesso Cambiare contesto o esaminare i database disponibili
Ottenere oggetti di database Recuperare il contesto dello schema Identificare tabelle, viste, funzioni e altri oggetti prima di porre domande di completamento
Eseguire una query Eseguire SQL orientato alla lettura Esaminare i dati o convalidare i presupposti
Modifica database Eseguire modifiche ai dati o allo schema Applicare DDL o DML nei flussi di lavoro che richiedono l'accesso in scrittura
Aprire lo script SQL Crea uno script da rivedere Passare dall'output dell'agente a un flusso dell'editor di query sottoposto a revisione umana
Piano di esecuzione della query Esaminare i dati del piano memorizzati nella cache Analizza i flussi di lavoro sulle prestazioni
Visualizzare lo schema del database Visualizzare una vista dello schema Comprendere le relazioni prima di scrivere o modificare SQL
Ottieni il contesto della dashboard Recuperare il contesto di sessione del dashboard attivo, incluse le metriche e la configurazione disponibili Individuare le metriche disponibili prima di richiedere i dati delle metriche
Ottenere i dati delle metriche del dashboard Recuperare i dati delle serie temporali memorizzati nella cache in batch da un dashboard del server aperto Analizzare le tendenze delle prestazioni del server senza eseguire query in tempo reale

Tip

Per i flussi di lavoro più sicuri, iniziare con gli strumenti di individuazione, ad esempio Elenca profili di connessione, Connetti al database PostgreSQL e Recupera oggetti di database prima di eseguire query o modifiche.

Scegliere tra MCP e le esperienze di intelligenza artificiale predefinite

Utilizzare il server MCP quando l'host supporta il rilevamento MCP e si desidera che l'estensione vi esponga il proprio set di strumenti PostgreSQL.

Usare le esperienze di estensione predefinite quando:

  • se vuoi chattare direttamente con il partecipante della chat @pgsql (solo in Visual Studio Code),
  • vuoi un'automazione in più fasi all'interno della modalità Agent (Visual Studio Code e Cursor), o
  • l'host corrente non visualizza automaticamente la registrazione MCP dell'estensione.

Risolvere i problemi della disponibilità di MCP

L'host non mostra un server MCP PostgreSQL

Verificare che sia in esecuzione un host supportato e che l'integrazione di Copilot/intelligenza artificiale sia abilitata nell'estensione. Se necessario, ricarica la finestra dopo aver effettuato l'accesso o aver modificato le impostazioni di Copilot/IA.

La registrazione viene saltata

L'estensione ignora la registrazione quando non riesce a recuperare un URL o un token MCP utilizzabile dal servizio di linguaggio. Controllare i log di output dell'estensione se l'host non individua mai il server dopo il ricaricamento.

Uno strumento non può connettersi al database

Verificare che il profilo di connessione di destinazione esista e che l'estensione possa usarla direttamente. I flussi MCP dipendono dallo stesso archivio delle connessioni e dalla stessa risoluzione delle credenziali utilizzata dal resto dell'estensione.

È necessario un endpoint manuale per un altro client MCP

L'estensione attualmente non fornisce un flusso di lavoro manuale per endpoint rivolto all'utente per i client MCP standalone. Usare un host supportato o, in alternativa, usare le esperienze di IA integrate documentate in questa documentazione.

Contenuti correlati

  • Last updated on