Portal VibecodandoPortalVibecodando

Supabase conecta agentes ao Postgres via MCP para inspecionar tabelas e executar SQL

Servidor oficial permite inspecionar o banco com acesso controlado; plataforma também oferece recursos para criar um MCP destinado aos usuários do aplicativo.

Gabriel RodriguesPublicado 3 min de leitura
Configuração do Cursor com o servidor MCP do Supabase ativado e sua lista de ferramentas.

O Supabase permite conectar agentes de IA ao PostgreSQL, sistema que armazena e organiza os dados do aplicativo, por meio do Model Context Protocol (MCP), padrão que conecta assistentes a ferramentas e dados externos. Com as permissões adequadas, o agente pode inspecionar tabelas e migrações, que registram alterações na estrutura do banco, executar SQL, linguagem usada para consultar e alterar bancos de dados, e consultar diagnósticos.

A empresa anunciou seu servidor MCP remoto em outubro de 2025. O serviço, acessado pela rede para oferecer ferramentas ao assistente, usa OAuth, mecanismo que autoriza o acesso entre aplicativos, e também oferece suporte a cópias do serviço executadas no computador do desenvolvedor. A orientação atual recomenda conectar bancos de produção apenas quando a tarefa exigir dados desse ambiente, com acesso restrito e outras salvaguardas: https://supabase.com/blog/remote-mcp-server.

Como configurar o acesso

Para começar, configure o servidor em um aplicativo ou assistente de IA compatível com MCP, autorize a conexão e selecione apenas o projeto necessário. Ative read_only=true para executar consultas com um usuário Postgres somente de leitura e restrinja os grupos de ferramentas; sem selecionar um projeto, todos os projetos acessíveis podem ficar disponíveis ao servidor.

Depois de inspecionar a estrutura do banco, revise as alterações e migrações antes de aplicá-las. Em outubro de 2026, a Supabase também anunciou esquemas declarativos em arquivos SQL, que descrevem a estrutura desejada do banco e ficam no repositório, local onde os arquivos do projeto e suas alterações são mantidos. O pg-delta compara as estruturas e gera migrações a partir das diferenças: https://supabase.com/blog/select-2026-build-anything.

Um MCP para os usuários do aplicativo

Há uma diferença importante entre o MCP oficial e um servidor MCP do próprio aplicativo. O primeiro ajuda a equipe a desenvolver sob as permissões concedidas pelo desenvolvedor e não deve ser entregue aos usuários finais. O segundo pode ser implantado como uma Edge Function, função de código executada pela infraestrutura do Supabase, para atender usuários. No exemplo autenticado da plataforma, o acesso segue as políticas de segurança por linha, ou RLS, que definem quais registros cada usuário pode acessar ou alterar. Esse exemplo exige chaves de assinatura assimétricas, servidor OAuth ativado e uma tela de consentimento.

Para recursos de IA em um produto mínimo viável, ou MVP, a extensão pgvector permite armazenar embeddings, representações numéricas dos dados, e fazer buscas por similaridade no Postgres. O fluxo inclui habilitar a extensão, criar uma coluna que aceite a quantidade de números produzida pelo modelo, gerar os embeddings e consultar os vetores mais próximos. A comparação deve usar embeddings produzidos pelo mesmo modelo: https://supabase.com/docs/guides/ai/vector-columns.

A Supabase recomenda usar ambientes de desenvolvimento, limitar projetos e ferramentas e manter aprovações manuais. Dados consultados podem conter instruções maliciosas para induzir o agente a expor informações; o modo somente leitura reduz o risco de alterações, mas não impede toda exposição, e segredos não devem ser enviados ao chat.

Para organizar o código e a revisão do MVP, o <a href="https://arara.code.app.br">Arara Code</a> é uma IDE brasileira gratuita baseada em Code-OSS, com chat, autocomplete e orquestração de subagentes. Ela está disponível sem cartão; antes de configurar o MCP do Supabase, confira a compatibilidade do assistente ou da extensão escolhida.

Cobertura por

G

Perguntas Frequentes (FAQ)

Configure o servidor oficial em um cliente MCP compatível, autorize a conexão, selecione o projeto e comece com o modo somente de leitura.

Não é o uso recomendado. Ele se destina ao desenvolvimento; para usuários finais, a plataforma permite criar um servidor MCP próprio e autenticado.

Não completamente. Ele reduz a capacidade de alterar dados, mas informações acessíveis ao agente ainda podem ser expostas.

Comentários

Carregando…

Entre na sua conta

Salve notícias e participe das conversas.