Регистрация серверов MCP, размещенных в Функциях Azure в Центре API Azure

После удаленного размещения сервера MCP в Функциях Azure зарегистрируйте его в Центре API Azure. Центр API Azure поддерживает инвентаризацию (или реестр) удаленных серверов MCP, чтобы они были легко обнаружимы в организации. Все зарегистрированные серверы MCP отображаются на портале Центра API для команд в вашей организации.

Подсказка

Имя Центра API становится именем каталога частных инструментов в фильтре реестра. Выберите информативное имя, которое помогает пользователям определить каталог инструментов вашей организации.

Создание ресурсов

1. Войдите на портал Azure, а затем создайте ресурс Центра API Azure, если у вас еще нет.

2. Создайте среду в ресурсе Центра API. Длятипа> выберите "Функции Azure".

Регистрация сервера MCP

Зарегистрируйте удаленный сервер MCP, добавив его в качестве API:

1. В левой области навигации ресурса Центра API выберите API.

2. Выберите и зарегистрируйте API. В следующей таблице приведены примеры значений необходимых параметров. Вы также можете заполнить дополнительные параметры, такие как описание сервера MCP, репозиторий, внешнюю документацию и другие сведения, отображаемые на портале Центра API.

   Setting	Ценность
   Название API	Введите описательное имя сервера MCP, например Weather MCP Server.
   Идентификация	Это значение автоматически создается на основе заголовка API, но его можно изменить.
   Тип API.	MCP
   URL-адрес среды выполнения	Введите конечную точку сервера MCP, например https://contoso.azurewebsites.net/mcp
   Окружающая среда	Выберите среду, созданную ранее.
   Название версии	Введите название версии, например v1.
   Идентификация версий	После ввода предыдущего заголовка Центр API Azure создает этот идентификатор, который можно переопределить.
   Жизненный цикл версии	Выберите наиболее подходящее значение в раскрывающемся списке, например тестирование или производство.

3. Нажмите кнопку "Создать".

   Теперь сервер MCP зарегистрирован в качестве API в списке.

Обновление определения сервера

1. Создайте определение API для удаленного сервера MCP в формате OpenAPI 3.0. Это определение необходимо, чтобы портал Центра API отображал конечную точку URL-адреса сервера MCP. Сохраните определение, где вы можете получить доступ к нему. На следующем шаге необходимо загрузить его.

   Пример определения API OpenAPI 3.0 для сервера MCP:

   {
       "openapi": "3.0.0",
       "info": {
           "title": "Weather MCP server",
           "description": "MCP server with tools returning weather forecast and alerts.",
           "version": "1.0"
       },
       "servers": [
           {
               "url": "https://my-mcp-server.azurewebsites.net/mcp"
           }
       ]
   }
   

2. Обновите определение сервера:

   a. В меню слева найдите ресурсы —> API.

   б. Выберите имя сервера MCP, чтобы открыть регистрацию.

   c. В меню слева найдите сведения о> версиях.

   d. В разделе "Версия" найдите и разверните "v1". Затем выберите Streamable Definition for... , чтобы открыть определение.

   d. Выберите Заменить.

   д) В открывающейся боковой области измените "Версия спецификации" на 3.0, а затем отправьте определение с последнего шага.

   f. Выберите Заменить.

Настройка портала Центра API

1. Настройте портал, если у вас еще нет этого портала.

2. После настройки портала вы можете получить доступ к нему по адресу https://<service-name>.portal.<location>.azure-apicenter.ms. Замените <service-name> и <location> на имя вашего центра API и место, где он развернут. Чтобы увидеть зарегистрированные серверы MCP, необходимо войти.

3. При выборе имени сервера откроется панель с информацией на основе данных, предоставляемых во время регистрации сервера и переданного определения API. Пользователи с доступом к порталу могут подключаться к серверам по своему выбору, копируя URL-адрес конечной точки или устанавливая интеграцию Visual Studio Code.

   

Связанные статьи

Сведения о серверах MCP в службе "Управление API Azure"