Supabase MCP

supabase/mcp· Проверено 12.11.2026· 3 тыс.на GitHub

Подключает агента к проектам Supabase: смотреть таблицы, выполнять SQL и миграции, читать логи и советы по безопасности, разворачивать Edge Functions и работать с ветками базы.

2 реализации:

Сервер на стороне Supabase, вход через аккаунт Supabase; адрес можно сузить до одного проекта, режима только чтения и нужных групп инструментов.

Как подключить

Что сделать до подключения

Аккаунт Supabase; при входе выберите организацию, где лежит нужный проект

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

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

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.supabase]
url = "https://mcp.supabase.com/mcp"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

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

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

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

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "supabase": {
      "httpUrl": "https://mcp.supabase.com/mcp"
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "supabase": {
      "httpUrl": "https://mcp.supabase.com/mcp"
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "supabase": {
        "type": "remote",
        "url": "https://mcp.supabase.com/mcp"
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

Customize → Connectors → добавить свой коннектор.
Адрес сервера: https://mcp.supabase.com/mcp

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

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

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

list_projectsпоказывает проекты

get_projectпоказывает сведения о проекте

list_tablesпоказывает таблицы и колонки

execute_sqlвыполняет SQL

apply_migrationприменяет миграцию

list_migrationsпоказывает миграции

list_extensionsпоказывает расширения базы

get_logsчитает логи сервиса

get_advisorsпоказывает советы по безопасности и скорости

generate_typescript_typesгенерирует типы TypeScript

get_project_urlдаёт адрес API проекта

get_publishable_keysдаёт публичные ключи

list_edge_functionsпоказывает Edge Functions

deploy_edge_functionразворачивает Edge Function

create_branchсоздаёт ветку базы

merge_branchсливает ветку в основную

list_storage_bucketsпоказывает бакеты хранилища

create_projectсоздаёт проект

get_costпоказывает стоимость проекта или ветки

search_docsищет в документации Supabase

Для локальной разработки: встроен в Supabase CLI и работает с локальной базой, инструментов меньше и OAuth нет.

Как подключить

Что сделать до подключения

Supabase CLI с запущенным локальным Supabase

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport http mcp http://localhost:54321/mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.mcp]
url = "http://localhost:54321/mcp"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "mcp": {
      "url": "http://localhost:54321/mcp"
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "http://localhost:54321/mcp"
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "mcp": {
      "httpUrl": "http://localhost:54321/mcp"
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "mcp": {
      "httpUrl": "http://localhost:54321/mcp"
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "mcp": {
        "type": "remote",
        "url": "http://localhost:54321/mcp"
      }
    }
  }
}

Customize → Connectors → добавить свой коннектор.
Адрес сервера: http://localhost:54321/mcp

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "mcp": {
      "url": "http://localhost:54321/mcp"
    }
  }
}

Что попросить агента

«Какие таблицы есть в проекте <проект> и как они связаны?»Агент вызовет list_projects, затем list_tables с подробностями о колонках и внешних ключах

«Добавь таблицу <название> с полями <поля> и включи RLS»Агент вызовет apply_migration с DDL-запросом

«Проверь проект на проблемы безопасности»Агент вызовет get_advisors и покажет найденное со ссылками на исправление

«Почему вчера с 10 до 11 падали запросы к API?»Агент вызовет get_logs для сервиса API с началом и концом отрезка

«Сгенерируй типы TypeScript для моей базы»Агент вызовет generate_typescript_types

Для каких задач

Посмотреть схему базы и выполнить запрос к данным

Создать таблицу или изменить схему миграцией

Найти уязвимости и медленные места по советам get_advisors

Прочитать логи API, базы или функций за нужный отрезок времени

Сгенерировать типы TypeScript по схеме базы

Развернуть Edge Function и проверить изменения в отдельной ветке базы

Ограничения

Агент получает доступ к вашим проектам Supabase: перед подключением Supabase советует прочитать раздел о рисках безопасности

Ответы execute_sql могут содержать чужие данные с внедрёнными командами; разрушительные запросы требуют подтверждения

В Supabase CLI и на своём сервере Supabase доступна только часть инструментов и нет OAuth

Создание проекта или ветки может стоить денег: сервер показывает стоимость через get_cost и просит подтвердить

Если не работает

Агент не видит нужный проект

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

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Supabase MCP Serverразработчик сервиса	Supabase	3 тыс.	HTTP	вход	20	12 ноября 2026
Supabase MCP в Supabase CLIразработчик сервиса	Supabase	3 тыс.	HTTP	не нужен	—	12 ноября 2026

Частые вопросы

Как ограничить агента одним проектом и только чтением?

Добавьте параметры к адресу: https://mcp.supabase.com/mcp?project_ref=<ref проекта>&read_only=true. Параметр features=database,docs оставит только нужные группы инструментов.

Нужен ли токен доступа?

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

Где полный список инструментов и настроек?

На supabase.com/mcp: там же есть конструктор адреса, который подставляет параметры подключения.

Работает ли со своим сервером Supabase?

Да, включите MCP по инструкции Enabling MCP server для self-hosted Supabase. Там доступна только часть инструментов и нет OAuth 2.1.

Работает ли сервер из России?

Удалённый сервер работает на mcp.supabase.com с вашим аккаунтом Supabase; для локальной базы есть вариант в Supabase CLI.

Supabase MCP

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы