Servidor MCP do Supabase: conecte com segurança em cinco minutos
Servidor MCP do Supabase
Servidor MCP do Supabase: configuração, modo somente leitura e segurança | We.Inc
Conecte uma ferramenta de código com IA ao Supabase usando o servidor MCP oficial: a URL do servidor, as opções read_only e project_ref, os grupos de recursos, as ferramentas e as recomendações de segurança.
O servidor MCP do Supabase permite que um assistente de código com IA leia as suas tabelas, rode SQL, consulte logs e faça deploy de funções por um único link: https://mcp.supabase.com/mcp. Adicione ?read_only=true para que as consultas não possam alterar dados e ?project_ref= para que ele só alcance um projeto, e continue aprovando cada chamada de ferramenta manualmente.
Opções de URL documentadas pelo Supabase
Opção
O que faz
read_only=true
Roda toda consulta como um usuário Postgres somente leitura
project_ref=<id>
Limita o acesso a um projeto e desativa as ferramentas de conta
features=database,docs
Ativa só os grupos de ferramentas listados; storage vem desativado por padrão
URL local
MCP, o Model Context Protocol, é uma forma padrão de um app de IA chamar ferramentas externas. Monte o seu link de conexão abaixo: escolha um projeto, o modo somente leitura e os grupos de ferramentas, e depois copie a configuração. Nada sai do seu navegador.
Encontre o ID de referência do projeto nas configurações do projeto no painel do Supabase.
Monte o link com as opções que quiser e cole o JSON no arquivo de configurações do seu cliente MCP.
No primeiro uso, o cliente abre uma janela do navegador: entre no Supabase, escolha a organização e permita o acesso.
Para CI ou uma máquina sem navegador, crie um token de acesso pessoal com escopo limitado e envie-o num header Authorization: Bearer.
Aponte para um projeto de desenvolvimento, não para a sua loja em produção. O Supabase recomenda conectar à produção só quando a tarefa realmente exigir.
Cuidado com prompt injection: textos guardados nas suas tabelas, como um ticket de suporte, podem trazer instruções que enganam o assistente e o levam a uma consulta prejudicial.
Trate-o como uma ferramenta para os seus próprios desenvolvedores. O Supabase diz que ele carrega as suas permissões e não deve ser entregue a clientes.
Para jobs sem supervisão, libere só ferramentas somente leitura com escopo de projeto e faça o job gerar relatórios em vez de gravar.
Use branching para testar mudanças de schema longe da produção. O Supabase marca as ferramentas de branching como experimentais e exclusivas de planos pagos.
Perguntas frequentes
O que o servidor MCP do Supabase consegue fazer?
As ferramentas documentadas listam tabelas e migrations, aplicam migrations, rodam SQL, consultam logs, leem os advisors de segurança e desempenho, geram tipos TypeScript, gerenciam Edge Functions, buscam na documentação e, se não houver escopo, gerenciam projetos.
O modo somente leitura é seguro o bastante?
Ele impede gravações porque as consultas rodam como um usuário de banco somente leitura, mas o assistente ainda pode ler tudo o que esse usuário pode ler. Combine com project_ref e mantenha dados pessoais fora do que você pede.
Preciso de um token de acesso?
Não com o login padrão do servidor hospedado, que usa login pelo navegador. Um token de acesso pessoal só é necessário para CI ou configurações headless, e nem todo cliente suporta headers personalizados.
Quais grupos de recursos existem?
O código do servidor lista docs, account, database, debugging, development, functions, branching, storage e notebooks. A documentação do Supabase diz que todos os grupos, exceto storage, vêm ativados por padrão.
Os visitantes do meu site podem usá-lo?
Não. Ele roda com as suas permissões de desenvolvedor, então o Supabase recomenda mantê-lo como ferramenta interna, não como algo que os usuários finais alcancem.
O que cada grupo de ferramentas cobre
database: list_tables, list_extensions, list_migrations, apply_migration e execute_sql. debugging: query_logs e get_advisors. development: get_project_url, get_publishable_keys e generate_typescript_types.
functions cobre listar, ler e fazer deploy de Edge Functions, além de definir os segredos delas. docs tem search_docs. account reúne as ferramentas de projeto e organização, incluindo create_project e pause_project, e é desativado quando você limita o escopo a um projeto.
Uma configuração inicial segura
Com escopo de um projeto, somente leitura, apenas com as ferramentas de database e docs. Troque pelo seu próprio ID de referência.
Conexão somente leitura com escopo
A maioria dos clientes lê um objeto mcpServers como este; o nome do arquivo depende do cliente.
Gerador de conexão
ID de referência do projeto (opcional, mas recomendado)
o ref do seu projeto
Modo somente leitura
Grupos de ferramentas
Link do servidor
JSON de configuração (por exemplo .cursor/mcp.json)
Copiar
Copiado
Escolha pelo menos um grupo de ferramentas.
O grupo account é ignorado quando você define uma referência de projeto.