Supabase MCP-Server
offiziellDer eigene MCP-Server von Supabase lässt einen Agenten mit Datenbank, Edge Functions und Projekteinstellungen eines Supabase-Projekts arbeiten, gehostet bei Supabase oder lokal über die Supabase CLI. Der Zugriff lässt sich über URL-Parameter auf ein Projekt, auf Lesezugriff und auf ausgewählte Tool-Gruppen beschränken.
Was ein Agent tun kann
- → SQL ausführen und Tabellenschemata lesen
- → Migrationen erstellen und anwenden
- → Edge Functions bereitstellen
- → TypeScript-Typen generieren
- → Die Supabase-Dokumentation durchsuchen
Der Server handelt mit den Berechtigungen des Entwicklers, daher empfiehlt Supabase den Nur-Lese-Modus, ein einzelnes Projekt und die manuelle Freigabe von Tool-Aufrufen. Vor destruktivem SQL und kostenpflichtigen Aktionen fragt er nach einer Bestätigung, was Supabase als Schutzmaßnahme und nicht als Garantie bezeichnet, und die Tool-Gruppe Storage ist standardmäßig abgeschaltet.
Über den Supabase MCP-Server
Der Supabase MCP-Server wird von Supabase entwickelt und unter mcp.supabase.com von Supabase betrieben. Er verbindet einen KI-Assistenten mit Ihrem Supabase-Konto, sodass der Assistent mit Datenbank, Edge Functions, Logs und Projekteinstellungen Ihrer Projekte arbeiten kann. Supabase führt ihn als allgemein verfügbar. Eine lokale Version läuft mit der Supabase CLI, und selbst gehostete Supabase-Installationen werden ebenfalls unterstützt.
Der Server ist ein Werkzeug für die Menschen, die die App bauen, nicht für Endnutzer. Entwickler können den Assistenten bitten, Tabellen aufzulisten, eine Migration zu schreiben und anzuwenden, eine SQL-Abfrage auszuführen, TypeScript-Typen zu erzeugen, eine Edge Function bereitzustellen oder bei Fehlern die Logs zu lesen. Er kann außerdem Sicherheits- und Performance-Hinweise zu einem Projekt abrufen, die Supabase-Dokumentation durchsuchen und Projekte anlegen oder pausieren.
Der Server handelt mit den Berechtigungen des angemeldeten Entwicklers, weshalb Supabase davon abrät, ihn Kunden zu überlassen. Drei Einstellungen in der Serveradresse grenzen ihn ein: nur ein Projekt, ein Nur-Lese-Modus, in dem Abfragen als schreibgeschützter Datenbanknutzer laufen, und eine Auswahl an Tool-Gruppen. Supabase warnt, dass Text in Ihren Daten versuchen kann, den Assistenten zu steuern, und empfiehlt, die manuelle Freigabe jedes Tool-Aufrufs eingeschaltet zu lassen.
Das können Sie fragen
- Führen Sie die Sicherheitshinweise für dieses Projekt aus und erklären Sie jeden Befund und wie wir ihn beheben.
- Schreiben Sie eine Migration, die der Tabelle orders die Spalte status hinzufügt, und zeigen Sie mir das SQL, bevor Sie sie anwenden.
- Gehen Sie die Logs der letzten Stunde durch und finden Sie heraus, warum die Funktion signup Fehler zurückgibt.
- Erzeugen Sie TypeScript-Typen für das aktuelle Datenbankschema.
- Wie viele Nutzer haben sich in den letzten zwei Monaten pro Woche registriert?
Werkzeuge des Servers
- list_tables
- list_extensions
- list_migrations
- apply_migration
- execute_sql
- query_logs
- get_advisors
- get_project_url
- get_publishable_keys
- generate_typescript_types
- list_edge_functions
- get_edge_function
- deploy_edge_function
- list_projects
- get_project
- create_project
- search_docs
- create_branch
- list_branches
- merge_branch
So verbinden Sie Supabase
- Legen Sie zuerst die Grenzen fest. Supabase empfiehlt ein einzelnes Projekt und den Nur-Lese-Modus, zum Beispiel die Adresse https://mcp.supabase.com/mcp?project_ref=<projekt-id>&read_only=true.
- Tragen Sie die Adresse als MCP-Server in Ihrem Client ein. Supabase beschreibt die Einrichtung unter anderem für Claude, ChatGPT, Cursor, VS Code, Claude Code und Codex.
- Melden Sie sich im geöffneten Browserfenster bei Supabase an und wählen Sie die Organisation. Ein persönliches Zugriffstoken ist nicht nötig.
- Lassen Sie die manuelle Freigabe von Tool-Aufrufen im Client eingeschaltet und prüfen Sie jeden Aufruf, bevor er läuft.
- Für CI ohne Browser: Erstellen Sie ein persönliches Zugriffstoken mit möglichst wenigen Rechten und senden Sie es im Header Authorization: Bearer.
Enthalten in diesen Paketen
Supabase ist in diesen Walma-Paketen enthalten.
Fragen zu Supabase MCP
Ist der Supabase MCP-Server kostenlos?+
Supabase nennt keinen Preis für den Server und gibt auch nicht an, dass er einen bestimmten Tarif voraussetzt. Die Branching-Tools sind experimentell und erfordern einen bezahlten Tarif. Will der Assistent ein Projekt oder einen Branch anlegen, was Geld kosten kann, fragt der Server zuerst nach einer Bestätigung der Kosten.
Wie lautet die URL des Supabase MCP-Servers?+
Der gehostete Server hat die Adresse https://mcp.supabase.com/mcp. Wenn Sie Supabase lokal mit der Supabase CLI betreiben, liegt der Server unter http://localhost:54321/mcp. Der Quellcode steht auf github.com/supabase/mcp. Einstellungen wie Projekt, Nur-Lese-Modus und Tool-Gruppen werden als Parameter an die Adresse angehängt.
Wie funktioniert die Anmeldung?+
Standardmäßig per OAuth: Sie melden sich im Browser bei Supabase an und wählen eine Organisation, der Client registriert sich selbst. Ein persönliches Zugriffstoken ist nicht nötig. Für CI erstellen Sie ein Token und senden es in einem Authorization-Header. Clients, die Client-ID und Secret verlangen, können eine manuell angelegte OAuth-App verwenden.
Ist der Server schreibgeschützt oder kann er die Datenbank ändern?+
Ohne Einstellungen kann er schreiben: SQL ausführen, Migrationen anwenden, Edge Functions bereitstellen und Projekte anlegen. Mit read_only=true in der Adresse laufen alle Abfragen als schreibgeschützter Postgres-Nutzer. Außerhalb des Nur-Lese-Modus fragt der Server vor destruktivem SQL nach einer Bestätigung, laut Supabase ist das jedoch eine Schutzmaßnahme und keine Garantie für eine menschliche Prüfung.
Mit welchen KI-Assistenten funktioniert er?+
Supabase dokumentiert unter anderem Claude.ai, ChatGPT und Goose im Web, Cursor, VS Code, Antigravity, Kiro und Warp als Editoren sowie Claude Code, Codex, Gemini CLI, GitHub Copilot und OpenCode. Nicht jeder Client unterstützt eigene Header, was eine Rolle spielt, wenn Sie sich mit einem Token anmelden möchten.
Ist es sicher, den Server mit einer Produktivdatenbank zu verbinden?+
Supabase rät, Produktivdaten nur bei Bedarf anzubinden, und dann mit einem einzelnen Projekt, Nur-Lese-Modus, wenigen Tool-Gruppen und eng gefassten Abfragen. Der Grund: Inhalte in den Daten, etwa ein Support-Ticket, können Anweisungen enthalten, die den Assistenten täuschen. SQL-Ergebnisse werden dagegen gekennzeichnet, laut Supabase ist dieser Schutz aber nicht lückenlos.
Wie begrenzt man, welche Tools der Assistent erhält?+
Mit dem Parameter features in der Adresse, zum Beispiel features=database,docs, werden nur diese Gruppen geladen. Die Gruppen sind Datenbank, Fehlersuche, Entwicklung, Edge Functions, Kontoverwaltung, Dokumentation, Branching und Storage, wobei Storage von Anfang an abgeschaltet ist. Der Parameter project_ref bindet den Server an ein Projekt und schaltet zugleich die Konto-Tools ab, etwa das Anlegen und Pausieren von Projekten.
Fehlt Ihnen eine Anbindung?
Wir bauen und prüfen MCP-Server für Teams, die sie brauchen, und betreiben sie hinter derselben Richtlinie und demselben Protokoll wie das restliche Gateway.