🐘 MCP Postgres (Acesso Direto ao Banco)
O MCP Postgres permite que o Claude execute queries SQL diretamente no seu banco de dados PostgreSQL. Isso significa que voce pode pedir ao Claude para verificar dados, explorar schemas, debugar problemas e ate popular tabelas de teste - tudo sem sair do terminal.
🎯 Conceito Principal
- •Queries ao vivo: SELECT, INSERT, UPDATE, DELETE - o Claude executa SQL real no banco
- •Schema inspection: O Claude pode listar tabelas, colunas, tipos e relacionamentos
- •Token impact moderado: Resultados de queries consomem tokens - use LIMIT sempre
- •Conexao direta: Via connection string PostgreSQL padrao
💡 Dica Pratica
O caso de uso mais valioso no dia a dia e debug de dados: "Por que o usuario X nao consegue logar? Verifique a tabela users e sessions". O Claude roda as queries, analisa os resultados e identifica o problema.
⚙️ Instalando Postgres MCP
A instalacao requer a connection string do seu banco PostgreSQL. Essa string contem host, porta, usuario, senha e nome do banco.
🎯 Conceito Principal
Substitua os parametros pela sua connection string real. Para bancos remotos, use o host e porta corretos. Para bancos locais, geralmente e localhost:5432.
💡 Dica Pratica
Use uma variavel de ambiente para a connection string em vez de colocar a senha direto no comando: export DATABASE_URL=postgresql://... e depois referencie $DATABASE_URL no comando.
⚡ MCP Supabase (Managed Database)
Se voce usa Supabase como backend, o MCP Supabase oferece integracao nativa com todas as features do Supabase - nao so o banco, mas tambem auth, storage e edge functions.
🎯 Conceito Principal
- •Supabase = Postgres + extras: Auth, Storage, Realtime, Edge Functions
- •API nativa: Usa a API do Supabase em vez de SQL direto
- •Mais seguro: Respeita Row Level Security (RLS) policies
💡 Dica Pratica
Se voce tem Supabase, prefira o MCP Supabase ao Postgres puro. Voce ganha acesso ao ecossistema completo e as queries respeitam as policies de seguranca configuradas no dashboard.
⚙️ Instalando Supabase MCP
A instalacao do Supabase MCP requer a URL do projeto e a anon key (ou service role key para acesso administrativo).
🎯 Conceito Principal
Encontre a URL e a key no dashboard do Supabase: Settings > API. Use a anon key para acesso limitado (recomendado) ou a service_role key para acesso total.
💡 Dica Pratica
Nunca use a service_role key em producao com Claude. Ela bypassa todas as policies de seguranca. Use a anon key e configure RLS adequadamente. Para desenvolvimento local, service_role e aceitavel.
🔍 Casos de Uso (Debug, Migrations, Schema, Seed)
Ter acesso direto ao banco via Claude desbloqueia cenarios que economizam horas de trabalho manual. Aqui estao os mais valiosos.
🎯 Conceito Principal
- •Debug de dados: "O usuario joao@email.com esta com conta bloqueada. Verifique o status na tabela users e os logs de auth"
- •Verificar migrations: "Rode a migration e depois verifique se a coluna new_field foi adicionada corretamente na tabela orders"
- •Explorar schema: "Me mostre todas as tabelas, seus relacionamentos e as foreign keys do banco"
- •Seed data: "Crie 50 usuarios de teste com dados realistas para QA"
💡 Dica Pratica
Sempre adicione LIMIT nas queries. O Claude pode retornar milhares de linhas sem perceber, consumindo todo seu contexto. Diga: "Liste os 10 ultimos pedidos" em vez de "liste todos os pedidos".
🔒 Seguranca: Credenciais Read-Only em Producao
Este e o topico mais critico de todo o modulo. Nunca de acesso de escrita ao Claude em bancos de producao. Um DELETE sem WHERE ou um UPDATE mal formulado pode destruir dados reais.
🎯 Conceito Principal
- •Producao = read-only: Crie um usuario PostgreSQL com permissao apenas de SELECT
- •Desenvolvimento = full access: Em banco local, pode dar acesso total para seed e testes
- •Staging = read-write limitado: Acesso controlado para validar migrations
- •Supabase anon key: Ja tem acesso limitado por RLS - use como padrao
💡 Dica Pratica
Crie um usuario read-only no Postgres com: CREATE USER claude_readonly WITH PASSWORD 'senha'; GRANT SELECT ON ALL TABLES IN SCHEMA public TO claude_readonly;. Use essa credencial para o MCP em producao.
Exercicio Pratico
Conectar banco, rodar queries e verificar schema
Conecte um banco de dados ao Claude e execute tarefas praticas de exploracao.
Passo 1: Conecte o banco
Passo 2: Explore o schema
> "Liste todas as tabelas do banco e seus relacionamentos"
Passo 3: Execute uma query
Checklist de Conclusao:
📋 Resumo do Modulo
Proximo Modulo:
6.5 - MCP Google Sheets e Outros