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

Подключите Genie Code к внешним инструментам и источникам данных с помощью протокола контекста модели (MCP). Genie Code может использовать любые серверы MCP, которые добавлены в вашу рабочую область и на использование которых у вас есть разрешение.

Замечание

Серверы MCP поддерживаются только в режиме агента кода Genie.

Что такое 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. Это позволяет подключать Genie Code к собственным инструментам, рабочим процессам или интеграции, созданным специально для вас или вашей организации, все управляемые безопасно в рабочей области Databricks.

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

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

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

Добавьте серверы MCP в Код Genie

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

1. Откройте параметры кода Genie. На панели "Код Genie Параметры.
2. В разделе "Серверы MCP" щелкните Добавление сервера.
3. Выберите серверы MCP, которые вы хотите добавить. Вы можете выбрать управляемые серверы MCP Databricks или внешние серверы MCP:
   • Функция каталога Unity: выберите схемы для функций. Это позволяет Genie Code использовать функции для выполнения предопределенных запросов SQL.
     • Для справки по поводу добавления серверов Github MCP см. статью создание сервера Github MCP
   • Векторный поиск: выберите схемы для индексов. Это позволяет Genie Code запрашивать индекс векторного поиска, чтобы найти соответствующие документы.
   • Пространство Genie: выберите пространство Genie. Genie MCP использует Genie в качестве инструмента, что позволяет осуществлять запросы в пространствах Genie для анализа данных с использованием естественного языка.
   • Подключение к каталогу Unity: выберите подключения, которые будут использоваться в качестве внешних серверов 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= ["*"]).
4. Нажмите кнопку Сохранить.

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

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