Automação do Supabase via Rube MCP

Automatize operações do Supabase, incluindo consultas ao banco de dados, inspeção de esquema de tabelas, execução de SQL, gerenciamento de projetos e organizações, buckets de armazenamento, funções de edge e monitoramento de saúde de serviços através do toolkit Supabase da Composio.

Pré-requisitos

• O Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponíveis)
• Conexão ativa com o Supabase via RUBE_MANAGE_CONNECTIONS com o toolkit supabase
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas de ferramentas atuais

Configuração

Obter o Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na configuração do seu cliente. Nenhuma chave de API é necessária — basta adicionar o endpoint e funciona.

1. Verifique se o Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
2. Chame RUBE_MANAGE_CONNECTIONS com o toolkit supabase
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar a autenticação do Supabase
4. Confirme se o status da conexão mostra ATIVO antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Consultar e Gerenciar Tabelas do Banco de Dados

Quando usar: O usuário deseja ler dados de tabelas, inspecionar esquemas ou realizar operações CRUD.

Sequência de ferramentas:

1. SUPABASE_LIST_ALL_PROJECTS - Listar projetos para encontrar o project_ref alvo [Pré-requisito]
2. SUPABASE_LIST_TABLES - Listar todas as tabelas e visualizações no banco de dados [Pré-requisito]
3. SUPABASE_GET_TABLE_SCHEMAS - Obter tipos de coluna detalhados, restrições e relacionamentos [Pré-requisito para escritas]
4. SUPABASE_SELECT_FROM_TABLE - Consultar linhas com filtragem, ordenação e paginação [Necessário para leituras]
5. SUPABASE_BETA_RUN_SQL_QUERY - Executar SQL arbitrário para consultas complexas, inserções, atualizações ou exclusões [Necessário para escritas]

Parâmetros chave para SELECT_FROM_TABLE:

• project_ref: Referência do projeto de 20 caracteres em minúsculas
• table: Nome da tabela ou visualização a ser consultada
• select: Lista de colunas separadas por vírgula (suporta seleções aninhadas e caminhos JSON como profile->avatar_url)
• filters: Array de objetos de filtro com column, operator, value
• order: Expressão de ordenação como created_at.desc
• limit: Número máximo de linhas a serem retornadas (mínimo 1)
• offset: Linhas a serem puladas para paginação

Operadores de filtro PostgREST:

• eq, neq: Igual / diferente
• gt, gte, lt, lte: Operadores de comparação
• like, ilike: Correspondência de padrão (sensível / insensível a maiúsculas e minúsculas)
• is: Verificação IS (para null, true, false)
• in: Em uma lista de valores
• cs, cd: Contém / contido por (arrays)
• fts, plfts, phfts, wfts: Variantes de busca de texto completo

Parâmetros chave para RUN_SQL_QUERY:

• ref: Referência do projeto (20 letras minúsculas, padrão ^[a-z]{20}$)
• query: Declaração SQL PostgreSQL válida
• read_only: Booleano para forçar transação somente leitura (mais seguro para SELECTs)

Armadilhas:

• project_ref deve ser exatamente 20 letras minúsculas (apenas a-z, sem números ou hifens)
• SELECT_FROM_TABLE é somente leitura; use RUN_SQL_QUERY para operações INSERT, UPDATE, DELETE
• Para colunas de array PostgreSQL (text[], integer[]), use a sintaxe ARRAY['item1', 'item2'] ou '{"item1", "item2"}', NÃO a sintaxe de array JSON '["item1", "item2"]'
• Identificadores SQL que diferenciam maiúsculas de minúsculas devem ser colocados entre aspas duplas nas consultas
• Operações DDL complexas podem atingir o tempo limite (limite de ~60 segundos); divida em consultas menores
• ERRO 42P01 "relation does not exist" geralmente significa identificadores não citados que diferenciam maiúsculas de minúsculas
• ERRO 42883 "function does not exist" significa que você está chamando helpers não padrão; prefira consultas information_schema

2. Gerenciar Projetos e Organizações

Quando usar: O usuário deseja listar projetos, inspecionar configurações ou gerenciar organizações.

Sequência de ferramentas:

1. SUPABASE_LIST_ALL_ORGANIZATIONS - Listar todas as organizações (IDs e nomes) [Necessário]
2. SUPABASE_GETS_INFORMATION_ABOUT_THE_ORGANIZATION - Obter informações detalhadas da organização por slug [Opcional]
3. SUPABASE_LIST_MEMBERS_OF_AN_ORGANIZATION - Listar membros da organização com funções e status de MFA [Opcional]
4. SUPABASE_LIST_ALL_PROJECTS - Listar todos os projetos com metadados [Necessário]
5. SUPABASE_GETS_PROJECT_S_POSTGRES_CONFIG - Obter configuração do banco de dados [Opcional]
6. SUPABASE_GETS_PROJECT_S_AUTH_CONFIG - Obter configuração de autenticação [Opcional]
7. SUPABASE_GET_PROJECT_API_KEYS - Obter chaves de API (sensível — manuseie com cuidado) [Opcional]
8. SUPABASE_GETS_PROJECT_S_SERVICE_HEALTH_STATUS - Verificar a saúde do serviço [Opcional]

Parâmetros chave:

• ref: Referência do projeto para ferramentas específicas do projeto
• slug: Slug da organização (identificador amigável para URL) para ferramentas da organização

…