Supabase MCP Server: in fünf Minuten sicher verbunden
Supabase MCP Server
Supabase MCP Server: Einrichtung, Read-Only-Modus und Sicherheit | We.Inc
Verbinde ein KI-Coding-Tool mit dem offiziellen MCP-Server von Supabase: die Server-URL, die Optionen read_only und project_ref, Feature-Gruppen, Tools und die Sicherheitshinweise.
Mit dem Supabase MCP Server kann ein KI-Coding-Assistent über einen einzigen Link deine Tabellen lesen, SQL ausführen, Logs prüfen und Funktionen deployen: https://mcp.supabase.com/mcp. Hänge ?read_only=true an, damit Abfragen keine Daten ändern können, und ?project_ref=, damit er nur ein Projekt erreicht, und bestätige weiterhin jeden Tool-Aufruf von Hand.
Von Supabase dokumentierte URL-Optionen
Option
Was sie bewirkt
read_only=true
Führt jede Abfrage als schreibgeschützter Postgres-Nutzer aus
project_ref=<id>
Beschränkt den Zugriff auf ein Projekt und schaltet die Konto-Tools ab
features=database,docs
Schaltet nur die genannten Tool-Gruppen ein; storage ist standardmäßig aus
Lokale URL
MCP, das Model Context Protocol, ist ein Standard, über den eine KI-App externe Tools aufruft. Bau unten deinen Verbindungslink: Wähle ein Projekt, den Read-Only-Modus und die Tool-Gruppen und kopiere dann die Konfiguration. Nichts verlässt deinen Browser.
Such im Supabase-Dashboard in den Einstellungen des Projekts nach deiner Project Reference ID.
Bau den Link mit den gewünschten Optionen und füge das JSON in die Einstellungsdatei deines MCP-Clients ein.
Beim ersten Einsatz öffnet der Client ein Browserfenster: Melde dich bei Supabase an, wähle die Organisation und erlaube den Zugriff.
Für CI oder einen Rechner ohne Browser erstellst du ein eingeschränktes persönliches Zugriffstoken und sendest es als Header Authorization: Bearer.
Richte ihn auf ein Entwicklungsprojekt, nicht auf deinen Live-Shop. Supabase rät, nur dann mit Produktion zu verbinden, wenn die Aufgabe es wirklich erfordert.
Achte auf Prompt Injection: Text in deinen Tabellen, etwa ein Support-Ticket, kann Anweisungen enthalten, die den Assistenten zu einer schädlichen Abfrage verleiten.
Betrachte ihn als Tool für deine eigenen Entwickler. Laut Supabase trägt er deine Berechtigungen und sollte nicht an Kunden weitergegeben werden.
Erlaube bei unbeaufsichtigten Jobs nur projektbezogene, schreibgeschützte Tools und lass den Job berichten statt schreiben.
Nutze Branching, um Schemaänderungen abseits der Produktion auszuprobieren. Supabase kennzeichnet die Branching-Tools als experimentell und nur in kostenpflichtigen Tarifen verfügbar.
Häufige Fragen
Was kann der Supabase MCP Server?
Seine dokumentierten Tools listen Tabellen und Migrationen auf, wenden Migrationen an, führen SQL aus, fragen Logs ab, lesen die Sicherheits- und Performance-Advisors, erzeugen TypeScript-Typen, verwalten Edge Functions, durchsuchen die Dokumentation und verwalten, sofern nicht eingeschränkt, Projekte.
Ist der Read-Only-Modus sicher genug?
Er verhindert Schreibvorgänge, weil Abfragen als schreibgeschützter Datenbanknutzer laufen, aber der Assistent kann weiterhin alles lesen, was dieser Nutzer lesen darf. Kombiniere ihn mit project_ref und halte personenbezogene Daten aus deinen Anfragen heraus.
Brauche ich ein Zugriffstoken?
Nicht mit der Standardanmeldung des gehosteten Servers, die einen Browser-Login nutzt. Ein persönliches Zugriffstoken brauchst du nur für CI oder Headless-Setups, und nicht jeder Client unterstützt eigene Header.
Welche Feature-Gruppen gibt es?
Der Server-Code listet docs, account, database, debugging, development, functions, branching, storage und notebooks. Laut Supabase-Dokumentation ist jede Gruppe außer storage standardmäßig aktiv.
Können die Besucher meiner Website ihn nutzen?
Nein. Er läuft mit deinen Entwicklerberechtigungen, deshalb empfiehlt Supabase, ihn als internes Tool zu behalten und nicht für Endnutzer erreichbar zu machen.
Was jede Tool-Gruppe abdeckt
database: list_tables, list_extensions, list_migrations, apply_migration und execute_sql. debugging: query_logs und get_advisors. development: get_project_url, get_publishable_keys und generate_typescript_types.
functions umfasst das Auflisten, Lesen und Deployen von Edge Functions sowie das Setzen ihrer Secrets. docs enthält search_docs. account enthält Projekt- und Organisations-Tools, darunter create_project und pause_project, und wird abgeschaltet, wenn du auf ein Projekt einschränkst.
Eine sichere Startkonfiguration
Auf ein Projekt beschränkt, schreibgeschützt, nur mit den Tools database und docs. Setze deine eigene Reference ID ein.
Eingeschränkte, schreibgeschützte Verbindung
Die meisten Clients lesen ein mcpServers-Objekt wie dieses; der Dateiname hängt vom Client ab.
Verbindungs-Builder
Project Reference ID (optional, aber empfohlen)
deine Project Ref
Read-Only-Modus
Tool-Gruppen
Server-Link
Konfigurations-JSON (zum Beispiel .cursor/mcp.json)
Kopieren
Kopiert
Wähle mindestens eine Tool-Gruppe.
Die Gruppe account wird ignoriert, sobald du eine Project Reference setzt.