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

Set up remote MCP

Удалённый MCP-сервер использует HTTP-соединение и выполняет вызовы к dbt-mcp, размещённому в облаке на базе dbt platform. Такая конфигурация не требует локальной установки и идеально подходит для сценариев потребления данных.

Когда использовать удалённый MCP​

Удалённый MCP-сервер является идеальным выбором, когда:

  • Вы не хотите или вам запрещено устанавливать дополнительное программное обеспечение (uvx, dbt-mcp) на вашу систему.
  • Ваш основной сценарий использования — ориентированный на потребление: запрос метрик, исследование метаданных, просмотр lineage.
  • Вам нужен доступ к Semantic Layer и API Discovery без необходимости поддерживать локальный проект dbt.
  • Вам не нужно выполнять команды CLI. Удалённый MCP не поддерживает команды dbt CLI (dbt run, dbt build, dbt test и другие). Если вам необходимо выполнять команды dbt CLI, используйте вместо этого локальный MCP-сервер.
к сведению

Удалённые инструменты dbt MCP зависят от доступных кредитов dbt Copilot. Обратите внимание, что SQL‑инструменты и удалённые инструменты Fusion относятся к этой категории даже в тех случаях, когда они используются и проксируются через локальный сервер dbt MCP. Большинство MCP‑инструментов не расходуют кредиты dbt Copilot. Однако использование text_to_sql учитывается в вашем потреблении dbt Copilot.

Если вы достигнете лимита использования dbt Copilot, все инструменты будут заблокированы до тех пор, пока ваши кредиты Copilot не будут сброшены. Если вам нужна помощь, пожалуйста, свяжитесь с вашим аккаунт-менеджером.

Инструкции по настройке​

  1. Убедитесь, что у вас включены AI-функции.
  2. Получите следующую информацию из платформы dbt:
  • Хост dbt Cloud: Используйте его для формирования полного URL. Например, замените <host> здесь: https://<host>/api/ai/v1/mcp/. Он может выглядеть так: https://cloud.getdbt.com/api/ai/v1/mcp/. Если у вас мульти-региональная (multi-cell) учётная запись, URL хоста будет в формате <ACCOUNT_PREFIX>.us1.dbt.com. Дополнительные сведения см. в разделе Доступ, регионы и IP-адреса.
  • ID production-окружения: Его можно найти на странице Orchestration в dbt platform. Используйте его для установки заголовка x-dbt-prod-environment-id.
  • Токен: Сгенерируйте либо персональный токен доступа, либо сервисный токен. С точки зрения разрешений, для полноценного использования удалённого MCP он должен быть настроен с разрешениями Semantic Layer и Developer. Примечание: для использования функциональности, требующей заголовка x-dbt-user-id, необходим персональный токен доступа.
  1. Для удалённого MCP вы будете передавать заголовки через JSON-объект для настройки необходимых полей:

Конфигурация для API и SQL-инструментов

HeaderRequiredDescription
TokenОбязательноВаш персональный токен доступа или сервисный токен из dbt platform.
Примечание: При использовании Semantic Layer рекомендуется использовать персональный токен доступа. Если вы используете сервисный токен, убедитесь, что у него есть как минимум разрешения Semantic Layer Only, Metadata Only и Developer.
x-dbt-prod-environment-idОбязательноID вашего production-окружения dbt platform
Loading table...

Дополнительная конфигурация для SQL-инструментов

HeaderRequiredDescription
x-dbt-dev-environment-idОбязательно для execute_sqlID вашего development-окружения dbt platform
x-dbt-user-idОбязательно для execute_sqlID вашего пользователя dbt platform (см. документацию)
Loading table...

Дополнительная конфигурация для Fusion-инструментов

Fusion-инструменты по умолчанию используют окружение, указанное через x-dbt-prod-environment-id, для метаданных моделей и таблиц.

HeaderRequiredDescription
x-dbt-dev-environment-idОбязательноID вашего development-окружения dbt platform
x-dbt-user-idОбязательноID вашего пользователя dbt platform (см. документацию)
x-dbt-fusion-disable-deferНеобязательноЗначение по умолчанию: false. Если установлено в true, инструменты Fusion не будут откладывать к production-окружению и вместо этого будут использовать модели и метаданные таблиц из development-окружения (x-dbt-dev-environment-id).
Loading table...

Конфигурация для отключения инструментов

HeaderRequiredDescription
x-dbt-disable-toolsНеобязательноСписок инструментов для отключения, разделённый запятыми. Например: get_all_models,text_to_sql,list_entities
x-dbt-disable-toolsetsНеобязательноСписок наборов инструментов для отключения, разделённый запятыми. Например: semantic_layer,sql,discovery
Loading table...
  1. После того как вы определите, какие заголовки вам нужны, вы можете воспользоваться примерами, чтобы создать собственного агента.

Протокол MCP не зависит от языка программирования и фреймворка, поэтому используйте всё, что помогает вам создавать агентов. В качестве альтернативы вы можете подключить удалённый MCP-сервер dbt к MCP-клиентам, которые поддерживают аутентификацию на основе заголовков. Вы можете использовать этот пример конфигурации Cursor, заменив <host>, <token>, <prod-id>, <user-id> и <dev-id> на свои значения:

{
  "mcpServers": {
    "dbt": {
      "url": "https://<host>/api/ai/v1/mcp/",
      "headers": {
       "Authorization": "token <token>",
        "x-dbt-prod-environment-id": "<prod-id>",
        "x-dbt-user-id": "<user-id>",
        "x-dbt-dev-environment-id": "<dev-id>"
      }
    }
  }
}

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

0
Loading