Подключение Кода Genie к серверам MCP

Genie Code подключается к внешним инструментам, документам и данным через серверы Model Context Protocol (MCP) и встроенные коннекторы для Google Drive, SharePoint, GitHub, Glean, Atlassian и Slack. Используйте собственные соединители для распространенных источников SaaS или добавьте собственные внешние или настраиваемые серверы MCP из рабочей области. Вы выбираете, какие инструменты включить в настройках Genie Code.

Что такое MCP?

MCP — это стандарт открытый код, который подключает агентов к средствам, ресурсам, запросам и другим контекстным сведениям. MCP предоставляет стандартный способ предоставления инструментов, данных и рабочих процессов коду Genie без внедрения этого контекста непосредственно в запросы или инструкции.

MCP предназначен для случаев, когда важный контекст уже существует, но трудно получить доступ к агенту, например Genie Code. MCP предлагает безопасный способ предоставления доступа к контексту Genie Code, как показано ниже:

Системы документации: Teams часто хранят рабочие инструкции или операционные документы в таких средствах, как Confluence. Вместо копирования разделов в запросы содержимое может быть предоставлено один раз через внешний сервер MCP и ссылаться на него при необходимости. Ваши документы также могут находиться в Databricks в качестве индекса поиска ИИ, который Genie Code может использовать для запроса соответствующих документов.
Средства и службы: команды платформы могут поддерживать API или сценарии для установки, проверки или развертывания. MCP делает эти возможности доступными непосредственно в Genie Code.
Источники данных: если у вас уже есть данные в Databricks, вы можете подключить Genie Code к агенту Genie, чтобы помочь вам проанализировать данные с помощью естественного языка. Для данных, хранящихся за пределами Databricks, можно обеспечить безопасный доступ к Genie Code через внешние серверы MCP.
Пользовательские приложения: вы также можете добавить пользовательские функции, размещенные с помощью Databricks Apps. Это позволяет подключать Genie Code к собственным инструментам, рабочим процессам или интеграции, созданным специально для вас или вашей организации, все управляемые безопасно в рабочей области Databricks.

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

Вы можете подключить Genie Code к любым серверам MCP в рабочей области, которым у вас есть разрешение на использование. Администраторы рабочей области управляют доступными серверами, а пользователи могут выбирать из этих утвержденных источников по мере необходимости.

Дополнительные сведения о серверах MCP в Databricks, а также о том, как создать собственные, см. в статье Протокол контекста модели (MCP) в Azure Databricks.

Использование собственных соединителей для сторонних источников данных

Это важно

Эта функция доступна в бета-версии. Чтобы использовать соединители сторонних источников данных, администратор рабочей области должен включить предварительную версию сторонних соединителей для агентов. См. Управление предварительными версиями Azure Databricks.

Genie Code предоставляет встроенные соединители для распространенных корпоративных источников данных, включая Google Drive, SharePoint, GitHub, Glean, Atlassian и Slack.

Подключение к этим источникам данных позволяет Genie Code выполнять поиск документов при ответе на вопросы. Каждый пользователь выполняет проверку подлинности по отдельности, а маркеры OAuth не передаются между пользователями.

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

В рабочей области щелкните Код Genie в правом верхнем углу, чтобы открыть чат.
В строке запроса щелкните на значок "Создать", иконку с плюсом.
Рядом с источником данных, к которому требуется подключиться, нажмите кнопку "Подключить".
Выполните действия для входа.

После проверки подлинности Genie Code может выполнять поиск документов при ответе на вопросы. Администраторы хранилища метаданных и владельцы подключений могут управлять или отзывать разрешения пользователей на подключение. См . шаг 4. Предоставьте доступ товарищам по команде.

Замечание

Средства источника данных не всегда активируются автоматически. Если поиск документов не запускается, попробуйте явно предложить Genie Code использовать этот инструмент, например "Использовать Документы Google" или "Использовать SharePoint".

Чтобы подключить другие источники данных, вручную добавьте их в Код Genie. См. раздел "Добавление серверов MCP в код Genie" вручную.

Ограничения Google Drive

При авторизации Google Drive вы можете увидеть страницу с сообщением "непроверенное приложение". Нажмите кнопку "Дополнительно" и продолжайте процесс авторизации.
Максимальный размер файла составляет 10 МБ.
Поддерживаются только собственные файлы рабочей области Google (документы, листы, слайды). PDF-файлы, изображения и другие двоичные форматы не поддерживаются.
В выходных данных агента могут появляться ошибки истечения срока действия подключения или токена. Повторно выполните аутентификацию для устранения проблемы.

Замечание

Использование и передача необработанных или производных пользовательских данных, полученных от API Рабочей области Google, будет соответствовать политике пользовательских данных служб API Google, включая требования к ограниченному использованию.

ограничения SharePoint

Максимальный размер файла составляет 10 МБ.
Поддерживаемые типы файлов включают документы Office (.docx, .xlsx, .pptx), а также распространенные текстовые форматы, такие как .txt, .csv, .json.mdи другие. PDF-файлы, изображения и другие двоичные форматы не поддерживаются.

ограничения GitHub

По умолчанию соединитель Databricks GitHub MCP может получить доступ только к общедоступным репозиториям. Чтобы предоставить соединителю доступ на чтение к вашим частным корпоративным репозиториям, администратор организации GitHub должен выполнить дополнительную настройку. См. раздел "Включить доступ к частному репозиторию".
GitHub Enterprise Server (локальная версия GitHub) не поддерживается.

Ограничения Glean

Администратор метамагазина должен сначала настроить идентификатор арендатора Glean, прежде чем пользователи без администратора смогут использовать соединение. Администратор может ввести идентификатор клиента при первом подключении к Glean.
Чтобы подключиться к конкретному серверу Glean MCP, администратор метамагазина может по желанию установить путь к MCP-серверу (например /mcp/eng, ) при настройке соединения. Оставьте это поле пустым, чтобы использовать стандартный путь (/mcp/default). Пользователи без администраторов не могут указывать или менять путь сервера Glean MCP.

Добавьте серверы MCP вручную в код Genie

Чтобы подключить Genie Code к серверу MCP, добавьте его в параметры кода Genie:

Откройте параметры кода Genie. На панели Genie Code щелкните Настройки.
В разделе "Серверы MCP" щелкните Добавление сервера.
Выберите серверы MCP, которые нужно добавить. Вы можете выбрать управляемые серверы MCP Databricks или внешние серверы MCP:
- Функция каталога Unity: выберите схему для функции. Это позволяет Genie Code использовать функции для выполнения предопределенных запросов SQL.
  - Чтобы получить справку по созданию пользовательского MCP-сервера GitHub, см. раздел Поиск по коду GitHub с помощью Genie Code.
- Поиск ИИ: выберите схему для индекса. Это позволяет Genie Code запрашивать индекс поиска ИИ, чтобы найти соответствующие документы.
- Агент Genie: Выберите агента Genie. Genie MCP использует Genie как инструмент, что позволяет обращаться к агенту Genie, чтобы анализировать данные с помощью запросов на естественном языке.
- Внешний сервер MCP: выберите подключение каталога Unity для использования в качестве внешнего сервера MCP. Прежде чем его можно будет использовать, необходимо войти в подключение.
- Пользовательский сервер MCP: выберите приложение Databricks для использования в качестве пользовательского сервера MCP. Это позволяет использовать любые инструменты, определенные пользователем. Применяются следующие требования:
  - Приложение должно быть развернуто в той же рабочей области, из которую вы пытаетесь подключиться к нему.
  - К серверу MCP необходимо осуществить доступ по адресу https://<server-url>/mcp.
  - Приложение должно быть без отслеживания состояния. Например, задайте mcp_app = mcp_server.http_app(stateless_http=True).
  - При возникновении ошибок CORS может потребоваться добавить URL-адрес рабочей области в список разрешенных источников приложения. Например, задайте app.add_middleware(CORSMiddleware, allow_origins=ALLOWED_ORIGINS, allow_credentials=True, allow_methods= ["*"], allow_headers= ["*"]).
Нажмите кнопку Сохранить.

После добавления серверы MCP сразу же доступны в Genie Code. Вы можете начать использовать их, не изменяя запросы или инструкции. Код Genie автоматически использует эти серверы при необходимости.

Вы можете выбрать средства и серверы для включения или отключения в параметрах кода Genie.

Ограничения

Внешние серверы MCP доступны только в регионах, где поддерживается обслуживание моделей. См. сведения о доступности функций обслуживания моделей.

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2026-07-29