# Laissez Cursor gérer votre projet Supabase

> Passer de l'éditeur au dashboard pour vérifier les tables, les logs et les migrations casse votre concentration.

Cette configuration s'adresse aux développeurs qui construisent sur Supabase et retournent sans cesse au dashboard pour vérifier tables, logs et migrations. Le serveur MCP Supabase permet à Cursor ou Claude Code de lister les tables, d'exécuter du SQL, de lire les logs et de rédiger des migrations, et GitHub conserve ces migrations dans une branche relue. Vous posez vos questions sur la base de données depuis l'éditeur au lieu de cliquer dans le dashboard.

## Étapes

1. **Ajouter le serveur MCP Supabase**: Dans Cursor, ouvrez Settings > MCP et ajoutez le serveur distant de Supabase sur https://mcp.supabase.com/mcp, ou lancez claude mcp add avec la même URL dans Claude Code. Connectez-vous à Supabase dans la fenêtre de navigateur qui s'ouvre et choisissez votre organisation. Vérifiez que des outils comme list_tables et execute_sql apparaissent.
   Astuce: La première fois, connectez un projet de développement, pas la production.
2. **Commencer en lecture seule**: Ajoutez read_only=true et project_ref=your-project-ref comme paramètres de requête à l'URL du serveur. Le mode lecture seule exécute le SQL avec un utilisateur Postgres en lecture seule, et le project ref empêche l'agent de toucher à d'autres projets. Demandez à l'agent de lister les tables pour confirmer le périmètre.
   Astuce: Vous trouverez le project ref dans l'URL du projet ou sous Project Settings.
3. **Poser vos questions dans le contexte**: Demandez à l'agent de décrire une table, d'expliquer une requête lente, de vérifier les logs d'erreurs ou de rédiger une migration pour une nouvelle colonne. Il exécute des requêtes de lecture et renvoie le SQL qu'il prévoit pour toute modification. Lisez le SQL avant d'appliquer quoi que ce soit.
   Astuce: Demandez la vérification des advisors pour repérer les politiques RLS et les index manquants.
4. **Committer les migrations**: Enregistrez les nouvelles migrations sous forme de fichiers dans supabase/migrations et demandez à l'agent de les committer sur une nouvelle branche via le serveur MCP GitHub ou votre git local. Ouvrez une pull request pour que quelqu'un relise le SQL avant qu'il n'atteigne la production. Appliquez les migrations via votre processus de déploiement habituel.
   Astuce: Tenez l'agent à l'écart des écritures en production ; laissez la CI ou la CLI Supabase appliquer les migrations.

## Prompts à essayer

- Liste les tables du schéma public avec leur nombre de lignes et leur statut RLS.
- Pourquoi cette requête sur orders est-elle lente ? Lance EXPLAIN et propose un index.
- Affiche les 50 derniers logs d'erreur du service API.
- Écris une migration qui ajoute un horodatage archived_at nullable à projects et enregistre-la dans supabase/migrations.
- Vérifie les advisors de sécurité et liste les tables dont la RLS est désactivée.

## Ce qu'il vous faut

- Un compte Supabase et un projet de développement
- Cursor ou Claude Code
- Un dépôt GitHub avec un dossier supabase/migrations
- La CLI Supabase si vous appliquez les migrations en local

## Limites

- Le mode lecture seule bloque les écritures : l'agent ne peut donc pas tester une migration sur la base pour vous.
- Le contenu des tables peut contenir du texte d'injection de prompt ; vérifiez ce que fait l'agent après avoir lu des données utilisateur.
- L'agent ne voit que le projet ciblé, pas vos autres environnements.

## Notes de sécurité

- Gardez le mode lecture seule pour les projets de production.
- Limitez d'abord le serveur à un projet de développement.

## Serveurs 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

## Questions fréquentes

**Est-ce sûr de connecter l'agent à ma base de données ?**

Supabase recommande de connecter le serveur MCP à des projets de développement et d'utiliser le mode lecture seule. Limitez-le à un projet avec project_ref et gardez les approbations d'outils activées dans Cursor.

**De quelle offre Supabase ai-je besoin ?**

Le serveur MCP fonctionne avec les projets Supabase gratuits et payants. Des fonctionnalités comme le branching dépendent de votre offre.

**L'agent peut-il appliquer des migrations ?**

Sans le mode lecture seule, il dispose d'un outil apply_migration. Cette configuration le garde en lecture seule et fait passer les migrations par une relecture GitHub.

**Et les données de mes tables ?**

Les résultats des requêtes entrent dans la conversation et partent chez le fournisseur du modèle. Utilisez un projet avec des données de test, ou évitez de sélectionner des colonnes contenant des données personnelles.

## Outils

- **[Supabase](https://suiteintent.com/t/supabase?m=FR)**: Postgres hébergé avec authentification et stockage. · Idéal pour: Un backend pour une appli créée avec l'IA · Offre gratuite
- **[GitHub](https://suiteintent.com/t/github?m=FR)**: Hébergement de code, tickets et pull requests. · Idéal pour: Équipes qui relisent le code par pull request · Offre gratuite · 10000