Servidor MCP

A extensão PostgreSQL pode registar uma definição de servidor do Model Context Protocol (MCP) em hosts suportados por IA. Esse registo permite ao anfitrião descobrir ferramentas PostgreSQL para gestão de ligações, exploração de esquemas, execução de consultas e fluxos de trabalho relacionados, sem que precise de configurar cada ferramenta manualmente.

Use esta página quando quiser perceber como funciona o suporte MCP na extensão, que hosts são suportados atualmente e que famílias de ferramentas ficam disponíveis após o registo.

Pré-requisitos

Antes de confiar no servidor MCP, certifique-se de que tem:

  • A extensão PostgreSQL instalada no Visual Studio Code ou Cursor.
  • Funcionalidades do Copilot/IA ativadas na extensão (pgsql.copilot.enable é true). O ID de definição mantém o seu pgsql.copilot.* prefixo em ambos os editores; o rótulo aparece como AI no Cursor.
  • Pelo menos um perfil de ligação guardado se quiseres que as ferramentas MCP se liguem rapidamente a um servidor.
  • Um host suportado que expõe uma API de registo MCP.

Compreenda como funciona o registo MCP

A extensão regista automaticamente o servidor MCP quando todas as seguintes condições são verdadeiras:

  1. O host expõe uma API de registo MCP suportada.
  2. A extensão pode recuperar uma URL válida do servidor MCP e um token de portador do seu serviço de língua.
  3. A integração com o Copilot está ativada.

Atualmente, o fluxo de execução do código tem suporte explícito para:

  • Visual Studio Code 1.102 e posteriores através da API do fornecedor de definição de servidor MCP
  • Cursor através da API MCP do registerServer Cursor

No Visual Studio Code, a extensão regista o servidor como PostgreSQL MCP. No Cursor, regista o servidor como pgsql-mcp.

Importante

Atualmente, a extensão não disponibiliza um processo manual de configuração por copiar e colar para clientes independentes que exijam a introdução manual do URL do MCP e do token. Se o seu cliente não suportar a descoberta ou registo ao nível do host, use antes os fluxos de trabalho de IA integrados na extensão.

Preparar perfis de ligação para ferramentas MCP

A maioria dos fluxos MCP úteis depende da informação de ligação guardada.

  1. Abre Ligações e Identidade e cria ou atualiza os perfis de ligação que queres que o anfitrião use.
  2. Guarda as credenciais onde o teu fluxo de trabalho as exige.
  3. Verifique se consegue ligar-se à base de dados de destino a partir da extensão antes de depender da automação baseada em MCP.

Isto é importante porque as ferramentas MCP baseadas em ligação resolvem o perfil de destino com base no armazenamento de ligações da extensão, e não numa configuração de base de dados separada no host de IA.

Use ferramentas MCP num host suportado

Depois de o host descobrir o servidor MCP do PostgreSQL, este pode chamar a interface da ferramenta exposta pela extensão.

Família de ferramentas Em que ajuda Uso típico
Listar Perfis de Ligação Descubra perfis guardados Encontre o perfil certo antes de se ligar
Liga-te à base de dados PostgreSQL Abra uma sessão de base de dados a partir de um perfil guardado Iniciar uma tarefa no servidor ou base de dados certo
Listar Bases de Dados Enumerar bases de dados no servidor ligado Muda de contexto ou inspeciona as bases de dados disponíveis
Obter Objetos de Base de Dados Obter contexto do esquema Identifique tabelas, vistas, funções e outros objetos antes de fazer perguntas de seguimento
Executar uma Consulta Executar SQL orientado à leitura Inspecionar dados ou validar pressupostos
Modificar a Base de Dados Executar alterações de dados ou de esquema Aplicar DDL ou DML em fluxos de trabalho que requerem acesso de escrita
Open SQL Script Crie um guião para revisão Passar da saída do agente para um fluxo de editor de consultas revisado por humanos
Plano de Consulta Inspecionar os dados do plano em cache Analisar fluxos de trabalho de desempenho
Visualizar o Esquema da Base de Dados Apresentar a vista do esquema Compreenda relações antes de escrever ou alterar SQL
Obter Contexto do Dashboard Recuperar o contexto ativo da sessão do dashboard, incluindo métricas e configurações disponíveis Descubra quais as métricas disponíveis antes de solicitar dados de métricas
Obter dados das métricas do painel Obter dados de séries temporais armazenados em cache em lotes a partir de um painel de controlo de servidor aberto Analise as tendências de desempenho dos servidores sem executar consultas em tempo real

Gorjeta

Para fluxos de trabalho mais seguros, comece com ferramentas de descoberta como Listar Perfis de Ligação, Ligar à Base de Dados PostgreSQL e Obter Objetos de Base de Dados antes de executar consultas ou modificações.

Escolha entre MCP e as experiências de IA incorporadas

Usa o servidor MCP quando o teu host suporta a descoberta MCP e queres que a extensão exponha a superfície da ferramenta PostgreSQL aí.

Utilize as funcionalidades de extensão integradas quando:

  • Queres conversar diretamente com o participante de chat @pgsql (apenas no Visual Studio Code),
  • queres automação em vários passos dentro do modo Agente (Visual Studio Code e Cursor), ou
  • O teu anfitrião atual não mostra automaticamente o registo MCP da extensão.

Resolver problemas de disponibilidade do MCP

O host não mostra um servidor MCP PostgreSQL

Confirma que estás a usar um host suportado e que a integração Copilot/AI está ativada na extensão. Se necessário, recarregue a janela depois de iniciar sessão ou altere as definições do Copilot/IA.

A inscrição é omitida

A extensão ignora o registo quando não consegue recuperar um URL ou token MCP utilizável do serviço de língua. Verifique os logs de saída da extensão se o host nunca descobrir o servidor após o reload.

Uma ferramenta não consegue ligar-se à minha base de dados

Verifique se o perfil de ligação alvo existe e se a extensão pode usá-lo diretamente. Os fluxos MCP dependem do mesmo armazenamento de ligação e resolução de credenciais que o resto da extensão.

Preciso de um endpoint manual para outro cliente MCP

Atualmente, a extensão não disponibiliza um fluxo de trabalho manual para o endpoint, voltado para o utilizador, para clientes MCP autónomos. Use um host suportado ou recorra às experiências de IA incorporadas documentadas neste conjunto de documentação.

Conteúdo relacionado

  • Last updated on