Como Conectar PostgreSQL ao Claude Usando MCP

Conectar um banco de dados relacional a um agente de IA costumava significar escrever camadas de API personalizadas ou colar resultados de consultas manualmente no chat. Com o MCP, você adiciona um bloco de configuração JSON, e Claude pode consultar seu banco de dados PostgreSQL diretamente em uma conversa.

Este guia cobre os passos exatos para conectar o PostgreSQL ao Claude Desktop ou Cursor, explica a configuração em detalhes e compara suas opções entre os 227 servidores de banco de dados indexados no MCPFind.

O que é um servidor MCP para PostgreSQL?

Um servidor MCP PostgreSQL é um pequeno processo que fica entre seu cliente de IA e seu banco de dados. Ele traduz chamadas de ferramentas em linguagem natural de Claude em consultas SQL, executa-as contra sua instância Postgres e retorna os resultados de volta para a conversa.

O servidor é executado localmente em sua máquina usando o transporte MCP stdio. Claude não se conecta diretamente ao seu banco de dados. O fluxo é: Claude emite uma chamada de ferramenta, o servidor MCP a recebe, o servidor executa a consulta e o resultado retorna como uma resposta de ferramenta. Suas credenciais de banco de dados nunca saem da sua máquina.

A maioria dos servidores MCP PostgreSQL expõe um conjunto padrão de ferramentas: query, list_tables, describe_table, e às vezes execute para operações de escrita. Alguns adicionam introspecção de esquema e análise de plano de explicação.

Como conectar o Postgres com o MCP: Instalar e configurar

A opção mais amplamente utilizada é @modelcontextprotocol/server-postgres, disponível no npm. Você não precisa instalar nada globalmente. A flag npx -y na configuração abaixo baixa o pacote automaticamente na primeira execução.

Adicione o servidor à sua configuração do Claude Desktop em ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://YOUR_USER:YOUR_PASSWORD@localhost:5432/YOUR_DB"
      ]
    }
  }
}

Substitua YOUR_USER, YOUR_PASSWORD, e YOUR_DB por suas credenciais reais. Para um banco de dados em nuvem, substitua localhost:5432 pelo seu host e porta. Reinicie o Claude Desktop após salvar, e você deverá ver as ferramentas de banco de dados aparecerem na lista de ferramentas.

Para o Cursor, adicione o mesmo bloco ao .cursor/mcp.json na raiz do seu projeto.

Como o PostgreSQL se compara a outras opções de MCP de banco de dados?

O PostgreSQL é o banco de dados relacional mais comumente configurado em configurações MCP, mas nem sempre é a escolha certa. A categoria de bancos de dados no MCPFind indexa 227 servidores cobrindo tudo, desde SQLite até armazenamentos NoSQL distribuídos.

Supabase é o servidor de banco de dados mais estrelado em todo o diretório, com 2.556 estrelas no GitHub. Ele envolve o PostgreSQL com uma camada de API e autenticação gerenciada, o que torna a configuração mais rápida se você já estiver usando o Supabase em produção.

SQLite é a escolha certa para desenvolvimento local. O banco de dados é um único arquivo, não há processo de servidor para gerenciar, e vários servidores MCP o suportam com zero configuração além do caminho do arquivo. Para prototipar um fluxo de trabalho de agente sem um banco de dados de produção, o SQLite é o caminho mais rápido.

MySQL é uma alternativa sólida para equipes em infraestrutura MySQL existente. O ecossistema de servidores MCP o cobre, embora as ferramentas do PostgreSQL tendam a ser mais maduras e ativamente mantidas.

MongoDB e Redis têm seus próprios servidores dedicados para casos de uso de documentos e chave-valor. Se seu modelo de dados não se encaixa em tabelas relacionais, verifique a categoria de bancos de dados para encontrar a melhor opção antes de optar pelo Postgres.

O que Claude pode fazer uma vez conectado ao PostgreSQL?

Uma vez conectado, Claude pode executar consultas, inspecionar esquemas e raciocinar sobre seus dados como parte de uma conversa. Você não escreve SQL manualmente.

Pergunte "quais clientes se inscreveram na semana passada e não fizeram um pedido" e Claude irá construir a junção, executá-la e resumir os resultados. Pergunte "descreva a tabela de usuários" e Claude retornará colunas, tipos e restrições. Para configurações habilitadas para escrita, Claude pode inserir ou atualizar registros quando você aprovar a ação.

O limite prático é a complexidade da consulta. Claude é bom em consultas SELECT e JOIN diretas contra esquemas que ele inspecionou. Para migrações de múltiplas etapas ou agregações complexas, é útil fornecer o esquema antecipadamente pedindo a Claude para executar list_tables primeiro, para que ele tenha contexto antes de você fazer a pergunta substantiva.

Isso é um avanço em relação a colar dados no chat manualmente. Se seus dados estão em uma ferramenta como o Notion em vez de um banco de dados, veja nosso guia sobre conectando o Notion a agentes de IA. Se você é novo no MCP e deseja entender o protocolo completo antes de configurar seu primeiro servidor, leia o que é MCP primeiro. Para configuração específica do Cursor, veja como usar o MCP com o Cursor. Se você quiser ir mais longe e escrever seu próprio servidor MCP para um esquema de banco de dados personalizado, construir seu primeiro servidor MCP em Python orienta sobre todo o processo.

Perguntas Frequentes

Preciso de um servidor PostgreSQL em execução para usar um servidor MCP de banco de dados?

Sim. O servidor MCP é um conector, não um banco de dados em si. Você precisa de uma instância PostgreSQL acessível (local, hospedada na nuvem ou um serviço como o Supabase) e fornecer sua string de conexão na configuração.

O servidor MCP PostgreSQL pode modificar dados, ou é somente leitura?

A maioria dos servidores MCP PostgreSQL suporta operações de leitura e escrita. Você pode restringir o usuário do banco de dados para apenas SELECT se quiser que o agente consulte sem fazer alterações. Verifique a documentação do servidor específico para capacidades de escrita.

O servidor MCP exporá meu banco de dados inteiro ao Claude?

Apenas os esquemas e tabelas aos quais o usuário da string de conexão tem acesso são visíveis. Use um papel de banco de dados dedicado com permissões mínimas. Conceda acesso apenas às tabelas que o agente precisa.

Há um custo de latência para consultar o Postgres através do MCP em comparação a uma consulta direta?

Há uma pequena sobrecarga porque o agente constrói a consulta, o servidor MCP a executa e os resultados passam pela camada de transporte stdio. Para fluxos de trabalho interativos, isso é negligenciável, mas o processamento em lote é melhor tratado diretamente.