Como conectar o Claude Code ao Supabase em 1 comando (sem perder a cabeça)

Você já se viu copiando uma tela inteira do Supabase, colando no Claude e explicando "aqui são as colunas, aqui é a tabela X, aqui é a Y"? Pois é. Existe um jeito muito mais fácil.

Esse post mostra como o Claude Code passa a enxergar seu banco do Supabase sozinho, com um único comando no terminal. Sem chave manual. Sem editar arquivo .env. Sem ler 200 páginas de documentação.

E o melhor: é oficial — o time do Supabase mantém esse caminho.

O que é Supabase (caso você nunca tenha ouvido)

Imagina um pacote pronto que junta:

• Banco de dados (onde você guarda as informações do seu app — usuários, pedidos, mensagens)
• Login (cadastro, senha, login com Google, recuperação de senha)
• Upload de arquivos (imagens, PDFs, vídeos)
• Tempo real (notificação aparecendo na hora pro usuário)

Tudo isso hospedado, com plano grátis pra começar. É o concorrente open source do Firebase do Google.

Esse próprio site mestredoclaude.com.br roda nele. As skills, os emails capturados, os downloads — tudo Supabase.

O que é MCP (em uma analogia simples)

MCP é a sigla pra Model Context Protocol. Não decora o nome, decora a analogia:

MCP é o cabo USB entre a IA e o resto do mundo.

O Claude é o computador. O Supabase é a impressora. Conectou pelo cabo, o computador entende a impressora.

Sem MCP, o Claude é uma IA brilhante que só sabe o que você digita pra ela. Com MCP, ela pode ler e escrever direto no seu Supabase, listar suas tabelas, criar uma coluna nova, detectar uma falha de segurança — tudo sozinha, sem você ter que copiar e colar nada.

O que muda quando você conecta

Três superpoderes ganhos na hora:

1. Claude lê o "esqueleto" do seu banco sem você colar. Pergunta "que tabelas eu tenho?" e ele responde com a estrutura toda. Já pode pedir refatoração baseada na realidade, não no que você lembrou de digitar.

2. Cria, altera e remove tabelas via conversa. "Adiciona uma coluna whatsapp na tabela leads" — e ele faz, com SQL correto, na cara.

3. Detecta falhas de segurança que você nem viu. Pergunta "tem alguma tabela sem RLS configurado?" — e ele varre tudo. RLS é a trava por linha que decide quem pode ler ou escrever cada registro do banco. Esquecer disso é o erro #1 de quem começa.

Antes de começar

Você só precisa de duas coisas:

• Claude Code instalado no terminal. Se ainda não fez, siga esse tutorial — leva 15 minutos.
• Conta no Supabase (grátis). Se não tem, vai em supabase.com, cria a conta com o e-mail e cria 1 projeto. Não precisa colocar cartão.

Pronto. Bora conectar.

Passo a passo (4 passos, 3 minutos no total)

Passo 1 — Abre o terminal

Terminal é a tela preta com letrinhas onde você digita comando. No Windows, abre o PowerShell ou o Terminal. No Mac, abre o Terminal. No Linux, você já sabe.

Se o claude não responde quando você digita claude --version, você ainda não instalou o Claude Code — volta um post e instala primeiro.

Passo 2 — Cola esse comando único

claude mcp add --transport http supabase https://mcp.supabase.com/mcp

Aperta Enter. Pronto. O Claude registra o servidor do Supabase como uma ferramenta dele.

Passo 3 — Autoriza no navegador

Quando você usar o claude pela primeira vez depois de conectar, ele vai abrir uma aba no navegador pedindo pra você fazer login no Supabase e autorizar a conexão. É a mesma tela que você vê quando faz "Login com Google" em qualquer site — chamam isso de OAuth.

Você loga (com a conta que já criou), vê uma tela tipo "Permitir que o Claude leia e escreva no seu Supabase?", clica em Permitir, e fecha o navegador.

Se quiser limitar o acesso a um projeto específico (recomendado pra começar), a tela permite escolher qual projeto autorizar.

Passo 4 — Volta pro terminal e testa

Pergunta pro Claude:

lista as tabelas que existem no meu Supabase

Se ele responder com a lista das suas tabelas (mesmo que você só tenha 1 ou 2), tá funcionando. Bem-vindo ao novo nível.

3 prompts pra testar que tá tudo certo

Cola um por um e vê o Claude trabalhar:

mostra a estrutura completa da minha tabela mais usada,
incluindo colunas, tipos e índices

verifica se todas as minhas tabelas têm RLS habilitado.
se alguma não tiver, explica o risco em uma frase

cria uma tabela nova chamada "newsletter_signups"
com email, nome e created_at — e já configura o RLS
pra só permitir insert anônimo

Se o Claude executar e mostrar resultado real, você acabou de ganhar o mesmo poder que dev sênior tem.

Cuidados de segurança

Esse cuidado vale pra qualquer ferramenta que tem acesso ao seu banco — não é frescura, é higiene.

Resumão

• Supabase é banco + login + uploads + tempo real, com plano grátis.
• MCP é o "cabo USB" que liga a IA à ferramenta — no caso, ao seu banco.
• Um comando (claude mcp add ...) conecta tudo. Sem chave manual, sem .env, sem PAT pro caso simples.
• Depois de autorizar uma vez no navegador, o Claude lê o seu banco, cria tabelas, e checa segurança via conversa.
• Comece com projeto de teste, depois sobe pra produção quando estiver confiante.

Quer ir mais fundo?

E pro próximo nível: o time do Supabase mantém uma skill oficial com 18+ regras de boas práticas de Postgres + segurança RLS, pra IA seguir quando for trabalhar no banco. Tá no GitHub deles em github.com/supabase/agent-skills — open source, MIT.

Já conectou? Cadastra teu email lá em cima pra receber os próximos posts assim que sair. Sem spam, sem newsletter chata. Só o que vale.

Quem assistiu até aqui também vai gostar:

• Humanizer — skill que tira a cara de IA do seu texto
• Brand Voice — Claude escrevendo no seu tom de voz
• Como instalar o Claude Code do zero