Dokumentacja poleceń interfejsu wiersza polecenia develop-mcp agenta 365

Zarządzanie serwerami MCP w środowiskach Dataverse. Polecenie to develop-mcp oferuje opcje publikowania, cofania i rejestrowania serwerów MCP do użycia w środowiskach Dataverse.

Note

Polecenia develop-mcp approve, develop-mcp block, i zostały usunięte develop-mcp package-mcp-server z CLI Agenta 365. Administratorzy dzierżawcy teraz wykonują zatwierdzanie i blokowanie serwera w Microsoft admin center — oczekujące żądania są przeglądane na stronie Requested Agents. CLI nie produkuje już pakietów serwerów MCP do przesyłania do Centrum Administracyjnego; Administratorzy wdrażają i zarządzają serwerami bezpośrednio w centrum administracyjnym.

Wymagana minimalna rola: różni się od podpolecenia

Syntax

a365 develop-mcp [command] [options]

Opcje

Option	Description
-v, --verbose	Włącz szczegółowe logowanie
-?, , -h--help	Pokaż informacje o pomocy i użytkowaniu

develop-mcp evaluate

Oceń swój serwer MCP pod kątem najlepszych praktyk naukowych, aby ocenić gotowość produkcyjną. To narzędzie generuje kompleksowy raport oceny z ocenami, wyjaśnieniami i zadaniami działania. Polecenie to odkrywa narzędzia, które udostępnia serwer MCP, wykonuje zestaw deterministycznych i ocenianych przez AI testów semantycznych względem ich schematów oraz tworzy raport HTML, który ocenia jakość schematu i wymienia priorytetowe zadania do poprawy.

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

evaluate Opcje

Option	Description
-u, --server-url <server-url>	Required. Streamowalny URL HTTP endpoint serwera MCP (zazwyczaj kończy się na /mcp).
--auth-token <auth-token>	Optional. Potrzebne tylko wtedy, gdy serwer MCP wymaga uwierzytelnienia. Token nosiciela dla serwera. Preferuj A365_MCP_AUTH_TOKEN zmienną środowiskową; token przekazywany w wierszu poleceń jest widoczny w listach procesów i historii powłoki.
-o, --output-dir <output-dir>	Katalog list kontrolnych i plików raportowych. Domyślnie przyjmuje aktualny katalog (.).
--eval-engine <eval-engine>	Który lokalny agent kodujący ocenia testy semantyczne: auto (domyślnie; spróbuj GitHub Copilot, potem Claude Code), github-copilot, claude-code lub none (pomiń punktację AI i spodziewaj się wstępnie ocenianej listy kontrolnej).
-v, --verbose	Włącz pełne rejestrowanie.
-?, , -h--help	Pokaż informacje o pomocy i użyciu.

przykłady evaluate

Ocena lokalnego serwera z automatycznym wyborem silnika:

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

Oceń uwierzytelniony serwer, z tokenem dostarczonym przez zmienną środowiskową i artefaktami zapisanymi w podfolderze:

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

Wygeneruj tylko listę kontrolną, a następnie oceń ją własnym LLM:

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

Wymusz utworzenie konkretnego silnika punktacji:

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

Dowiedz się, jak oceniać serwery MCP

evaluate zmiennych środowiskowych

Użyj poniższych zmiennych środowiskowych do uwierzytelniania i opcjonalnie kontroluj, z którego modelu korzysta każdy lokalny silnik punktacji.

Environment variable	Purpose
A365_MCP_AUTH_TOKEN	Token nosiciela dla serwera MCP, używany, gdy --auth-token nie jest przekazywany. Preferowany od flagi, ponieważ pozwala uniknąć tokena w listach procesów i historii powłoki.
A365_EVAL_COPILOT_MODEL	Przepisz model GitHub Copilot. Wymaga dokładnego identyfikatora modelu, na przykład claude-haiku-4.5.
A365_EVAL_CLAUDE_MODEL	Nadpisz model Claude Code. Akceptuje alias modelu (na przykład haiku) lub pełny identyfikator modelu.

develop-mcp list-environments

Wyświetl listę wszystkich środowisk Dataverse dostępnych do zarządzania serwerem MCP.

a365 develop-mcp list-environments [options]

To polecenie wyświetla wszystkie środowiska usługi Dataverse, w których można zarządzać serwerami MCP.

list-environments Opcje

Option	Description
--dry-run	Pokaż, co można zrobić bez wykonywania
-v, --verbose	Włącz szczegółowe logowanie
-?, , -h--help	Pokaż informacje o pomocy i użytkowaniu

develop-mcp list-servers

Wyświetlanie listy serwerów MCP w określonym środowisku Usługi Dataverse.

a365 develop-mcp list-servers [options]

To polecenie pokazuje wszystkie serwery MCP, które są obecnie wdrożone w określonym środowisku Dataverse.

list-servers Opcje

Option	Description
-e, --environment-id <environment-id>	Identyfikator środowiska Dataverse
--dry-run	Pokaż, co można zrobić bez wykonywania
-v, --verbose	Włącz szczegółowe logowanie
-?, , -h--help	Pokaż informacje o pomocy i użytkowaniu

develop-mcp publish

Publikowanie serwera MCP w środowisku usługi Dataverse.

a365 develop-mcp publish [options]

Użyj tego polecenia, aby opublikować serwer MCP w określonym środowisku Usługi Dataverse.

Po publikacji CLI tworzy rejestrację aplikacji <server-name>-PublicClients Microsoft Entra w Twoim tenantze. Ta aplikacja posiada uprawnienia OAuth, które hosty klientów (takie jak Visual Studio Code i Microsoft 365 Copilot CLI) używają do wywoływania opublikowanego serwera MCP. Ponieważ polecenie tworzy rejestrację aplikacji, konto uruchamiające CLI musi mieć uprawnienia Application.ReadWrite.All Microsoft Graph. Bieganie publish bez niego nie działa.

Note

Zapewnij --publisher-name niestandardowe (tworzone przez użytkownika) serwery MCP. Wartość ta jest zapisywana w metadanych deweloperskich opublikowanego pakietu i jest wymagana dla tych serwerów. Jest ignorowany na serwerach własności Microsoft (na przykład msdyn_DataverseMCPServer), które zawsze publikują jako "Microsoft". Gdy go pominiesz, CLI interaktywnie go wywołuje; --yes przejść do publikacji bez promptów w CI lub w scenariuszowych kontekstach.

publish Opcje

Option	Description
-e, --environment-id <environment-id>	Identyfikator środowiska Dataverse
-s, --server-name <server-name>	Nazwa serwera MCP do opublikowania
-a, --alias <alias>	Alias serwera MCP
-d, --display-name <display-name>	Nazwa wyświetlana serwera MCP
-p, --publisher-name <publisher-name>	Nazwa Publisher zapisana w opublikowanych metadanych pakietu. Wymagane dla niestandardowych (stworzonych przez użytkownika) serwerów MCP; ignorowane w przypadku serwerów należących do Microsoft pierwszej strony. Motywowane interaktywnie, gdy pominąłem.
-y, --yes	Pomiń interaktywne "Kontynuować z publikacją? (y/N)" confirmation. Zastosowanie w CI lub w kontekstach skryptowanych.
--dry-run	Pokaż, co można zrobić bez wykonywania
-v, --verbose	Włącz szczegółowe logowanie
-?, , -h--help	Pokaż informacje o pomocy i użytkowaniu

develop-mcp unpublish

Cofanie publikowania serwera MCP ze środowiska usługi Dataverse.

a365 develop-mcp unpublish [options]

Użyj tego polecenia, aby usunąć serwer MCP z określonego środowiska Dataverse.

unpublish Opcje

Option	Description
-e, --environment-id <environment-id>	Identyfikator środowiska Dataverse
-s, --server-name <server-name>	Nazwa serwera MCP do cofnięcia publikowania
--dry-run	Pokaż, co można zrobić bez wykonywania
-?, , -h--help	Pokaż informacje o pomocy i użytkowaniu

develop-mcp register-external-mcp-server

Zarejestruj zewnętrzny serwer MCP z Entra, zewnętrznym OAuth, kluczem API lub bez uwierzytelniania.

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

Użyj tego polecenia, aby zarejestrować zewnętrznie hostowany (zewnętrzne) serwer MCP w swoim tenantze. Polecenie tworzy rejestracje aplikacji Microsoft Entra potrzebne platformie, wywołuje platformę Agent 365, aby dodać serwer MCP, oraz konfiguruje URI przekierowania i uprawnienia API na nowych rejestracjach aplikacji.

Nazwa serwera musi zaczynać się od prefiksu ext_ i mieć maksymalnie 20 znaków, na przykład ext_MyServer. Nazwy narzędzi muszą dokładnie odpowiadać nazwam ujawnionym przez zdalny serwer MCP. Niedopasowane nazwy powodują, że wywołania narzędzi nie działają w czasie działania.

Możesz podać parametry na trzy sposoby:

• Przekażcie je jako opcje w wierszu poleceń.
• Dostarcz plik JSON z .--input-file Opcje wiersza poleceń nadpisują wartości z pliku. Zobacz register-external-mcp-server-sample.json w szablonach CLI dla struktury plików.
• Pomiń wymaganą wartość, którą można wywołać interaktywnie.

Po pomyślnej rejestracji poproś administratora dzierżawcy o zatwierdzenie nowego serwera MCP, zanim agenci będą mogli z niego korzystać. Jeśli zarejestrowałeś się przez ExternalOAuth, dodaj też wyświetlany URI przekierowania do swojej zewnętrznej aplikacji IDP.

Important

Jeśli rejestracja nie powiodła się po utworzeniu rejestracji aplikacji Microsoft Entra, aplikacje nie są automatycznie cofane. Usuń je ręcznie w portalu Azure przed ponowną próbą.

register-external-mcp-server Opcje

Niektóre opcje są wymagane tylko dla określonych typów uwierzytelniania, jak opisano w kolumnie opisu.

Option	Description
-s, --server-name <server-name>	Nazwa serwera MCP. Na przykład musi zaczynać się od ext_ i mieć maksymalnie 20 znaków ext_MyServer
-u, --server-url <server-url>	Adres URL zdalnego serwera MCP. Musi być poprawnym adresem HTTP lub HTTPS
-a, --auth-type <auth-type>	Typ uwierzytelniania: EntraOAuth, ExternalOAuth, APIKey, lub NoAuth
--publisher <publisher>	Nazwa Publisher (używana w metadanych pakietu)
--description <description>	Opis serwera (używany w metadanych pakietu)
--tools <tools>	Na przykład lista nazw narzędzi oddzielonych przecinkami ujawniona przez ten serwer tool1,tool2,tool3
-f, --input-file <input-file>	Ścieżka do pliku JSON z parametrami rejestracyjnymi
--remote-scopes <remote-scopes>	Na przykład api://{appId-guid}/{scopeName}dla zdalnego serwera MCP. Używany z EntraOAuth
-t, --tenant-id <tenant-id>	Entra tenant ID do rejestracji aplikacji. Domyślne na obecnym najemcy az login
--service-tree-id <service-tree-id>	ServiceTree ID dla rejestracji aplikacji Entra. Wymagane w korporacyjnych dzierżawcach Microsoft
-l, --secret-lifetime-months <months>	Żywotność w miesiącach (1-24) dla wygenerowanych sekretów klienta w utworzonych aplikacjach Entra. Domyślnie wychodzi 24 miesiące (2 lata). Ustaw wartość mniejszą niż appManagementPolicies limit w Twoim najemcy, jeśli twoja polityka najemcy wymaga krótszego maksimum
--idp-authorization-url <url>	Zewnętrzny adres autoryzacji OAuth. Wymagane, gdy --auth-type jest ExternalOAuth
--idp-token-url <url>	Zewnętrzny adres URL tokena OAuth. Wymagane, gdy --auth-type jest ExternalOAuth
--idp-scopes <scopes>	Zewnętrzne teleskopy OAuth. Wymagane, gdy --auth-type jest ExternalOAuth
--idp-client-id <client-id>	Zewnętrzny identyfikator klienta OAuth. Wymagane, gdy --auth-type jest ExternalOAuth
--idp-client-secret <client-secret>	Zewnętrzny sekret klienta OAuth. Wymagane, gdy --auth-type jest ExternalOAuth
--api-key-location <location>	Lokalizacja klucza API: Header lub Query. Wymagane, gdy --auth-type jest APIKey
--api-key-name <name>	Parametr klucza lub nazwa nagłówka API, na przykład X-API-Key lub token. Wymagane, gdy --auth-type jest APIKey
--dry-run	Pokaż, co można zrobić bez wykonywania
-v, --verbose	Włącz szczegółowe logowanie
-?, , -h--help	Pokaż informacje o pomocy i użytkowaniu