# Lascia che Cursor gestisca il tuo progetto Supabase

> Passare dall'editor alla dashboard per controllare tabelle, log e migrazioni ti fa perdere la concentrazione.

Questo setup è per gli sviluppatori che costruiscono su Supabase e tornano di continuo alla dashboard per controllare tabelle, log e migrazioni. Il server MCP di Supabase permette a Cursor o Claude Code di elencare le tabelle, eseguire SQL, leggere i log e preparare migrazioni, mentre GitHub conserva queste migrazioni in un branch revisionato. Fai le tue domande sul database dall'editor invece di cliccare nella dashboard.

## Passaggi

1. **Aggiungi il server MCP di Supabase**: In Cursor apri Settings > MCP e aggiungi il server remoto di Supabase su https://mcp.supabase.com/mcp, oppure esegui claude mcp add con lo stesso URL in Claude Code. Accedi a Supabase nella finestra del browser che si apre e scegli la tua organizzazione. Controlla che compaiano strumenti come list_tables ed execute_sql.
   Consiglio: La prima volta collega un progetto di sviluppo, non quello di produzione.
2. **Parti in sola lettura**: Aggiungi read_only=true e project_ref=your-project-ref come parametri di query all'URL del server. La modalità in sola lettura esegue l'SQL con un utente Postgres in sola lettura, e il project ref impedisce all'agente di toccare altri progetti. Chiedi all'agente di elencare le tabelle per confermare il perimetro.
   Consiglio: Trovi il project ref nell'URL del progetto o in Project Settings.
3. **Fai le tue domande nel contesto**: Chiedi all'agente di descrivere una tabella, spiegare una query lenta, controllare i log degli errori o preparare una migrazione per una nuova colonna. Esegue query di lettura e ti restituisce l'SQL che intende usare per ogni modifica. Leggi l'SQL prima di applicare qualsiasi cosa.
   Consiglio: Chiedi il controllo degli advisor per trovare policy RLS e indici mancanti.
4. **Fai il commit delle migrazioni**: Salva le nuove migrazioni come file in supabase/migrations e chiedi all'agente di farne il commit su un nuovo branch tramite il server MCP di GitHub o il tuo git locale. Apri una pull request così qualcuno rivede l'SQL prima che arrivi in produzione. Applica le migrazioni con il tuo normale processo di deploy.
   Consiglio: Tieni l'agente lontano dalle scritture in produzione; lascia che sia la CI o la CLI di Supabase ad applicare le migrazioni.

## Prompt da provare

- Elenca le tabelle dello schema public con il numero di righe e lo stato della RLS.
- Perché questa query su orders è lenta? Esegui EXPLAIN e proponi un indice.
- Mostra gli ultimi 50 log di errore del servizio API.
- Scrivi una migrazione che aggiunge a projects un timestamp archived_at nullable e salvala in supabase/migrations.
- Controlla gli advisor di sicurezza ed elenca le tabelle con la RLS disattivata.

## Cosa ti serve

- Un account Supabase e un progetto di sviluppo
- Cursor o Claude Code
- Un repository GitHub con una cartella supabase/migrations
- La CLI di Supabase se applichi le migrazioni in locale

## Limiti

- La modalità in sola lettura blocca le scritture, quindi l'agente non può provare una migrazione sul database al posto tuo.
- Il contenuto delle tabelle può includere testo di prompt injection; controlla cosa fa l'agente dopo aver letto dati degli utenti.
- L'agente vede solo il progetto indicato, non gli altri ambienti.

## Note di sicurezza

- Usa la modalità in sola lettura per i progetti di produzione.
- All'inizio limita il server a un progetto di sviluppo.

## Server MCP

- [Supabase MCP Server](https://github.com/supabase-community/supabase-mcp): database-read, database-write, project-admin
- [GitHub MCP Server](https://github.com/github/github-mcp-server): repository-read, issue-write, pull-request-write

## Domande frequenti

**È sicuro collegare l'agente al mio database?**

Supabase consiglia di collegare il server MCP a progetti di sviluppo e di usare la modalità in sola lettura. Limitalo a un progetto con project_ref e lascia attive le approvazioni degli strumenti in Cursor.

**Quale piano di Supabase mi serve?**

Il server MCP funziona con i progetti Supabase gratuiti e a pagamento. Funzionalità come il branching dipendono dal tuo piano.

**L'agente può applicare le migrazioni?**

Senza la modalità in sola lettura ha a disposizione lo strumento apply_migration. Questo setup lo tiene in sola lettura e fa passare le migrazioni da una revisione su GitHub.

**E i dati delle mie tabelle?**

I risultati delle query entrano nella conversazione e arrivano al fornitore del modello. Usa un progetto con dati di test, oppure evita di selezionare colonne che contengono dati personali.

## Strumenti

- **[Supabase](https://suiteintent.com/t/supabase?m=IT)**: Postgres in hosting con autenticazione e storage. · Ideale per: Un backend per un'app creata con l'AI · Piano gratuito
- **[GitHub](https://suiteintent.com/t/github?m=IT)**: Hosting di codice, issue e pull request. · Ideale per: Team che revisionano il codice con pull request · Piano gratuito · 10000