Antes de começar
- Projeto Supabase de desenvolvimento com dados fictícios
- Claude Code ou cliente MCP compatível
- Permissão na organização que contém o projeto
Escolha um projeto sem dados de clientes
Use uma base de desenvolvimento. Anote a referência do projeto nas configurações do Supabase e confira o nome para não confundir com produção.
O objetivo é documentar tabelas, colunas e relações. Somente leitura evita alterações por consultas nesse modo, mas continua permitindo a leitura de informações; por isso não é motivo para conectar uma base sensível sem necessidade.
Gere uma configuração com escopo
Na documentação do Supabase MCP, selecione o projeto, habilite Read-only e confira a configuração gerada. O endereço deve incluir project_ref e read_only=true.
O comando abaixo mostra a combinação documentada. Substitua SEU_PROJECT_REF pela referência do projeto de teste e mantenha as aspas, pois o endereço contém um sinal de &.
claude mcp add --scope project --transport http supabase "https://mcp.supabase.com/mcp?project_ref=SEU_PROJECT_REF&read_only=true"Autentique e confira a conexão
Abra /mcp no Claude Code, selecione Supabase e siga a autenticação no navegador. Escolha a organização correta. Não cole tokens ou senhas na conversa.
Antes de consultar tabelas, confira no cliente se o endereço mantém o escopo e o modo somente leitura. Uma instrução no prompt para não alterar não substitui a configuração técnica.
Peça um mapa da estrutura
Use este pedido: liste as tabelas deste projeto e explique a finalidade provável de cada uma a partir do esquema. Traga colunas principais, chaves e relações. Marque inferências como hipóteses e não consulte linhas com conteúdo de usuários.
Compare a resposta com o Table Editor. O agente pode deduzir um propósito pelo nome, mas essa dedução precisa ser distinguida do que o esquema comprova.
Investigue uma relação pequena
Escolha duas tabelas de teste relacionadas e peça a consulta SQL de leitura que mostraria a ligação. Revise a consulta antes de executá-la e limite a quantidade de resultados.
Se usar a skill Supabase Postgres Best Practices, peça uma revisão do SQL e uma explicação das suposições. Não aplique índices, políticas ou migrações durante este exercício.
Salve um dicionário de dados
Peça um documento com tabela, finalidade confirmada, campos principais, relações e perguntas em aberto. Use somente metadados necessários para a documentação.
Guarde junto ao projeto e marque a data da consulta. Se o esquema mudar, revise o documento. Ao terminar, remova ou desative a conexão caso não vá continuar usando-a.
O que você terá ao final
Um mapa conferido do esquema do projeto e uma conexão configurada para consultas somente leitura.
Vale conferir
- Somente leitura não anonimiza dados nem reduz por si só o conteúdo que pode ser lido.
- A integração não deve ser aberta a visitantes do seu site.
- Tutorial baseado na documentação; nenhuma base foi conectada ou consultada pela Agentspedia neste exercício.