# Cursor verwaltet Ihr Supabase-Projekt

> Der Wechsel zwischen Editor und Dashboard für Tabellen, Logs und Migrationen bremst Sie aus.

Dieses Setup richtet sich an Entwickler, die mit Supabase bauen und ständig ins Dashboard wechseln, um Tabellen, Logs und Migrationen zu prüfen. Mit dem Supabase-MCP-Server kann Cursor oder Claude Code Tabellen auflisten, SQL ausführen, Logs lesen und Migrationen entwerfen, und GitHub hält diese Migrationen in einem geprüften Branch. Am Ende stellen Sie Datenbankfragen direkt im Editor.

## Schritte

1. **Supabase-MCP hinzufügen**: Öffnen Sie in Cursor Settings > MCP und fügen Sie den Remote-Server von Supabase unter https://mcp.supabase.com/mcp hinzu, oder führen Sie in Claude Code claude mcp add mit derselben URL aus. Melden Sie sich im geöffneten Browserfenster bei Supabase an und wählen Sie Ihre Organisation. Prüfen Sie, ob Tools wie list_tables und execute_sql erscheinen.
   Tipp: Verbinden Sie beim ersten Mal ein Entwicklungsprojekt, nicht die Produktion.
2. **Im Nur-Lese-Modus starten**: Hängen Sie read_only=true und project_ref=ihre-project-ref als Parameter an die Server-URL. Der Lesemodus führt SQL mit einem schreibgeschützten Postgres-Benutzer aus, und project_ref verhindert Zugriffe auf andere Projekte. Lassen Sie den Agenten die Tabellen auflisten, um den Umfang zu prüfen.
   Tipp: Die Project Ref finden Sie in der Projekt-URL oder unter Project Settings.
3. **Im Kontext fragen**: Bitten Sie den Agenten, eine Tabelle zu beschreiben, eine langsame Abfrage zu erklären, Fehler in den Logs zu suchen oder eine Migration für eine neue Spalte zu entwerfen. Er führt Leseabfragen aus und liefert für Änderungen das geplante SQL. Lesen Sie dieses SQL, bevor Sie etwas anwenden.
   Tipp: Lassen Sie die Advisors prüfen, um fehlende RLS-Policies und Indizes zu finden.
4. **Migrationen committen**: Speichern Sie neue Migrationen als Dateien in supabase/migrations und lassen Sie den Agenten sie über den GitHub-MCP-Server oder Ihr lokales git in einen neuen Branch committen. Öffnen Sie einen Pull Request, damit jemand das SQL vor der Produktion prüft. Wenden Sie Migrationen über Ihren üblichen Deploy-Prozess an.
   Tipp: Halten Sie den Agenten von Schreibzugriffen auf Produktion fern; Migrationen spielt CI oder die Supabase-CLI ein.

## Prompts zum Ausprobieren

- Liste die Tabellen im Schema public mit Zeilenanzahl und RLS-Status.
- Warum ist diese Abfrage auf orders langsam? Führe EXPLAIN aus und schlage einen Index vor.
- Zeige die letzten 50 Fehler-Logs des API-Dienstes.
- Schreibe eine Migration, die projects eine nullable Spalte archived_at vom Typ timestamp hinzufügt, und speichere sie in supabase/migrations.
- Prüfe die Security Advisors und liste Tabellen ohne aktiviertes RLS.

## Was Sie brauchen

- Ein Supabase-Konto und ein Entwicklungsprojekt
- Cursor oder Claude Code
- Ein GitHub-Repository mit dem Ordner supabase/migrations
- Die Supabase-CLI, wenn Sie Migrationen lokal anwenden

## Grenzen

- Der Lesemodus blockiert Schreibzugriffe, der Agent kann eine Migration also nicht für Sie in der Datenbank testen.
- Tabelleninhalte können Prompt-Injection-Text enthalten; prüfen Sie, was der Agent nach dem Lesen von Nutzerdaten tut.
- Der Agent sieht nur das freigegebene Projekt, nicht Ihre anderen Umgebungen.

## Sicherheitshinweise

- Für Produktionsprojekte den Nur-Lese-Modus beibehalten.
- Den Server zuerst auf ein Entwicklungsprojekt beschränken.

## MCP-Server

- [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

## Häufige Fragen

**Ist es sicher, den Agenten mit meiner Datenbank zu verbinden?**

Supabase empfiehlt, den MCP-Server mit Entwicklungsprojekten zu verbinden und den Lesemodus zu nutzen. Begrenzen Sie ihn mit project_ref auf ein Projekt und lassen Sie Tool-Freigaben in Cursor aktiv.

**Welchen Supabase-Tarif brauche ich?**

Der MCP-Server funktioniert mit kostenlosen und bezahlten Projekten. Funktionen wie Branching hängen vom Tarif ab.

**Kann der Agent Migrationen anwenden?**

Ohne Lesemodus steht ihm das Tool apply_migration zur Verfügung. Dieses Setup bleibt schreibgeschützt und schickt Migrationen ins Review auf GitHub.

**Was ist mit den Daten in meinen Tabellen?**

Abfrageergebnisse landen in der Unterhaltung und beim Modellanbieter. Nutzen Sie ein Projekt mit Testdaten oder fragen Sie keine Spalten mit personenbezogenen Daten ab.

## Tools

- **[Supabase](https://suiteintent.com/t/supabase?m=DE)**: Gehostetes Postgres mit Auth und Speicher. · Ideal für: Backend für eine mit KI gebaute App · Gratis-Tarif
- **[GitHub](https://suiteintent.com/t/github?m=DE)**: Code-Hosting, Issues und Pull Requests. · Ideal für: Teams mit Code-Review per Pull Request · Gratis-Tarif · 10000