Como conectar Postgres ao Claude (e fazer funcionar para sua equipe)

Conectar o Postgres ao Claude é fácil. Para uma pessoa. Mas quando você quer que toda a sua equipe consulte o mesmo banco de dados, as coisas desmoronam. Aqui está o que aprendi e construí para gerenciar isso.

A maneira rápida: MCP direto

A Anthropic publicou um servidor MCP Postgres de referência. Instale-o, aponte-o para o seu banco de dados e o Claude pode executar consultas em minutos.

// claude_desktop_config.json
{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://read_user:pass@host:5432/mydb"
      ]
    }
  }
}

Uma vez conectado, o Claude pode listar tabelas, inspecionar esquemas e executar SQL. Pergunte "quantos usuários se inscreveram esta semana?" e ele escreve a consulta, a executa e retorna a resposta. Rápido, gratuito e útil para um desenvolvedor solo explorando um esquema que já conhece.

Dica: adicione contexto com Projetos Claude
Você pode melhorar a precisão criando um Projeto Claude, adicionando notas sobre seu esquema (descrições de tabelas, definições de métricas, regras de negócios) e usando esse projeto ao consultar. Isso funciona bem para uma pessoa, mas o contexto vive na sua conta Claude e não é compartilhado com mais ninguém.

Importante: use uma réplica de leitura
Nunca aponte consultas analíticas para o seu primário de produção. Uma agregação lenta pode bloquear tabelas e afetar seu aplicativo. RDS, Supabase, Neon e a maioria dos provedores de Postgres hospedados oferecem réplicas de leitura.

Onde começa a quebrar

A conexão direta funciona para uma pessoa. Quando você tenta entregá-la a uma equipe, duas coisas quebram: confiabilidade e gerenciamento.

O problema da confiabilidade

Esquemas de Postgres em produção são bagunçados. Eles evoluem ao longo dos anos, com nomes de colunas abreviados, tabelas legadas e lógica de negócios implícita. O Claude vê isso:

-- O que o Claude vê
usr_acct (id, sts, crt_at, upd_at, tier_id, ref_src, acq_ch)
ord (id, usr_id, amt_gross, amt_net, disc_cd, sts, crt_at)
sub (id, usr_id, plan_id, mrr_cents, churn_at, cancel_rsn)

Sem contexto, o Claude adivinha. É sts um código de status ou uma string? O amt_net inclui impostos? Quais valores de sts significam "completado"? Duas pessoas perguntam "qual é nossa receita?" e obtêm dois números diferentes porque o Claude interpreta de maneira diferente cada vez.

O problema do contexto

Você pode contornar o esquema bagunçado adicionando notas em um Projeto Claude. Mas agora você está mantendo o contexto manualmente. Quando uma coluna é renomeada, uma tabela é adicionada ou uma definição de métrica muda, alguém precisa atualizar essas notas. E se seu colega de equipe tiver seu próprio projeto com suas próprias notas, você volta a ter respostas inconsistentes.

O problema de gerenciamento

• Todos gerenciam sua própria configuração. Cada pessoa edita um arquivo JSON em seu laptop com credenciais do banco de dados. Seu chefe de operações não está fazendo isso.
• Todos têm o mesmo acesso. Há uma string de conexão. Todos veem tudo. A menos que você crie usuários de banco de dados separados para cada pessoa, não há como restringir quem vê o quê.
• Credenciais vivem em laptops. Senhas de banco de dados em arquivos de configuração em texto simples. Sem como revogar acesso sem mudar a senha para todos.
• Mudar de provedores quebra tudo. Se você mudar de Supabase para Neon, ou de RDS para Railway, cada pessoa da equipe precisa atualizar sua configuração.
• Sem visibilidade. Sem registro de auditoria do que consultas foram executadas, quem perguntou o quê, ou se as respostas estavam corretas.

A maneira pronta para a equipe: Claude + ContextFlo

ContextFlo conecta-se ao seu banco de dados Postgres usando credenciais somente leitura. Ele escaneia seu esquema e gera automaticamente contexto: o que cada tabela e coluna realmente significa, como as tabelas se relacionam entre si e como as principais métricas devem ser calculadas.

Sua equipe ainda faz perguntas no Claude. A diferença é o que o Claude sabe. Aqui está como funciona: