Databricks Field Guide MCP server

Изучайте Databricks, готовьтесь к сертификации и получайте ответы на инженерные вопросы

Чтобы пройти диагностику, попросите: «Помоги мне изучить Databricks». Чтобы начать практику по темам сертификации, попросите: «Помоги мне подготовиться к Data Engineer Associate». В клиентах с поддержкой интерактивных карточек MCP Apps помощник использует их, а в текстовых клиентах задаёт по одному вопросу за раз.

В ответах приводятся разделы руководства и ссылки на официальную документацию.

https://databricks.techfabric.com/mcp

Это удалённый сервер с транспортом Streamable HTTP: не нужно запускать локальный сервер, входить в систему или платить за доступ к учебным материалам. Необязательный плагин для Claude Code, описанный ниже, объединяет подключение и шесть навыков; одно подключение MCP навыки не устанавливает.

Спросите, как добавить фильтр строк Unity Catalog, и агент найдёт соответствующий раздел руководства, SQL-функцию из этого раздела и лежащую в его основе документацию Databricks. Официальная документация Databricks остаётся источником достоверной информации о синтаксисе и ограничениях, поэтому в каждом ответе есть ссылки на неё.

Это не собственный MCP-сервер Databricks. Databricks запускает управляемые MCP-серверы в рабочей среде, которые взаимодействуют с вашими данными. Этот сервер создан и поддерживается компанией TechFabric, партнёром Databricks, и никогда не подключается к рабочей среде.

Что находится в этом репозитории

Дескрипторы реестров и необязательный плагин для клиента. В официальной записи MCP Registry указан этот репозиторий, а в MCP Registry от GitHub README отображается в Copilot. Исходный код сервера в репозитории отсутствует и не является открытым.

Файл	Описание
`server.json`	Запись сервера в официальном MCP Registry, скопированная без изменений
`glama.json`	Список сопровождающих для Glama
`icon.png`, `icon-light.png`	Логотип TechFabric размером 256 px для тёмного и светлого фона
`LICENSE`	Apache-2.0; лицензия распространяется только на эти файлы
`.claude-plugin/marketplace.json`	Дескриптор marketplace для Claude Code
`plugins/field-guide/`	Анонимное подключение MCP, шесть навыков и скрипт проверки подключения

Работающий сервер и реестр — источники актуальной информации. Если данные в этом README когда-либо разойдутся с результатом tools/list сервера, верными следует считать данные сервера. Еженедельный GitHub Action сравнивает server.json с реестром и открывает pull request, если запись изменилась.

Подключение к агенту

Claude Code

Чтобы установить навыки и подключение, выполните в Claude Code:

/plugin marketplace add Fabric-Pro/databricks-field-guide-mcp
/plugin install field-guide@techfabric-field-guide

Затем начните новый сеанс. Навыки помогают с общими вопросами о Databricks, обучением с сопровождением, подготовкой к сертификации, проверкой кода, оценкой затрат и изучением недавних изменений.

Они дополняют плагин Databricks для разработки, но не заменяют доступ к рабочей среде или инструменты развёртывания. Чтобы избежать дублирования инструментов, оставьте только одно подключение Field Guide.

Чтобы добавить только подключение MCP, без навыков:

claude mcp add --transport http databricks-field-guide https://databricks.techfabric.com/mcp

Добавьте --scope user, чтобы подключение было доступно во всех проектах.

agy

Из клона этого репозитория выполните:

agy plugin install ./plugins/field-guide

Затем начните новый сеанс. Встроенный манифест agy и mcp_config.json содержат те же шесть навыков и сохраняют подключение HTTP без преобразования в формат плагина Claude.

Claude Desktop и claude.ai

Откройте Настройки, затем Коннекторы, выберите Добавить, а затем Добавить пользовательский коннектор. Укажите его название, вставьте https://databricks.techfabric.com/mcp, оставьте параметры аутентификации, обнаруженные Claude, и выберите Добавить. В тарифном плане Team или Enterprise владельцу организации может потребоваться сначала добавить коннектор для всей организации.

ChatGPT

На странице chatgpt.com/plugins выберите +, а затем Добавить пользовательский MCP-сервер. Вставьте URL в поле Подключение, выберите вариант без аутентификации и создайте подключение. В чате введите @ и выберите его. Если пункта Добавить пользовательский MCP-сервер нет, администратору вашей рабочей среды нужно включить эту возможность.

Codex

codex mcp add databricks-field-guide --url https://databricks.techfabric.com/mcp

Или вручную добавьте в ~/.codex/config.toml:

[mcp_servers.databricks-field-guide]
url = "https://databricks.techfabric.com/mcp"

Cursor

Для всех проектов добавьте настройки в ~/.cursor/mcp.json, а для одного проекта — в .cursor/mcp.json:

{
  "mcpServers": {
    "databricks-field-guide": { "url": "https://databricks.techfabric.com/mcp" }
  }
}

VS Code

Добавьте настройки в .vscode/mcp.json, затем запустите сервер из этого файла или через представление MCP. Инструменты появятся в режиме агента Copilot.

{
  "servers": {
    "databricks-field-guide": { "type": "http", "url": "https://databricks.techfabric.com/mcp" }
  }
}

GitHub Copilot

В VS Code используйте приведённую выше конфигурацию. Copilot CLI сохраняет сервер в ~/.copilot/mcp-config.json, и он становится доступен во всех проектах:

copilot mcp add --transport http databricks-field-guide https://databricks.techfabric.com/mcp

Чтобы подключить сервер к агенту для программирования Copilot на github.com, добавьте его в настройках репозитория: Settings, затем Copilot и MCP servers.

Все инструменты доступны только для чтения, поэтому можно подключить их все:

{
  "mcpServers": {
    "databricks-field-guide": {
      "type": "http",
      "url": "https://databricks.techfabric.com/mcp",
      "tools": ["*"]
    }
  }
}

Другие клиенты

Укажите URL и выберите транспорт Streamable HTTP без аутентификации. Если клиент поддерживает только stdio, подключиться к серверу можно через mcp-remote:

npx mcp-remote https://databricks.techfabric.com/mcp

Инструкции для Gemini CLI и OpenCode приведены в руководстве по настройке.

Инструменты

Инструмент	Назначение
`start_here`	Запускает рабочую диагностику, урок по указанной теме или подготовку к сертификации; показывает карточку Apps и при необходимости выводит текстовую версию
`search_guide`	Находит наиболее подходящие разделы глав, заметки на полях и новости, отвечающие на вопрос о Databricks; для каждого результата указывает URL и якорь раздела
`get_chapter`	Возвращает главу, заметку на полях или отдельный раздел в формате Markdown, включая код, ответы на частые вопросы и ссылки на упомянутые источники на docs.databricks.com
`get_code_examples`	Возвращает блоки SQL, Python, CLI и конфигураций по указанной теме вместе с пояснениями к каждому примеру
`whats_new`	Перечисляет последние изменения Databricks, отслеживаемые руководством, начиная с самых новых: заметки на полях, изменения этапов выпуска и обновлённые главы
`list_chapters`	Показывает оглавление с частью, кратким описанием, датами и основными разделами каждой главы
`review_databricks_code`	Проверяет один файл SQL, Python или YAML — например, конфигурацию bundle, job, кластера или warehouse — по правилам самого руководства. Для каждого замечания указываются строка, причина, исправление, цитата из руководства со ссылкой на раздел и ссылки на документацию. В результате также перечисляются разделы, которые стоит прочитать
`estimate_cost`	Оценивает месячную стоимость рабочей нагрузки по данным из руководства и указывает диапазон с допущениями. Для каждого числа приводятся исходная цитата, URL раздела, дата и ссылка на страницу с ценами. Если в руководстве нет нужных данных, инструмент сообщает об этом, а не пытается угадать
`explore_concept`	Запускает пошаговое интерактивное изучение понятия
`quiz_me`	Задаёт вопросы со ссылками на источники и оценивает фактические ответы читателя
`learn_path`	Предлагает этапы обучения с учётом роли и проверяет прогресс, указанный читателем
`exam_prep`	Соотносит темы сертификации с материалами руководства и официальными руководствами к экзаменам
`flashcards`	Помогает изучать термины с подтверждёнными источниками по главам или темам экзамена
`visualize`	Создаёт диаграмму или график на основе руководства
`decide`	Сравнивает инженерные варианты с учётом компромиссов, описанных в руководстве
`explore_diagram`	Запускает интерактивный разбор диаграммы из главы

Все шестнадцать инструментов доступны только для чтения и не вызывают модели: проверка кода и оценка затрат выполняются детерминированно на основе текста руководства, а рассуждения выполняет ваш агент. Правило применяется только до тех пор, пока в руководстве сохраняется цитируемое положение. В правила не включены случаи, которые руководство не рассматривает, например самостоятельное использование SELECT * или collect().

Вместе с инструментами доступны три ресурса: fieldguide://llms.txt — по одной строке на страницу; fieldguide://whats-new — изменения за последние 30 дней в формате JSON; fieldguide://page/{+path} — любая опубликованная страница в формате Markdown. Клиенты, отображающие MCP Apps, показывают результаты в виде интерактивного представления, а не обычного текста. Начиная с версии 1.3.0 в таком виде отображаются также замечания по результатам проверки и оценка в виде таблицы.

Prompts

Хосты, поддерживающие MCP-промпты, отображают их как команды со слешем. В Claude Code

это /mcp__databricks-field-guide__.

Промпт	Назначение
`start`	Начинает первую учебную сессию или подготовку к сертификации
`learn`	Помогает изучить тему с помощью разделов руководства и практических заданий
`quiz`	Проводит тест по проверенным источникам, задавая по одному вопросу
`explain`	Запускает интерактивное объяснение концепции
`path`	Начинает учебный маршрут для выбранной роли
`exam`	Помогает подготовиться к сертификации: составляет карту разделов и предлагает практические задания
`flashcards`	Запускает набор карточек для повторения
`estimate`	Оценивает стоимость указанной нагрузки на основе приведённых тарифов
`databricks-review`	Сверяет настройки Databricks в этом репозитории с руководством. Агент собирает bundle-файлы, ноутбуки, SQL и конфигурации вычислительных ресурсов, запускает `review_databricks_code` для каждого элемента и обобщает результаты со ссылками
`databricks-cost`	Оценивает стоимость нагрузок в репозитории с помощью `estimate_cost`, указывая источник и дату для каждой цифры и чётко отмечая пробелы в данных
`whats-new`	Кратко описывает недавние изменения в Databricks и то, какие из них затрагивают этот репозиторий
`field-guide-chapter`	Добавляет в беседу главу или отдельный раздел в формате Markdown
`field-guide-code`	Находит в руководстве примеры кода по указанной теме, при необходимости ограничивая поиск одной главой

Названия глав и разделов дополняются по мере ввода. Так же работает и дополнение пути к ресурсу страницы. MCP дополняет аргументы промптов, но не аргументы инструментов, поэтому именно в этих промптах можно выбрать названия глав для get_chapter.

Уведомления

В MCP 2026-07-28 клиент может подписаться с помощью subscriptions/listen на

fieldguide://whats-new или любой ресурс fieldguide://page/.... Когда при публикации обновляется ресурс руководства, на который оформлена подписка, например добавляется примечание на полях, переписывается глава или меняется этап выпуска функции, сервер отправляет

notifications/resources/updated. У клиентов на версии 2025-11-25 нет канала для push-уведомлений, поэтому им следует читать whats_new.

В каждом ответе указано, когда страница обновлялась в последний раз и как долго клиент может хранить её в кэше: 10 минут для раздела «Что нового», 15 минут для поиска и час для глав и кода.

При каждой публикации руководства индекс создаётся заново.

Примеры запросов

«Помоги мне изучить Databricks. Начни с короткой диагностической проверки.»
«Помоги подготовиться к сертификации Data Engineer Associate. Начни практику прямо сейчас.»
«Интерактивно объясни Unity Catalog, а затем проверь, насколько хорошо я усвоил материал.»
«Как добавить фильтр строк Unity Catalog? Используй Databricks Field Guide.»
«Что изменилось в Databricks за последние две недели?»
«Найди в Field Guide SQL-код для маскирования столбца Unity Catalog и примени его к столбцу email в моей таблице customers.»
«Прочитай главу Field Guide о Lakebase и скажи, подойдут ли ветвления для наших тестовых сред.»
«Что Field Guide рекомендует для выбора вычислительных ресурсов, чтобы снизить расходы на Databricks?»
«Проверь bundle-файл Databricks в этом репозитории по Field Guide». Или запусти

/mcp__databricks-field-guide__databricks-review в Claude Code.

«Оцени стоимость работы приложения Databricks App размера Medium во время консультационных часов, используя данные Field Guide.»
«Проверь pipelines/orders.sql по Field Guide и исправь найденные замечания.»

Вход в систему, ограничения и конфиденциальность

В каталоге установленного плагина команда node scripts/doctor.mjs проверяет анонимное обнаружение, переносимые схемы, работу диагностической проверки, практику для сертификации и ресурс Apps. Требуется Node.js версии 20 или новее. Эта проверка подтверждает подключение, но не гарантирует, что конкретный хост отображает карточки.

Практические задания составлены по материалам руководства, а не по реальным экзаменационным вопросам. Пробелы в охвате тем отмечаются; требования следует сверять с официальным руководством к экзамену по ссылке. Field Guide не связан с Databricks и не гарантирует получение сертификата или полного и актуального охвата платформы. Ответы, которых нет в руководстве, следует искать в официальной документации. Прогресс сохраняется в беседе, если вы не попросите сохранить его отдельно.

Перед отправкой кода из репозитория навыки проверки запрашивают разрешение. Передавайте только одобренные и очищенные от конфиденциальных данных файлы — без секретов и данных клиентов.

Вход в систему не требуется, инструментов для записи нет. Для каждого IP-адреса установлены ограничения: 60 вызовов в минуту и 300 в час. При превышении лимита сервер отвечает кодом HTTP 429 и заголовком Retry-After.

Сервер не сохраняет запросы, которые вы выполняли при поиске или чтении, и код, переданный в review_databricks_code. В замечаниях, цитирующих строку кода, все секреты в ней маскируются. В записи о вызове сервер указывает название инструмента и версию протокола, но не аргументы. Сервер хранит только два типа данных: счётчик вызовов для каждого IP-адреса, срок действия которого истекает примерно через час, и одну запись об изменениях для каждой публикации — для отправки уведомлений. Сервер не отправляет исходящие запросы. Остальные сведения описаны в политике конфиденциальности.

Сервер поддерживает версию MCP 2026-07-28, а клиенты, использующие версию 2025-11-25, обслуживаются по тому же URL. В официальном реестре он указан как

com.techfabric.databricks/field-guide.

Ссылки

Databricks Field Guide
Документация сервера MCP для Field Guide: описание всех инструментов, ресурсов и ограничений, а также инструкции по настройке для каждого клиента
Запись в официальном реестре MCP
Сервер MCP от techfabric.com
Консультационные услуги TechFabric по Databricks
Связаться с инженером

Лицензия

На файлы в этом репозитории распространяется действие лицензии Apache License 2.0.

Авторские права принадлежат Tech Fabric LLC. На содержимое Field Guide и сам сервер эта лицензия не распространяется.