Справочник по команде agent 365 CLI develop-mcp

Управление серверами MCP в средах Dataverse. Команда develop-mcp предоставляет опции публикации, отмены публикации и регистрации MCP-серверов для использования в средах Dataverse.

Note

develop-mcp approveКоманды , develop-mcp blockи develop-mcp package-mcp-server удалены из CLI Agent 365. Администраторы арендаторов теперь выполняют утверждение и блокировку серверов в административном центре Microsoft — ожидающие запросы рассматриваются на странице Requested Agents. CLI больше не производит пакеты MCP-серверов для подачи в Административный центр; Администраторы внедряют и управляют серверами непосредственно в административном центре.

Минимальная необходимая роль: зависит от подразделения

Syntax

a365 develop-mcp [command] [options]

Options

Option	Description
-v, --verbose	Включение ведения подробного журнала
-?, -h, --help	Показывать справочную и пользовательскую информацию

develop-mcp evaluate

Оцените ваш MCP-сервер по научным лучшим практикам для оценки готовности производства. Этот инструмент формирует комплексный отчёт по оценке с баллами, объяснениями и задачами. Команда обнаруживает инструменты, которые предоставляет MCP-сервер, запускает набор детерминированных и AI-баллированных семантических проверок по их схемам и создаёт HTML-отчёт, оценивающий качество схемы и перечисляющий приоритетные задачи для улучшения.

a365 develop-mcp evaluate --server-url <server-url> [--auth-token <auth-token>] [options]

evaluate параметры

Option	Description
-u, --server-url <server-url>	Required. Потоковый HTTP-адрес конечной точки MCP-сервера (обычно заканчивается на /mcp).
--auth-token <auth-token>	Optional. Требуется только тогда, когда сервер MCP требует аутентификации. Жетон носителя для сервера. Предпочитайте A365_MCP_AUTH_TOKEN переменную среды; токен, переданный в командной строке, виден для обработки листингов и истории оболочки.
-o, --output-dir <output-dir>	Каталог для чек-листа и файлов отчетов. По умолчанию отображается текущий каталог (.).
--eval-engine <eval-engine>	Какой локальный агент по программированию оценивает семантические проверки: auto (по умолчанию; попробуйте GitHub Copilot, затем Claude Code), github-copilot, claude-code или none (пропустите AI-подсчёт и ожидайте предварительно оценённый чек-лист).
-v, --verbose	Включите подробное логирование.
-?, -h, --help	Показать справку и информацию об использовании.

примеры evaluate

Оцените локальный сервер с автоматическим выбором обработчика:

a365 develop-mcp evaluate --server-url "http://localhost:5000/mcp"

Оцените сервер, прошедший проверку подлинности, с маркером, предоставленным через переменную среды, и артефактами, записанными во вложенную папку:

$env:A365_MCP_AUTH_TOKEN = "<bearer-token>"
a365 develop-mcp evaluate --server-url "https://my-mcp-server.contoso.com/mcp" --output-dir "./eval"

Создайте только контрольный список, а затем оставьте его с помощью собственного LLM:

a365 develop-mcp evaluate --server-url "https://my-mcp-server.contoso.com/mcp" --eval-engine none

Принудительное выполнение определенного механизма оценки:

a365 develop-mcp evaluate --server-url "http://localhost:5000/mcp" --eval-engine claude-code

Узнайте, как оценивать MCP-серверы

переменные среды evaluate

Используйте следующие переменные среды для обеспечения аутентификации и, по желанию, контролировать, какую модель использует каждый локальный движок оценки.

Environment variable	Purpose
A365_MCP_AUTH_TOKEN	Токен носителя для MCP-сервера, используется, когда --auth-token не передаётся. Предпочтительнее флага, потому что он не даёт токен попадать в листинги процессов и историю shell.
A365_EVAL_COPILOT_MODEL	Отменить модель GitHub Copilot. Требуется точный идентификатор модели, например claude-haiku-4.5.
A365_EVAL_CLAUDE_MODEL	Отменить модель Клода Кода. Принимает псевдоним модели (например haiku) или полный идентификатор модели.

develop-mcp list-environments

Список всех сред Dataverse, доступных для управления серверами MCP.

a365 develop-mcp list-environments [options]

Эта команда отображает все среды Dataverse, где можно управлять MCP-серверами.

list-environments параметры

Option	Description
--dry-run	Показать, что будет сделано без выполнения
-v, --verbose	Включение ведения подробного журнала
-?, -h, --help	Показывать справочную и пользовательскую информацию

develop-mcp list-servers

Вывод списка серверов MCP в определенной среде Dataverse.

a365 develop-mcp list-servers [options]

Эта команда содержит список всех MCP-серверов, которые в данный момент развернуты в указанной среде Dataverse.

list-servers параметры

Option	Description
-e, --environment-id <environment-id>	ИД среды Dataverse
--dry-run	Показать, что будет сделано без выполнения
-v, --verbose	Включение ведения подробного журнала
-?, -h, --help	Показывать справочную и пользовательскую информацию

develop-mcp publish

Публикация сервера MCP в среде Dataverse.

a365 develop-mcp publish [options]

Используйте эту команду для публикации MCP-сервера в указанной среде Dataverse.

Important

Публикация MCP-сервера не одобряет его. Публикация только отправляет сервер вашему арендатору и создаёт ожидающий запрос на одобрение. Прежде чем любой агент сможет использовать сервер, администратор арендатора должен одобрить его на странице «Запрошенные инструменты» в Центр администрирования Microsoft 365. Пока администратор не одобрит запрос, сервер остаётся недоступным для агентов. Когда команда выполнена успешно, CLI печатает напоминание попросить администратора арендатора одобрить сервер.

Когда вы публикуете, CLI создаёт регистрацию приложения <server-name>-PublicClients Microsoft Entra в вашем арендаторе. Это приложение содержит права OAuth, которые клиентские хосты (такие как Visual Studio Code и Microsoft 365 Copilot CLI) используют для вызова опубликованного MCP-сервера. Поскольку команда создаёт регистрацию приложения, учетная запись, использующая CLI, должна иметь разрешение Application.ReadWrite.All Microsoft Graph. Бегать publish без него не получается.

Note

Обеспечить --publisher-name пользовательские (пользовательские) MCP-серверы. Значение записывается в метаданные разработчика опубликованного пакета и требуется для этих серверов. Это игнорируется для серверов, принадлежащих Microsoft от первого лица (например, msdyn_DataverseMCPServer), которые всегда публикуются как «Microsoft». Когда вы его опускаете, CLI интерактивно подсказывает об этом; --yes пропускать для публикации без подсказок в CI или скриптовых контекстах.

publish параметры

Option	Description
-e, --environment-id <environment-id>	ИД среды Dataverse
-s, --server-name <server-name>	Имя сервера MCP для публикации
-a, --alias <alias>	Псевдоним для сервера MCP
-d, --display-name <display-name>	Отображаемое имя сервера MCP
-p, --publisher-name <publisher-name>	Имя Publisher записывается в метаданные опубликованного пакета. Требуется для пользовательских (пользовательских) MCP-серверов; игнорируется для серверов, принадлежащих Microsoft. Появляется интерактивный запрос, когда его опускают.
-y, --yes	Пропустите интерактивное сообщение «Продолжить с публикацией?» (y/N)" confirmation. Использование в CI или скриптовых контекстах.
--dry-run	Показать, что будет сделано без выполнения
-v, --verbose	Включение ведения подробного журнала
-?, -h, --help	Показывать справочную и пользовательскую информацию

Узнайте, как администраторы арендаторов одобряют серверы MCP

develop-mcp unpublish

Отмена публикации сервера MCP из среды Dataverse.

a365 develop-mcp unpublish [options]

Используйте эту команду, чтобы удалить MCP-сервер из указанной среды Dataverse.

unpublish параметры

Option	Description
-e, --environment-id <environment-id>	ИД среды Dataverse
-s, --server-name <server-name>	Имя сервера MCP для отмены публикации
--dry-run	Показать, что будет сделано без выполнения
-?, -h, --help	Показывать справочную и пользовательскую информацию

develop-mcp register-external-mcp-server

Зарегистрируйте внешний MCP-сервер с Entra, внешним OAuth, API-ключом или без аутентификации.

a365 develop-mcp register-external-mcp-server [options]

Используйте эту команду, чтобы зарегистрировать внешне размещённый (сторонний) MCP-сервер у вашего арендатора. Команда создаёт регистрацию приложений Microsoft Entra, необходимую платформе, вызывает платформу Agent 365 для добавления MCP-сервера и настраивает URI и разрешения на новые регистрации приложений.

Имя сервера должно начинаться с ext_ префикса и иметь не более 20 символов, например ext_MyServer. Имена инструментов должны точно совпадать с именами, представленными удалённым MCP-сервером. Несовпадающие имена приводят к неудачам вызовов инструментов во время выполнения.

Параметры можно предоставить тремя способами:

• Передайте их как опции командной строки.
• Предоставьте JSON-файл с --input-file. Параметры командной строки переопределяют значения из файла. См. register-external-mcp-server-sample.json структуру файла в шаблонах CLI.
• Опустите любое необходимое значение для интерактивного запроса.

После успешной регистрации попросите администратора арендатора одобрить новый MCP-сервер до того, как агенты смогут им пользоваться. Если вы зарегистрировались у ExternalOAuth, также добавьте отображаемый URI перенаправления в ваше внешнее приложение IDP.

Important

Если регистрация не проходит после создания регистраций в приложении Microsoft Entra, приложения не откатываются автоматически. Удаляйте их вручную в портале Azure перед повторной попыткой.

register-external-mcp-server параметры

Некоторые опции требуются только для определённых типов аутентификации, как описано в колонке описания.

Option	Description
-s, --server-name <server-name>	Имя сервера MCP. Например, он должен начинаться с ext_ и иметь максимум 20 символов ext_MyServer
-u, --server-url <server-url>	Удалённый URL сервера MCP. Должен быть действительный HTTP или HTTPS URL
-a, --auth-type <auth-type>	Тип аутентификации: EntraOAuth, ExternalOAuth, APIKey, или NoAuth
--publisher <publisher>	Publisher name (используется в метаданных пакета)
--description <description>	Описание сервера (используется в метаданных пакета)
--tools <tools>	Например, список имён инструментов с разделёнными запятой на этом сервере tool1,tool2,tool3
-f, --input-file <input-file>	Путь к JSON-файлу с параметрами регистрации
--remote-scopes <remote-scopes>	Scopes для удалённого MCP-сервера, например api://{appId-guid}/{scopeName}. Используется с EntraOAuth.
-t, --tenant-id <tenant-id>	Идентификатор арендатора Entra для регистрации приложения. По умолчанию текущий az login арендатор
--service-tree-id <service-tree-id>	ServiceTree ID для регистрации приложения Entra. Обязательно в корпоративных арендаторах Microsoft
-l, --secret-lifetime-months <months>	Срок жизни в месяцах (1-24) для сгенерированных клиентских секретов в созданных приложениях Entra. По умолчанию — 24 месяца (2 года). Установите стоимость меньше, чем appManagementPolicies лимит у вашего арендатора, если ваша политика предусматривает более короткий максимум
--idp-authorization-url <url>	Внешний URL авторизации OAuth. Требуется, если --auth-type имеет значение ExternalOAuth
--idp-token-url <url>	Внешний URL токена OAuth. Требуется, если --auth-type имеет значение ExternalOAuth
--idp-scopes <scopes>	Внешние телескопы OAuth. Требуется, если --auth-type имеет значение ExternalOAuth
--idp-client-id <client-id>	Внешний идентификатор клиента OAuth. Требуется, если --auth-type имеет значение ExternalOAuth
--idp-client-secret <client-secret>	Секрет внешнего клиента OAuth. Требуется, если --auth-type имеет значение ExternalOAuth
--api-key-location <location>	Местоположение ключа API: Header или Query. Требуется, если --auth-type имеет значение APIKey
--api-key-name <name>	Параметр ключа API или имя заголовка, например X-API-Key или token. Требуется, если --auth-type имеет значение APIKey
--dry-run	Показать, что будет сделано без выполнения
-v, --verbose	Включение ведения подробного журнала
-?, -h, --help	Показывать справочную и пользовательскую информацию