Перейти к основному содержимому

Интеграция Cursor с dbt MCP

Cursor — это редактор кода с поддержкой ИИ, созданный на основе Microsoft Visual Studio Code (VS Code).

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

Настройка с самостоятельно размещённым сервером dbt MCP​

Выберите вариант настройки в зависимости от вашего рабочего процесса:

  • OAuth для подключений к dbt platform
  • Только CLI, если вы используете dbt v1 или dbt v2 локально.
  • Настройте переменные окружения, если вы используете их в своей учётной записи dbt platform.

OAuth или CLI​

Нажмите на одну из следующих ссылок приложений при открытом Cursor, чтобы автоматически сконфигурировать ваш MCP-сервер:

Конфигурация с самостоятельным размещением для пользователей, которым нужны только команды dbt с dbt v1 или dbt v2 (без функций dbt platform).

Добавить dbt v1 или dbt v2 в Cursor

После нажатия:

  1. Укажите в (Версии dbt: v1.11 и новее) DBT_ENGINE_PROJECT_DIR полный путь к вашему проекту dbt (папке, содержащей dbt_project.yml).
  2. Укажите в DBT_PATH полный путь к исполняемому файлу dbt:
    • macOS/Linux: выполните which dbt в терминале.
    • Windows: выполните where dbt в командной строке или PowerShell.
  3. Сохраните конфигурацию.

Пользовательские переменные окружения​

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

  1. Нажмите на следующую ссылку при открытом Cursor:

    Добавить в Cursor

  2. В шаблоне добавьте необходимые вам переменные окружения в секцию env.

  3. Сохраните конфигурацию.

Использование файла .env​

Если вы предпочитаете управлять переменными окружения в отдельном файле, поместите файл .env в корневой каталог вашего проекта dbt (ту же папку, где находится dbt_project.yml). Нажмите на эту ссылку:

Добавить в Cursor (с файлом .env)

Затем укажите в env-file-path абсолютный путь к вашему файлу .env (например, /absolute/path/to/your-dbt-project/.env).

Настройка с удалённым dbt MCP-сервером​

  1. Нажмите на следующую ссылку приложения при открытом Cursor:

Удалённый MCP поддерживает OAuth или заголовки для аутентификации на основе токена.

  • OAuth для удалённого MCP доступен в публичной бета-версии для аккаунтов Starter, Enterprise и Enterprise+.
  • Для обоих методов URL MCP — https://<Access URL>/api/ai/v1/mcp. Найти этот URL можно в dbt platform в разделе Account settings → Access URLs → MCP Endpoint URL.

  • После того как администратор настроит общие учетные данные для аналитики, пользователи с доступом только для чтения смогут использовать их вместо собственных учетных данных разработчика.

Перед подключением

  • Ваш MCP-клиент должен поддерживать OAuth для MCP-серверов, работающих по HTTP. Если такой поддержки нет, используйте аутентификацию на основе токенов.
  • При первом подключении клиент открывает браузер для входа в систему. Затем dbt показывает экран согласия с запрашиваемыми областями доступа (конкретными разрешениями, которые клиенту будет позволено использовать) — описание каждой области доступа см. в разделе Области доступа и согласие.
  • Большинство современных MCP-клиентов регистрируются самостоятельно при первом подключении с помощью динамической регистрации (RFC 7591). Клиенты, которые её не поддерживают, администратор должен зарегистрировать в разделе Account settings → Integrations → App integrations. См. раздел Ручная регистрация.

Полное описание процесса, сеансов и ограничений см. в разделе OAuth (удалённый MCP).

Приведённая ниже глубокая ссылка настраивает аутентификацию на основе токена (URL и заголовки). Для настройки OAuth следуйте краткому руководству по удалённому MCP.

  1. Откройте Cursor и перейдите по следующей ссылке приложения:

    Добавить в Cursor

  2. Укажите свой URL и заголовки, обновив в шаблоне хост, идентификатор производственной среды и сервисный токен. Используйте https://YOUR_DBT_HOST_URL/api/ai/v1/mcp в качестве URL сервера (без завершающей косой черты).

    Идентификаторы — это целые числа, а не URL

    DBT_PROD_ENV_ID, DBT_USER_ID и DBT_DEV_ENV_ID должны быть числовыми идентификаторами (например, 54321), а не полными URL.

    Поле DBT_HOST принимает значения как с префиксом https://, так и без него. Ниже приведены допустимые примеры:

    DBT_HOST=https://ab123.us1.dbt.com
    DBT_HOST=ab123.us1.dbt.com

  3. Сохраните настройки — теперь у вас есть доступ к серверу dbt MCP!

Нашли ошибку?

0
Loading