Supabase über MCP mit Gemini verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Supabase klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Supabase + Gemini

Lass deine KI deine Supabase-Projekte betreuen: Projekte auflisten und ihren Zustand prüfen, Schemas und Tabellen erkunden, schreibgeschütztes SQL ausführen, Logs, Sicherheits- und Performance-Advisors, Edge Functions, Migrationen, Branches und Storage-Buckets lesen. Über die Management API mit einem persönlichen Access-Token.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

SUPABASE_ACCESS_TOKEN

Schritt 1 — Zugangsdaten holen

1. Öffne im Supabase-Dashboard das Kontomenü → Account preferences → Access Tokens (oder direkt https://supabase.com/dashboard/account/tokens) und klicke auf Generate new token.
2. Nimm am besten einen scoped token: Wähle die Organisation und die Projekte, die die KI sehen darf, und gib jeder Fähigkeit Read (oder Read-write nur dort, wo sie etwas ändern soll). Die Tools hier nutzen Projects, Project Settings, Database, Migrations, Backups, Edge Functions, API Keys (nicht API Key Secrets), Logs, Usage Analytics, Advisors, Storage, Development Branches und Organizations.
3. Leg ein Ablaufdatum fest (höchstens ein Jahr) und kopiere den Token. Er beginnt mit sbp_, und Supabase zeigt ihn nur einmal an.
4. Trage den Token ohne das Wort Bearer in SUPABASE_ACCESS_TOKEN ein, dann installiere den Connector.
5. Beginne mit supabase_list_projects: Das Tool listet jedes Projekt auf, das der Token erreicht, mit Status und Ref. Die Ref (die 20 Kleinbuchstaben in https://<ref>.supabase.co) brauchen alle anderen Tools.

Zugriff später ändern: Die Rechte eines Tokens lassen sich nach dem Erstellen nicht mehr ändern. Willst du sie erweitern oder einschränken, erstelle einen neuen Token und lösche den alten. Ein Legacy-Token (ohne Scopes) hat dagegen deinen vollen Zugriff auf alle Organisationen.

Nur lesen: Gib einem scoped token auf jeder Fähigkeit nur Read. Steht Database auf Read, führt selbst supabase_execute_sql sein SQL nur lesend aus. Kein anderes Tool ändert Daten: Alltägliche Fragen laufen über supabase_run_read_only_sql, das eine Anweisung als schreibgeschützter Datenbanknutzer ausführt und Ergebnisse über 200 KB abschneidet.

Bei der Installation ausgeschaltet: supabase_execute_sql. Das Tool führt SQL als postgres mit vollen Rechten aus, DDL, Schreibzugriffe und Grants wirken also sofort und lassen sich nicht rückgängig machen. Schalte es nur ein, wenn die KI die Datenbank ändern soll; sie zeigt dir jede Anweisung und wartet auf deine Bestätigung. Für Schemaänderungen, die in die Versionsverwaltung gehören, ist dein eigener Migrations-Workflow der bessere Ort.

Die Sicht des Projektinhabers: Der Connector arbeitet über die Supabase Management API, nicht als App-Nutzer. Er geht also nicht über die REST-API deines Projekts oder über Row Level Security. supabase_list_api_keys nennt jeden Key, zeigt aber nur den Wert der öffentlichen; Secret Keys und der alte service_role-Key werden bewusst ohne Wert aufgeführt, und kein Tool gibt sie preis. Auch der Code von Edge Functions wird nicht heruntergeladen.

Pausierte Projekte: Free-Projekte pausieren nach einer Woche ohne Aktivität und zeigen dann den Status INACTIVE. Datenbank-Tools schlagen fehl, bis du das Projekt im Dashboard wiederherstellst. Meldet eine App Fehler, führe zuerst supabase_get_project_health aus.

Logs und Advisors: supabase_query_logs durchsucht ohne Zeitraum nur die letzte Minute; ein Zeitraum darf höchstens 24 Stunden umfassen und muss in der Log-Aufbewahrung deines Plans liegen (1 Tag bei Free, 7 bei Pro, 28 bei Team). supabase_get_security_advisors und supabase_get_performance_advisors führen dieselben Prüfungen aus wie die Seite Advisors im Dashboard; behebe ERROR-Befunde zuerst, vor allem Tabellen, die ohne Row Level Security offenliegen. Preview-Branches (supabase_list_branches) brauchen einen kostenpflichtigen Plan.

Limits: Supabase erlaubt 120 Management-API-Anfragen pro Minute je Nutzer und Endpunkt (alle Tokens eines Nutzers teilen sich das Limit) und 30 pro Minute für Logs und Nutzungsdaten. Darüber antwortet Supabase für den Rest der Minute mit 429: Warte eine Minute und versuche es erneut.

Häufige Fehler: 401 „Invalid access token“ heißt, dass der Token falsch oder abgelaufen ist oder gelöscht wurde: Erstelle unter Access Tokens einen neuen. 403 heißt, dass der Token das nicht darf: Ein scoped token nennt in missing_permissions, was fehlt, also erstelle einen neuen Token, der es enthält. 404 ist eine unbekannte Projekt-Ref oder ein Projekt außerhalb der Organisationen des Tokens. 402 bei Logs heißt, dass das Nutzungskontingent der Organisation aufgebraucht ist. Eine fehlerhafte SQL-Anweisung kommt mit der Meldung von Postgres zurück, zum Beispiel „relation "orders" does not exist“, wenn eine Tabelle nicht mit ihrem Schema angegeben ist (public.orders).

Der Connector legt keine Projekte an, pausiert, stellt wieder her oder löscht keine, deployt keine Edge Functions, verwaltet keine Secrets, Auth-Konfiguration, Custom Domains, Netzwerkbeschränkungen oder Abrechnung und liest die Tabellen deiner App nicht über PostgREST.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Gemini hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die Supabase-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Welche meiner Supabase-Projekte laufen gerade nicht sauber, und was ist bei ihnen los?“
• „Lass den Security Advisor über das Projekt Acme Shop laufen und sag mir, welche Tabellen ohne Row Level Security offenliegen.“
• „Wie viele Bestellungen wurden letzte Woche pro Tag in public.orders im Projekt Acme Shop angelegt?“
• „Zeig mir die Postgres-Fehler der letzten Stunde in den Logs von Acme Shop und erklär mir, woher sie kommen.“

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Meta Muse verbinden