Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
A extensão PostgreSQL pode registrar uma definição de servidor MCP (Protocolo de Contexto de Modelo) em hosts habilitados para IA com suporte. Esse registro permite que o host descubra as ferramentas do PostgreSQL para gerenciamento de conexões, exploração de esquema, execução de consulta e fluxos de trabalho relacionados sem solicitar que você configure cada ferramenta manualmente.
Use esta página quando quiser entender como o suporte ao MCP funciona na extensão, quais hosts têm suporte hoje e quais famílias de ferramentas ficam disponíveis após o registro.
Pré-requisitos
Antes de contar com o servidor MCP, verifique se você tem:
- A extensão PostgreSQL instalada em Visual Studio Code ou Cursor.
- Os recursos do Copilot/de IA habilitados na extensão (
pgsql.copilot.enableétrue). A ID de configuração mantém seupgsql.copilot.*prefixo em ambos os editores; o rótulo aparece como IA no Cursor. - Pelo menos um perfil de conexão salvo, se você quiser que as ferramentas MCP se conectem rapidamente a um servidor.
- Um host com suporte que expõe uma API de registro do MCP.
Entender como o registro do MCP funciona
A extensão registra o servidor MCP automaticamente quando todos os seguintes são verdadeiros:
- O host expõe uma API de registro MCP com suporte.
- A extensão pode recuperar uma URL de servidor MCP válida e um token de portador de seu serviço de idioma.
- A integração do Copilot está habilitada.
Hoje, o fluxo do código oferece suporte explícito a:
- Visual Studio Code 1.102 e posterior por meio da API do provedor de definição de servidor MCP
-
Cursor via a API MCP do Cursor
registerServer
Em Visual Studio Code, a extensão registra o servidor como POSTgreSQL MCP. No Cursor, ele registra o servidor como pgsql-mcp.
Importante
No momento, a extensão não expõe um fluxo de instalação manual de cópia e colagem para clientes autônomos que esperam que você insira a URL do MCP e o token por conta própria. Se o cliente não oferecer suporte à descoberta ou ao registro no nível do host, use os fluxos de trabalho internos de IA da extensão.
Preparar perfis de conexão para ferramentas MCP
Os fluxos MCP mais úteis dependem de informações de conexão armazenadas.
- Abra Conexões e identidade e crie ou atualize os perfis de conexão que você deseja que o host use.
- Salve as credenciais em que o fluxo de trabalho as requer.
- Verifique se você pode se conectar ao banco de dados de destino da extensão antes de contar com a automação baseada em MCP.
Isso é importante porque as ferramentas MCP baseadas em conexão determinam o perfil de destino com base no repositório de conexões da extensão, e não em uma configuração de banco de dados separada no host da IA.
Usar ferramentas MCP em um host com suporte
Depois que o host detectar o servidor MCP do PostgreSQL, ele poderá chamar a interface de ferramentas exposta pela extensão.
| Família de ferramentas | O que ele ajuda com | Uso típico |
|---|---|---|
| Listar perfis de conexão | Descobrir perfis salvos | Localizar o perfil certo antes de se conectar |
| Conectar-se ao Banco de Dados PostgreSQL | Abrir uma sessão de banco de dados de um perfil salvo | Iniciar uma tarefa no servidor ou banco de dados correto |
| Listar bancos de dados | Enumerar bancos de dados no servidor conectado | Alternar contexto ou inspecionar bancos de dados disponíveis |
| Obter objetos de banco de dados | Buscar contexto de esquema | Identificar tabelas, exibições, funções e outros objetos antes de fazer perguntas de acompanhamento |
| Executar uma consulta | Executar SQL voltado para leitura | Inspecionar dados ou validar suposições |
| Modificar banco de dados | Executar alterações de dados ou esquema | Aplicar DDL ou DML em fluxos de trabalho que exigem acesso de gravação |
| Abrir script SQL | Criar um script para revisão | Passar da saída do agente para um fluxo de editor de consultas com revisão humana |
| Plano de consulta | Inspecionar dados de plano armazenados em cache | Analisar fluxos de trabalho de desempenho |
| Visualizar esquema de banco de dados | Exibir uma visualização do esquema | Entender relações antes de escrever ou alterar o SQL |
| Obter contexto do painel | Recuperar o contexto da sessão do painel ativo, incluindo as métricas disponíveis e a configuração | Descobrir quais métricas estão disponíveis antes de solicitar dados de métrica |
| Obter dados de métrica do painel | Obter dados de série temporal em cache em lotes de um painel aberto do servidor | Analisar tendências de desempenho do servidor sem executar consultas ao vivo |
Dica
Para fluxos de trabalho mais seguros, comece com ferramentas de descoberta, como Perfis de Conexão de Lista, Conectar ao Banco de Dados PostgreSQL e Obter Objetos de Banco de Dados antes de executar consultas ou modificações.
Escolha entre o MCP e as experiências internas de IA
Use o servidor MCP quando o host der suporte à descoberta do MCP e você quiser que a extensão exponha sua superfície de ferramenta PostgreSQL lá.
Use as experiências de extensão integradas quando:
- você deseja conversar diretamente com o participante do chat @pgsql (somente Visual Studio Code),
- você deseja automação de várias etapas dentro do modo agente (Visual Studio Code e Cursor) ou
- o host que você está usando atualmente não expõe automaticamente o registro MCP da extensão.
Solucionar problemas de disponibilidade do MCP
O host não mostra um servidor MCP do PostgreSQL
Confirme se você está executando um host com suporte e se a integração Copilot/IA está habilitada na extensão. Se necessário, recarregue a janela depois de fazer login ou alterar as configurações do Copilot/da IA.
O registro é ignorado
A extensão não realiza o registro quando não consegue recuperar uma URL do MCP ou um token utilizável do serviço de linguagem. Verifique os logs de saída da extensão se, após recarregar, o host não detectar o servidor.
Uma ferramenta não pode se conectar ao meu banco de dados
Verifique se o perfil de conexão de destino existe e se a extensão pode usá-lo diretamente. Os fluxos de MCP dependem do mesmo repositório de conexões e da resolução de credenciais que o restante da extensão.
Preciso de um endpoint manual para outro cliente MCP
Atualmente, a extensão não oferece um fluxo de trabalho manual de endpoint visível ao usuário para clientes MCP autônomos. Use um host com suporte ou recue às experiências internas de IA documentadas neste conjunto de documentos.