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

Подключение сервера dbt MCP к платформе dbt

В этом кратком руководстве используется локальный сервер MCP: он запускается на вашем компьютере с помощью uvx dbt-mcp, подключается к dbt platform для работы с Semantic Layer, Discovery и SQL, а также при необходимости запускает dbt локально.

Если вам нужен только самостоятельно развернутый CLI (с аккаунтом dbt platform или без него), см. Запуск самостоятельно развернутого dbt или Запуск самостоятельно развернутого dbt Wizard.

Чтобы настроить или отключить отдельные инструменты, см. Справочник переменных окружения.

Предварительные требования​

Шаг 1. Выберите способ аутентификации и выполните настройку​

MCP OAuth доступен в публичной бета-версии для аккаунтов на тарифах Starter, Enterprise и Enterprise+.

OAuth — самый быстрый способ настройки для аккаунтов dbt platform: вам не нужно копировать токены или управлять ими. При первом подключении открывается окно браузера для аутентификации.

Для использования OAuth без самостоятельно развернутой установки используйте удаленный сервер MCP. OAuth для удаленного MCP доступен в публичной бета-версии для аккаунтов на тарифах Starter, Enterprise и Enterprise+. Если ваш клиент не поддерживает OAuth или вам нужен доступ по токену, используйте аутентификацию по токену.

Требуются статические поддомены

Только учетные записи со статическими поддоменами (например, abc123 в abc123.us1.dbt.com) могут использовать OAuth с MCP-серверами. Следуйте этим инструкциям, чтобы найти поддомен вашей учетной записи. Если у вашей учетной записи нет поддомена, обратитесь в службу поддержки за дополнительной информацией.

Найдите свой Access URL​

  1. Войдите в свой аккаунт dbt platform.
  2. Перейдите в Account settings и скопируйте Access URL (например, abc123.us1.dbt.com).
Multi-cell и формат DBT_HOST

  • Поле DBT_HOST принимает как abc123.us1.dbt.com, так и https://abc123.us1.dbt.com.

  • Если ваш Access URL — abc123.us1.dbt.com, разделите его на две переменные:

Добавьте конфигурацию в свой клиент MCP​

Вариант A: быстрая установка (рекомендуется)

  1. Перейдите к последнему релизу dbt MCP и скачайте dbt-mcp.mcpb.
  2. Дважды щелкните файл, чтобы открыть его в Claude Desktop.
  3. Введите свой Access URL в качестве хоста dbt platform.
  4. Включите сервер.

Вариант B: ручная настройка

  1. В Claude Desktop перейдите в Settings → вкладка Developer → Edit Config.
  2. Вставьте следующую конфигурацию, заменив YOUR-ACCESS-URL своим Access URL:
{
  "mcpServers": {
    "dbt": {
      "command": "uvx",
      "args": ["dbt-mcp"],
      "env": {
        "DBT_HOST": "YOUR-ACCESS-URL"
      }
    }
  }
}
  1. Сохраните изменения и перезапустите Claude Desktop.

Расположение файла конфигурации:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Необязательно: добавьте команды самостоятельно развернутого dbt CLI​

Чтобы также выполнять команды dbt platform CLI (dbt run, dbt build, dbt test и другие), добавьте эти две переменные в блок env:

"DBT_PROJECT_DIR": "/path/to/your/dbt/project",
"DBT_PATH": "/path/to/your/dbt/executable"

Найдите DBT_PATH, выполнив which dbt (macOS/Linux) или where dbt (Windows). DBT_PROJECT_DIR — это папка, содержащая ваш dbt_project.yml.

Шаг 2. Пройдите аутентификацию​

При первом подключении dbt MCP открывает окно браузера для завершения аутентификации OAuth. После входа ваш сеанс сохраняется, и последующие подключения выполняются автоматически.

Если аутентификация не начинается, закройте клиент и выполните:

  • macOS/Linux: rm -f ~/.dbt/mcp.yml ~/.dbt/mcp.lock
  • Windows: Remove-Item -Force $env:USERPROFILE\.dbt\mcp.yml, $env:USERPROFILE\.dbt\mcp.lock

Затем перезапустите клиент.

Шаг 3. Проверьте настройку​

Задайте своему ИИ-ассистенту вопрос о данных (например, «Какие модели есть в моем проекте dbt?» или «Какие метрики определены в моем Semantic Layer?»). Если dbt MCP работает, в ответе будут использованы ваши метаданные dbt.

Доступные возможности​

При подключении к платформе ваш ИИ-ассистент может использовать:

  • Запросы к Semantic Layer
  • Discovery для метаданных (происхождение моделей, результаты тестов, свежесть источников)
  • Admin API (запуск заданий, получение списка запусков и артефактов)
  • Выполнение SQL и преобразование текста в SQL (требуется PAT)
  • Все команды dbt, если вы добавили DBT_PROJECT_DIR и DBT_PATH

Полный список инструментов см. в разделе Доступные инструменты.

Нужен только самостоятельно развернутый dbt CLI?

Если вам нужно только выполнять команды dbt локально (с аккаунтом dbt platform или без него), см. Запуск самостоятельно развернутого dbt.

Устранение неполадок​

Не удаётся найти исполняемый файл uvx
Вход через OAuth не запускается
Сервер не запускается
Инструмент execute_sql не работает
Набор инструментов недоступен или отображается как отключённый
Вставка полных URL вместо идентификаторов
Проблемы с подключением к аккаунту в multi-cell или со статическим поддоменом

Все темы по устранению неполадок см. в разделе Часто задаваемые вопросы о dbt MCP и устранение неполадок.

Следующие шаги​

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

0
Loading