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.

Wymagania

• Serwer zdalny działa po HTTP — przy pierwszym połączeniu logujesz się przez przeglądarkę (OAuth), więc nie musisz ręcznie generować tokenu ani instalować Node.js.
• Personal access token z panelu Supabase (Settings → Access Tokens → Create new token) przyda się tylko do CI i scenariuszy nieinteraktywnych.
• Project ref bazy: Settings → General → Reference ID — wstawiasz go do URL jako project_ref.
• Przy lokalnym developmencie z Supabase CLI serwer MCP jest dostępny pod http://localhost:54321/mcp — bez tokenu i project-ref, ale z węższym zestawem narzędzi i bez OAuth.

Instalacja serwera

Podstawową metodą w dokumentacji jest zdalny (hosted) serwer MCP — dodajesz go jednym poleceniem, bez lokalnego procesu npx:

claude mcp add --transport http supabase https://mcp.supabase.com/mcp

Zakres 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"

Alternatywa — przez Claude Desktop

Możesz też wpisać serwer wprost w pliku konfiguracyjnym (Claude Desktop albo plik MCP Claude Code). Dla wariantu hosted to zwykły wpis HTTP — bez procesu npx (klamry zakodowane encjami, w realnym pliku JSON użyj zwykłych nawiasów):

{
  "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 nieinteraktywnym uwierzytelnianiu tokenem (np. CI). Przy zwykłej pracy z terminala wystarczy claude mcp add --transport http i logowanie OAuth przy pierwszym połączeniu.

Weryfikacja

Sprawdź, czy agent widzi bazę, prostym poleceniem:

pokaz mi wszystkie tabele w bazie danych

Claude Code powinno wyświetlić listę tabel z Twojego projektu Supabase.

Przykładowe komendy

• „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).