# Как найти идентификаторы для dbt MCP

Некоторые переменные окружения и заголовки dbt MCP требуют числовых идентификаторов из вашей учетной записи dbt platform. В этом руководстве показано, где именно найти каждый из них.

Используйте числовые идентификаторы, а не полные URL-адреса

Переменные идентификаторов принимают целые числа, а не URL-адреса. Распространенная ошибка — копирование URL-адреса из адресной строки браузера.

```bash
# ✅ Правильно
DBT_HOST=cloud.getdbt.com            # https://cloud.getdbt.com тоже подходит
DBT_PROD_ENV_ID=54321
DBT_USER_ID=123

# ❌ Неправильно — идентификаторы должны быть числами, а не полными URL-адресами
DBT_PROD_ENV_ID=https://cloud.getdbt.com/deploy/12345/projects/67890/environments/54321
DBT_USER_ID=https://cloud.getdbt.com/settings/profile
```

## DBT\_HOST (имя хоста учетной записи)

Имя хоста — это домен, который вы используете для доступа к dbt platform. Допускаются оба варианта: `cloud.getdbt.com` и `https://cloud.getdbt.com`.

1. Войдите в свою учетную запись dbt platform.
2. Перейдите в **Account settings**.
3. Скопируйте значение **Access URL**.

| Тип учетной записи                   | Пример Access URL         | Значение DBT\_HOST        |
| ------------------------------------ | ------------------------- | ------------------------- |
| Мультитенантная в США                | `cloud.getdbt.com`        | `cloud.getdbt.com`        |
| Учетные записи с префиксом поддомена | `abc123.us1.dbt.com`      | `abc123.us1.dbt.com`      |
| Однотенантная                        | `your-company.getdbt.com` | `your-company.getdbt.com` |

Дополнительные сведения о регионах и размещении см. в разделе [Доступ, регионы и IP-адреса](https://docs.getdbt.tech/docs/platform/about-platform/access-regions-ip-addresses.md).

## DBT\_ACCOUNT\_ID (идентификатор учетной записи)

1. Войдите в свою учетную запись dbt platform.
2. Перейдите в **Account settings**.
3. Идентификатор учетной записи отображается на странице настроек. Его также можно найти в URL-адресе: `https://cloud.getdbt.com/settings/accounts/ACCOUNT_ID/`. Например, если URL-адрес — `https://YOUR_ACCESS_URL/settings/accounts/12345/`, идентификатор учетной записи — `12345`.

Другие способы описаны в разделе [Поиск идентификаторов пользователя и учетной записи](https://docs.getdbt.tech/faqs/Accounts/find-user-id.md).

## DBT\_PROD\_ENV\_ID (идентификатор производственной среды)

1. Войдите в свою учетную запись dbt platform.
2. Перейдите в **Orchestration** → **Environments**.
3. Нажмите на свою производственную среду.
4. Идентификатор среды указан в URL-адресе: `https://cloud.getdbt.com/deploy/ACCOUNT_ID/projects/PROJECT_ID/environments/ENVIRONMENT_ID`. Например, если URL-адрес — `https://YOUR_ACCESS_URL/deploy/12345/projects/67890/environments/54321`, идентификатор среды — `54321`.

Скопируйте только число в конце — например, `54321`.

## DBT\_DEV\_ENV\_ID (идентификатор среды разработки)

Выполните те же действия, что и для `DBT_PROD_ENV_ID`, но выберите среду разработки вместо производственной среды.

Эта переменная обязательна для `execute_sql`. Если у вас нет выделенной среды разработки, здесь можно использовать идентификатор производственной среды, хотя рекомендуется создать отдельную среду разработки.

## DBT\_USER\_ID (идентификатор пользователя)

1. Войдите в свою учетную запись dbt platform.
2. Перейдите в **Account settings** → **Profile** (или нажмите на свой профиль/аватар).
3. Идентификатор пользователя указан в URL-адресе: `https://cloud.getdbt.com/settings/profile/USER_ID`. Например, если URL-адрес — `https://YOUR_ACCESS_URL/settings/profile/123`, идентификатор пользователя — `123`.

Скопируйте только число.

Другой способ описан в разделе [Поиск идентификаторов пользователя и учетной записи](https://docs.getdbt.tech/faqs/Accounts/find-user-id.md).

## DBT\_TOKEN (токен доступа)

В следующих разделах объясняется, как найти персональный токен доступа (PAT) и сервисный токен.

### Персональный токен доступа (PAT)

Обязателен для `execute_sql`. Привязан к вашей личной учетной записи.

1. Перейдите в **Account settings** → **API tokens** → **Personal tokens**.
2. Нажмите **+ New token**, задайте имя и скопируйте значение токена.
3. Сохраните его в безопасном месте — после закрытия диалогового окна вы не сможете просмотреть его снова.

### Сервисный токен

Используется для общих или командных конфигураций. Лучше подходит для CI и автоматизации.

1. Перейдите в **Account settings** → **API tokens** → **Service tokens**.
2. Нажмите **+ New token**, назначьте необходимые разрешения и скопируйте значение токена.
3. Назначьте набор разрешений `Developer`, ограничив его действие либо проектом, которому принадлежит среда, используемая для `x-dbt-prod-environment-id`, либо распространив его на все проекты. Токен без этого набора разрешений отклоняется с кодом `401` при подключении MCP-клиента. Другие наборы разрешений не требуются. Назначить `Developer` сервисному токену можно только на тарифных планах Enterprise и Enterprise+; на других тарифных планах используйте [OAuth](https://docs.getdbt.tech/docs/dbt-ai/setup-remote-mcp.md#oauth-remote-mcp).

Дополнительные сведения см. в разделах [Пользовательские токены (PAT)](https://docs.getdbt.tech/docs/dbt-apis/user-tokens.md) и [Сервисные токены](https://docs.getdbt.tech/docs/dbt-apis/service-tokens.md).
