Supabase — MCP-сервер для Claude Code: что делает и как установить
Подключает проекты Supabase к ИИ-ассистентам по протоколу MCP. Помогает проверять конфигурацию и запрашивать данные из таблиц.
claude mcp add --transport http mcp https://mcp.supabase.com/mcpЧто делает Supabase
Сервер связывает ассистента с облачным или локальным окружением Supabase по HTTP либо через stdio с помощью пакета @supabase/mcp-server-supabase. Модель получает прямой доступ к базе данных. Она может проверять структуру таблиц и запрашивать строки без ручного копирования дампа.
Параметр read_only=true в строке подключения исключает мутации данных, а фильтр features оставляет только нужные группы инструментов. При локальной работе через Supabase CLI или на собственном сервере авторизация OAuth 2.1 недоступна, а набор инструментов ограничен по сравнению с облаком.
Пакет также позволяет встроить инструменты в Vercel AI SDK через функцию createToolSchemas или запустить собственный HTTP-обработчик. Сервер не возвращает блок structuredContent, поэтому клиенты разбирают JSON прямо из текстового ответа.
Какие задачи решает
- читать схему и структуру таблиц в проекте Supabase
- выполнять проверочные SQL-запросы к базе через ассистента
- ограничивать доступ модели безопасным режимом чтения
- получать конфигурационные параметры проектов
Примеры запросов агенту
- Покажи схему таблицы users и внешние ключи в моём проекте Supabase.
- Выгрузи последние 10 записей со статусом pending из таблицы заказов.
- Подключись к проекту Supabase в режиме read-only и перечисли таблицы.
Как установить Supabase
1Командой платформы: удалённый сервер
claude mcp add --transport http mcp https://mcp.supabase.com/mcp2Командой платформы
claude mcp add --env SUPABASE_ACCESS_TOKEN=<SUPABASE_ACCESS_TOKEN> --transport stdio mcp-server-supabase -- npx -y @supabase/mcp-server-supabaseВместо <…> подставьте свои значения
1Командой платформы: удалённый сервер
codex mcp add mcp-server-supabase --url https://mcp.supabase.com/mcp2Командой платформы
codex mcp add mcp-server-supabase --env SUPABASE_ACCESS_TOKEN=<SUPABASE_ACCESS_TOKEN> -- npx -y @supabase/mcp-server-supabaseВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"mcp-server-supabase": {
"url": "https://mcp.supabase.com/mcp"
}
}
}{
"mcpServers": {
"mcp-server-supabase": {
"command": "npx",
"args": [
"-y",
"@supabase/mcp-server-supabase"
],
"env": {
"SUPABASE_ACCESS_TOKEN": "<SUPABASE_ACCESS_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"mcp-server-supabase": {
"type": "http",
"url": "https://mcp.supabase.com/mcp"
}
}
}{
"servers": {
"mcp-server-supabase": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@supabase/mcp-server-supabase"
],
"env": {
"SUPABASE_ACCESS_TOKEN": "<SUPABASE_ACCESS_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
1Командой платформы: удалённый сервер
gemini mcp add -t http mcp-server-supabase https://mcp.supabase.com/mcp2Командой платформы
gemini mcp add -e SUPABASE_ACCESS_TOKEN=<SUPABASE_ACCESS_TOKEN> mcp-server-supabase npx -y @supabase/mcp-server-supabaseВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Supabase
Как установить Supabase в Claude Code?
Выполните в терминале команду подключения по HTTP: claude mcp add --transport http mcp https://mcp.supabase.com/mcp. Для локального запуска через stdio используйте: claude mcp add --env SUPABASE_ACCESS_TOKEN=<SUPABASE_ACCESS_TOKEN> --transport stdio mcp-server-supabase -- npx -y @supabase/mcp-server-supabase.
Что делает MCP-сервер Supabase?
Он предоставляет языковым моделям инструменты для работы с вашим проектом в Supabase. Ассистент сможет изучать схему данных, отправлять запросы к таблицам и читать параметры окружения.
Чем отличается запуск через Supabase CLI от облачного сервера?
Локальный эндпоинт http://localhost:54321/mcp не поддерживает OAuth 2.1. В CLI и self-hosted инсталляциях набор доступных инструментов урезан.
