MCP Supabase: agent na Waszej bazie — z trybem read-only.

Supabase to otwarta platforma oparta o PostgreSQL — z autentykacją, REST i GraphQL API, storage, Row Level Security i panelem zarządzania. Serwer MCP Supabase pozwala Claude Code sięgać do tej bazy bezpośrednio z promptu — bez przełączania się między terminalem, panelem i klientem SQL.

Dokumentacja MCP Supabase opisuje dziś przede wszystkim serwer zdalny (hosted) — nie stawiasz żadnego lokalnego procesu, a cały zakres uprawnień ustawiasz parametrami w samym adresie serwera: tryb tylko do odczytu, ograniczenie do jednego projektu, wybór grup narzędzi. To ważne, bo bez ograniczenia zakresu serwer widzi wszystkie projekty w organizacji.

Co agent robi na bazie

• „Pokaż wszystkie tabele w bazie danych" — listowanie schematu.
• „Sprawdź, czy istnieją duplikaty w tabeli X" — analiza i debugging (tylko odczyt).
• „Wygeneruj typy TypeScript dla wszystkich tabel" — automatyczne generowanie typów.
• „Utwórz migrację dodającą kolumnę created_at" — zarządzanie migracjami (poza trybem read-only).

Zakres serwera ustawiasz parametrami w URL — to dziś jedyny zalecany sposób konfiguracji. Tryb tylko do odczytu i ograniczenie do jednego projektu trzymaj włączone domyślnie:

claude mcp add --transport http supabase \
  "https://mcp.supabase.com/mcp?project_ref=TWOJ_PROJECT_REF&read_only=true"

Project ref bazy znajdziesz w panelu: Settings → General → Reference ID. W trybie tylko do odczytu narzędzia zapisu (m.in. apply_migration i deploy_edge_function) znikają z listy, a execute_sql działa jako użytkownik Postgresa bez prawa zapisu.

Mniej narzędzi dla agenta

Parametrem features ograniczasz zestaw narzędzi udostępnionych agentowi — np. ?features=database,docs zostawia tylko zapytania do bazy i wyszukiwanie w dokumentacji. Domyślnie aktywne są grupy account, database, debugging, development, docs, functions i branching; storage jest wyłączone.

CI i wpis w pliku konfiguracyjnym

W scenariuszach nieinteraktywnych (np. CI) interaktywne logowanie odpada — personal access token generujesz w panelu Supabase (Settings → Access Tokens → Create new token) i podajesz nagłówkiem Authorization. Wpis w pliku konfiguracyjnym (Claude Desktop albo plik MCP Claude Code) to zwykły serwer HTTP:

{
  "mcpServers": {
    "supabase": {
      "type": "http",
      "url": "https://mcp.supabase.com/mcp?project_ref=${SUPABASE_PROJECT_REF}&read_only=true",
      "headers": {
        "Authorization": "Bearer ${SUPABASE_ACCESS_TOKEN}"
      }
    }
  }
}

Nagłówek Authorization jest potrzebny tylko przy uwierzytelnianiu tokenem — przy zwykłej pracy z terminala wystarczy logowanie przy pierwszym połączeniu.