# Интеграция Cursor с dbt MCP [Cursor](https://docs.cursor.com/context/model-context-protocol) — это редактор кода с поддержкой ИИ, созданный на основе 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-сервер: ### Только CLI (dbt v1 и dbt v2) Конфигурация с самостоятельным размещением для пользователей, которым нужны только команды dbt с dbt v1 или dbt v2 (без функций dbt platform). [Добавить dbt v1 или dbt v2 в Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=dbt\&config=eyJlbnYiOnsiREJUX1BST0pFQ1RfRElSIjoiL3BhdGgvdG8veW91ci9kYnQvcHJvamVjdCIsIkRCVF9QQVRIIjoiL3BhdGgvdG8veW91ci9kYnQvZXhlY3V0YWJsZSJ9LCJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJkYnQtbWNwIl19) После нажатия: 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. Сохраните конфигурацию. ### OAuth с платформой dbt *OAuth для локально размещённого сервера dbt MCP доступен для учётных записей Starter, Enterprise и Enterprise+.* Параметры настройки для пользователей, которым нужна аутентификация OAuth в dbt platform. Функции ИИ включены по умолчанию. Администраторы могут [отключить или снова включить их в любое время](https://docs.getdbt.tech/docs/platform/manage-dbt-ai.md). * [Только dbt platform](cursor://anysphere.cursor-deeplink/mcp/install?name=dbt\&config=eyJlbnYiOnsiREJUX0hPU1QiOiJodHRwczovLzx5b3VyLWRidC1ob3N0LXdpdGgtY3VzdG9tLXN1YmRvbWFpbj4iLCJESVNBQkxFX0RCVF9DTEkiOiJ0cnVlIn0sImNvbW1hbmQiOiJ1dngiLCJhcmdzIjpbImRidC1tY3AiXX0%3D) * [dbt platform + CLI](cursor://anysphere.cursor-deeplink/mcp/install?name=dbt\&config=eyJlbnYiOnsiREJUX0hPU1QiOiJodHRwczovLzx5b3VyLWRidC1ob3N0LXdpdGgtY3VzdG9tLXN1YmRvbWFpbj4iLCJEQlRfUFJPSkVDVF9ESVIiOiIvcGF0aC90by9wcm9qZWN0IiwiREJUX1BBVEgiOiJwYXRoL3RvL2RidC9leGVjdXRhYmxlIn0sImNvbW1hbmQiOiJ1dngiLCJhcmdzIjpbImRidC1tY3AiXX0%3D) После нажатия на ссылку: 1. Замените `` фактическим адресом вашего хоста (например, `abc123.us1.dbt.com`). 2. (Для dbt platform + CLI) Обновите (Версии dbt: v1.11 и новее) `DBT_ENGINE_PROJECT_DIR` и `DBT_PATH`, как описано выше. 3. Сохраните конфигурацию. ### Пользовательские переменные окружения Используйте этот способ, если вам нужны пользовательские переменные окружения или вы предпочитаете использовать сервисные токены. Полный список доступных переменных окружения для самостоятельно размещённого MCP-сервера приведён в [справочнике переменных окружения](https://docs.getdbt.tech/docs/dbt-ai/mcp-environment-variables.md). 1. Нажмите на следующую ссылку при открытом Cursor: [Добавить в Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=dbt\&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJkYnQtbWNwIl0sImVudiI6e319) 2. В шаблоне добавьте необходимые вам переменные окружения в секцию `env`. 3. Сохраните конфигурацию. #### Использование файла `.env` Если вы предпочитаете управлять переменными окружения в отдельном файле, поместите файл `.env` в *корневой каталог вашего проекта dbt* (ту же папку, где находится `dbt_project.yml`). Нажмите на эту ссылку: [Добавить в Cursor (с файлом .env)](cursor://anysphere.cursor-deeplink/mcp/install?name=dbt-mcp\&config=eyJjb21tYW5kIjoidXZ4IC0tZW52LWZpbGUgPGVudi1maWxlLXBhdGg%252BIGRidC1tY3AifQ%3D%3D) Затем укажите в `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:///api/ai/v1/mcp`. Найти этот URL можно в dbt platform в разделе **Account settings** → **Access URLs** → **MCP Endpoint URL**. * После того как администратор настроит общие [учетные данные для аналитики](https://docs.getdbt.tech/docs/platform/wizard-read-only-users.md#set-up-analytics-credentials), пользователи с доступом только для чтения смогут использовать их вместо собственных учетных данных разработчика. **Перед подключением** * Ваш MCP-клиент должен поддерживать OAuth для MCP-серверов, работающих по HTTP. Если такой поддержки нет, используйте [аутентификацию на основе токенов](https://docs.getdbt.tech/docs/dbt-ai/setup-remote-mcp.md#token-based-authentication). * При первом подключении клиент открывает браузер для входа в систему. Затем dbt показывает экран согласия с запрашиваемыми областями доступа (конкретными разрешениями, которые клиенту будет позволено использовать) — описание каждой области доступа см. в разделе [Области доступа и согласие](https://docs.getdbt.tech/docs/platform/manage-access/connect-apps-oauth.md#scopes-and-consent). * Большинство современных MCP-клиентов регистрируются самостоятельно при первом подключении с помощью [динамической регистрации (RFC 7591)](https://docs.getdbt.tech/docs/platform/manage-access/connect-apps-oauth.md#dynamic-registration). Клиенты, которые её не поддерживают, администратор должен зарегистрировать в разделе **Account settings → Integrations → App integrations**. См. раздел [Ручная регистрация](https://docs.getdbt.tech/docs/platform/manage-access/connect-apps-oauth.md#manual-registration). Полное описание процесса, сеансов и ограничений см. в разделе [OAuth (удалённый MCP)](https://docs.getdbt.tech/docs/dbt-ai/setup-remote-mcp.md#oauth-remote-mcp). Приведённая ниже глубокая ссылка настраивает **аутентификацию на основе токена** (URL и заголовки). Для настройки OAuth следуйте [краткому руководству по удалённому MCP](https://docs.getdbt.tech/docs/dbt-ai/mcp-quickstart-remote.md#5-configure-your-mcp-client). 1. Откройте Cursor и перейдите по следующей ссылке приложения: [Добавить в Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=dbt\&config=eyJ1cmwiOiJodHRwczovLzxob3N0Pi9hcGkvYWkvdjEvbWNwLyIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6InRva2VuIDx0b2tlbj4iLCJ4LWRidC1wcm9kLWVudmlyb25tZW50LWlkIjoiPHByb2QtaWQ%252BIn19) 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://`, так и без него. Ниже приведены допустимые примеры: ```bash DBT_HOST=https://ab123.us1.dbt.com DBT_HOST=ab123.us1.dbt.com ``` 3. Сохраните настройки — теперь у вас есть доступ к серверу dbt MCP!