Supabase MCP Server

Что умеет сервер

Это официальный MCP-сервер Supabase, репозиторий которого переехал из сообщества supabase-community в организацию supabase. Основной способ подключения не требует ничего устанавливать: клиент обращается к размещённому серверу Supabase и открывает окно входа, личный токен доступа для этого не нужен. Сервер связывает ассистентов Cursor, Claude, Windsurf и других с вашими проектами Supabase.

Инструменты разбиты на группы. В группе database есть список таблиц и расширений Postgres, список и применение миграций и выполнение SQL. Группа debugging читает журналы проекта SQL-запросом и выдаёт советы по безопасности и производительности. Группа development возвращает адрес API, публичные ключи и генерирует типы TypeScript по схеме. Остальные группы покрывают Edge Functions, управление проектами и организациями, поиск по документации и ветвление базы (экспериментальная возможность, нужен платный тариф). Группа storage по умолчанию выключена, остальные включены.

Когда использовать

Подключайте сервер на этапе разработки приложения на Supabase: попросить агента показать таблицы, составить и применить миграцию, сгенерировать типы TypeScript или изучить журналы проекта. Сервер можно поднять и для локального Supabase из Supabase CLI, и для собственного (self-hosted) развёртывания, но в обоих случаях доступен только ограниченный набор инструментов и нет OAuth 2.1.

Ограничения и безопасность

Документация Supabase прямо предупреждает о рисках: прежде всего это prompt injection. Если в таблице лежит пользовательский текст с вредными инструкциями, а агент с вашими правами читает его, он может выполнить запрос и раскрыть чувствительные данные. Supabase оборачивает результаты SQL в дополнительные инструкции для модели, но гарантией это не считается, поэтому проверяйте вызовы инструментов вручную.

Рекомендации разработчиков такие: подключайте боевой проект только если задача действительно требует данных из него, ограничивайте сервер одним проектом (параметр project_ref), включайте режим read_only=true, при котором SQL выполняется от имени пользователя Postgres с правом чтения, и отключайте ненужные группы параметром features. Не давайте сервер своим клиентам и конечным пользователям: он работает с вашими правами разработчика. Для проверки миграций используйте ветвление и не применяйте их сразу к продакшену. Создание проектов и веток, влекущее расходы, сопровождается подтверждением стоимости, но документация называет его защитой, а не гарантией проверки человеком.

Общая конфигурация

Большинству клиентов нужны такие данные. Если вашего клиента нет в документации Supabase, скопируйте их в формат, который он ожидает:

{
  "mcpServers": {
    "supabase": {
      "type": "http",
      "url": "https://mcp.supabase.com/mcp"
    }
  }
}

При настройке клиент предложит войти в Supabase. Выберите организацию, в которой лежит нужный проект.

Claude Code

Добавьте сервер командой:

claude mcp add --scope project --transport http supabase "https://mcp.supabase.com/mcp?features=docs%2Caccount%2Cdatabase%2Cdebugging%2Cdevelopment%2Cfunctions%2Cbranching"

Либо внесите в .mcp.json такую конфигурацию:

{
  "mcpServers": {
    "supabase": {
      "type": "http",
      "url": "https://mcp.supabase.com/mcp?features=docs%2Caccount%2Cdatabase%2Cdebugging%2Cdevelopment%2Cfunctions%2Cbranching"
    }
  }
}

Затем в обычном терминале (не в расширении для IDE) выполните claude /mcp, выберите сервер supabase и пункт Authenticate.

Параметры адреса

К адресу сервера можно добавлять параметры, их можно сочетать:

https://mcp.supabase.com/mcp?project_ref=abc123&read_only=true

• ●read_only=true: выполнять все запросы от имени пользователя Postgres только с правом чтения;
• ●project_ref=<id>: ограничить сервер одним проектом (отключает инструменты уровня аккаунта);
• ●features=<группы>: включить только перечисленные группы инструментов, например ?features=database,docs.

CI без браузера

В среде, где вход через браузер невозможен, создайте токен доступа Supabase с минимально нужными правами и передайте его в заголовке:

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

Локальный Supabase

Если вы запускаете Supabase через Supabase CLI, сервер доступен по адресу http://localhost:54321/mcp.