Настройка MCP для Supabase - подключаем ИИ-инструменты к вашим проектам

Современная разработка приложений с использованием Supabase становится ещё эффективнее благодаря интеграции с ИИ-ассистентами через протокол MCP (Model Context Protocol). Эта технология позволяет подключать ваши Supabase проекты к различным ИИ-инструментам, таким как Cursor IDE, Windsurf (Codium), VS Code (Copilot) и другим.

Это руководство подготовлено на основе официальной англоязычной документации Supabase

Что такое MCP для Supabase?

Model Context Protocol (MCP) - это стандарт для подключения больших языковых моделей (LLM) к платформам, таким как Supabase. Это позволяет вашим ИИ-ассистентам напрямую взаимодействовать с базами данных, выполнять запросы и управлять проектами Supabase от вашего имени.

Преимущества использования MCP с Supabase

• 🔍 Прямой доступ к данным - ИИ-ассистент может читать структуру таблиц и данные
• 🛠️ Управление проектами - создание таблиц, миграций и функций через естественный язык
• 📊 Анализ схемы базы данных - получение рекомендаций по оптимизации структуры
• 🔄 Быстрое прототипирование - ускорение разработки благодаря автоматизации задач

Настройка Supabase MCP

Шаг 1: Создание персонального токена доступа (PAT)

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

1. Войдите в свой аккаунт на Supabase
2. Перейдите в раздел настроек вашего профиля
3. Выберите "Access Tokens"
4. Нажмите кнопку "Generate New Token"
5. Дайте токену имя, которое описывает его назначение (например, "Cursor MCP Server")
6. Скопируйте созданный токен - он понадобится для настройки MCP-сервера

⚠️ Важно: Сохраните токен в безопасном месте, так как он предоставляет доступ к вашим проектам Supabase.

Шаг 2: Настройка MCP в ИИ-инструментах

Настройка в Cursor IDE

1. Откройте Cursor IDE и создайте директорию .cursor в корне вашего проекта, если она не существует
2. Создайте файл .cursor/mcp.json, если он не существует, и откройте его
3. Добавьте следующую конфигурацию:

{
  "mcpServers": {
    "supabase": {
      "command": "npx",
      "args": [
        "-y",
        "@supabase/mcp-server-supabase@latest",
        "--access-token",
        "<personal-access-token>"
      ]
    }
  }
}

Замените <personal-access-token> на ваш персональный токен доступа Supabase.

1. Сохраните конфигурационный файл
2. Откройте Cursor IDE и перейдите в Settings/MCP. После успешного подключения сервера вы увидите зеленый статус активности

Настройка в других инструментах

Для других ИИ-инструментов процедура настройки аналогична:

Windsurf (Codium):

{
  "mcpServers": {
    "supabase": {
      "command": "npx",
      "args": [
        "-y",
        "@supabase/mcp-server-supabase@latest",
        "--access-token",
        "<personal-access-token>"
      ]
    }
  }
}

Claude Desktop:

{
  "mcpServers": {
    "supabase": {
      "command": "npx",
      "args": [
        "-y",
        "@supabase/mcp-server-supabase@latest",
        "--access-token",
        "<personal-access-token>"
      ]
    }
  }
}

MCP для локальных экземпляров Supabase

Если вы используете локальный экземпляр Supabase, вы можете подключиться к нему с помощью Postgres MCP-сервера. Этот MCP-сервер выполняет все запросы как транзакции только для чтения.

Шаг 1: Найдите строку подключения к базе данных

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

supabase status

или если вы используете npx:

npx supabase status

Это выведет список сведений о вашем локальном экземпляре Supabase. Скопируйте поле DB URL из вывода.

Шаг 2: Настройте MCP-сервер

Настройте вашего клиента следующим образом:

{
  "mcpServers": {
    "supabase": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "<connection-string>"]
    }
  }
}

Замените <connection-string> на вашу строку подключения.

Примеры использования

После успешной настройки MCP-сервера вы можете начать взаимодействовать с вашими проектами Supabase через ИИ-ассистента. Вот несколько примеров того, что вы можете делать:

Просмотр таблиц

Use Supabase

Покажи мне все таблицы в схеме public моего проекта Supabase и их структуру.

Просмотр данных

Use Supabase

Выведи по 3 записи данных в каждой существующей таблицы в public

Заключение

Интеграция Supabase с ИИ-инструментами через MCP значительно упрощает разработку и управление базами данных. Вы можете использовать естественный язык для взаимодействия с вашими проектами, что ускоряет процесс разработки и делает его более интуитивным.

MCP-сервер для Supabase открывает новые возможности для автоматизации задач, анализа данных и быстрого прототипирования, что делает разработку более эффективной и продуктивной.