Come collegare Supabase a Gemini via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Supabase, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Supabase + Gemini

Fai curare alla tua AI i tuoi progetti Supabase: elenca i progetti e controllane lo stato, esplora schemi e tabelle, esegui SQL in sola lettura, leggi log, advisor di sicurezza e prestazioni, Edge Functions, migrazioni, branch e bucket di Storage. Tramite la Management API con un personal access token.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

SUPABASE_ACCESS_TOKEN

Step 1 — Ottieni le credenziali

1. Nella dashboard di Supabase apri il menu dell'account → Account preferences → Access Tokens (oppure vai direttamente su https://supabase.com/dashboard/account/tokens) e clicca su Generate new token.
2. Meglio un scoped token: scegli l'organizzazione e i progetti che l'AI può vedere e dai a ogni funzionalità Read (o Read-write solo dove deve modificare qualcosa). I tool qui usano Projects, Project Settings, Database, Migrations, Backups, Edge Functions, API Keys (non API Key Secrets), Logs, Usage Analytics, Advisors, Storage, Development Branches e Organizations.
3. Imposta una scadenza (al massimo un anno) e copia il token. Inizia con sbp_ e Supabase lo mostra una sola volta.
4. Inserisci il token in SUPABASE_ACCESS_TOKEN, senza la parola Bearer, poi installa il connettore.
5. Comincia con supabase_list_projects: elenca ogni progetto raggiungibile dal token, con il suo stato e il suo ref. Il ref (le 20 lettere minuscole in https://<ref>.supabase.co) è ciò che serve a tutti gli altri tool.

Modificare l'accesso in seguito: i permessi di un token non si possono cambiare dopo la creazione. Per ampliarli o ridurli crea un nuovo token ed elimina quello vecchio. Un token legacy (senza scope) ha invece il tuo accesso completo a tutte le organizzazioni.

Solo lettura: dai a uno scoped token solo Read su ogni funzionalità. Con Database su Read, anche supabase_execute_sql esegue il suo SQL in sola lettura. Nessun altro tool modifica dati: le domande di tutti i giorni passano da supabase_run_read_only_sql, che esegue un'istruzione come utente del database in sola lettura e taglia i risultati oltre 200 KB.

Disattivati all'installazione: supabase_execute_sql. Esegue SQL come postgres con pieni diritti, quindi DDL, scritture e grant hanno effetto subito e non si possono annullare. Attivalo solo se l'AI deve modificare il database; ti mostra ogni istruzione e aspetta la tua conferma. Per le modifiche allo schema che devono stare sotto controllo di versione, il posto giusto è il tuo flusso di migrazioni.

La vista del proprietario del progetto: il connettore lavora tramite la Management API di Supabase, non come utente dell'app, quindi non passa dalla REST API del progetto né dalla row level security. supabase_list_api_keys nomina ogni chiave ma mostra il valore solo di quelle pubbliche; le secret key e la vecchia chiave service_role sono elencate senza valore di proposito, e nessun tool le rivela. Nemmeno il codice delle Edge Functions viene scaricato.

Progetti in pausa: i progetti Free vanno in pausa dopo una settimana senza attività e mostrano lo stato INACTIVE. I tool del database falliscono finché non ripristini il progetto dalla dashboard. Quando un'app segnala errori, esegui prima supabase_get_project_health.

Log e advisor: senza un intervallo di tempo supabase_query_logs cerca solo nell'ultimo minuto; un intervallo può coprire al massimo 24 ore e deve rientrare nella conservazione dei log del tuo piano (1 giorno su Free, 7 su Pro, 28 su Team). supabase_get_security_advisors e supabase_get_performance_advisors eseguono gli stessi controlli della pagina Advisors della dashboard; risolvi prima i risultati ERROR, soprattutto le tabelle esposte senza row level security. I branch di anteprima (supabase_list_branches) richiedono un piano a pagamento.

Limiti: Supabase consente 120 richieste alla Management API al minuto per utente ed endpoint (tutti i token di un utente condividono il limite) e 30 al minuto per log e dati di utilizzo. Oltre il limite risponde 429 per il resto del minuto: attendi un minuto e riprova.

Errori comuni: 401 "Invalid access token" significa che il token è sbagliato, scaduto o è stato eliminato: creane uno nuovo in Access Tokens. 403 significa che il token non può farlo: uno scoped token indica in missing_permissions cosa manca, quindi crea un nuovo token che lo includa. 404 è un ref di progetto sconosciuto, o un progetto fuori dalle organizzazioni del token. 402 sui log significa che la quota di utilizzo dell'organizzazione è esaurita. Un'istruzione SQL che fallisce torna con il messaggio di Postgres, per esempio "relation "orders" does not exist" quando una tabella non è qualificata con il suo schema (public.orders).

Il connettore non crea, mette in pausa, ripristina o elimina progetti, non pubblica Edge Functions, non gestisce secret, configurazione dell'autenticazione, domini personalizzati, restrizioni di rete o fatturazione e non legge le tabelle della tua app tramite PostgREST.

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in Gemini

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di Supabase.

Tool disponibili

Esempi di prompt

• "Quali dei miei progetti Supabase non sono in salute in questo momento, e cosa non va?"
• "Esegui il security advisor sul progetto Acme Shop e dimmi quali tabelle sono esposte senza row level security."
• "Quanti ordini sono stati creati ogni giorno la settimana scorsa in public.orders del progetto Acme Shop?"
• "Mostrami gli errori di Postgres dell'ultima ora nei log di Acme Shop e spiegami da cosa sono causati."

FAQ

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Meta Muse