Справочник по команде 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 grant-agents-access

Предоставьте разрешение MCP-сервера с приведением собственного (BYO) на идентификацию агентов, которым его отсутствует.

a365 develop-mcp grant-agents-access --mcp-server-name <NAME> --agent-blueprint-id <GUID> [options]

Минимальные необходимые разрешения: Глобальный администратор (или другая роль с правом создавать разрешения на OAuth2 на уровне арендатора)

Используйте эту команду, чтобы найти и исправить идентификаторы агентов, которые не могут вызвать MCP-сервер с использованием BYO, потому что у них отсутствует разрешение Tools.ListInvoke.All . В команде отображаются экземпляры агентов указанного чертежа, которым отсутствует разрешение, а затем позволяет выбрать, кому его предоставить.

Имя сервера MCP разрешается в приложении Microsoft Entra, где - BYO к именю добавляется. Например, ext_Learn1 преобразуется в ext_Learn1 - BYO. Сам грант является делегированным OAuth2 разрешением на принципалAllPrincipals обслуживания этого приложения, поэтому он применяется ко всем текущим и будущим экземплярам агента чертежа, а не только к тем, кто перечислен во время выполнения.

Обычно вы не знаете чертеж GUID заранее. Если вы --agent-blueprint-id не имеете значения или недействительное, печатаете имена и идентификаторы чертежей Microsoft от первого производителя, чтобы вы могли их найти. Проходящий --help печатает тот же список.

После того как команда сообщает, что экземпляры агентов отсутствуют разрешение, all нажмите Enter, чтобы предоставить его каждому отображаемому экземпляру, добавить список чисел с разделёнными запятой (например, 1,3), чтобы предоставить его конкретным экземплярам, или нажмите Enter , чтобы пропустить разрешение. Pass --yes to grant на все указанные экземпляры без подсказки, например, в скрипте.

Если несколько приложений Entra используют одинаковое <name> - BYO имя отображаемого дисплея, команда перечисляет все совпадения и спрашивает, какое из них использовать, вместо того чтобы угадывать.

grant-agents-access варианты

Option	Description
--agent-blueprint-id <agent-blueprint-id>	Идентификатор чертежа агента (GUID) для проверки экземпляров агентов. Если эту опцию отключить или указать недействительное значение, команда печатает имена и идентификаторы чертежей первого лица.
-s, --mcp-server-name <mcp-server-name>	Required. Имя сервера MCP. Приложение Entra разрешается как <name> - BYO.
--tenant-id <tenant-id>	Идентификатор клиента Azure AD. По умолчанию переходит в текущий контекст Azure CLI.
-y, --yes	Дайте отсутствующее разрешение каждому зарегистрированному экземпляру агента без запроса.
--device-code	Используйте аутентификацию кода устройства вместо интерактивного потока браузера (WAM-брокер на Windows). Используйте тогда, когда WAM не может показывать диалог входа, например, встроенный или удалённый терминал. Открывается https://microsoft.com/devicelogin в браузере.
--dry-run	Сообщите, какие экземпляры агентов не имеют разрешения без его предоставления.
-v, --verbose	Включить подробное журналирование
-?, -h, --help	Показывать справочную и пользовательскую информацию

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 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	Показывать справочную и пользовательскую информацию