Dokumentacja poleceń interfejsu wiersza polecenia develop-mcp agenta 365

Zarządzanie serwerami MCP w środowiskach Dataverse. Polecenie to develop-mcp oferuje opcje publikowania, cofnięcia, zatwierdzania, blokowania, pakowania i rejestrowania serwerów MCP do użycia w środowiskach Dataverse.

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 pomocy i użycia

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 pomocy i użycia

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 pomocy i użycia

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.

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
--dry-run	Pokaż, co można zrobić bez wykonywania
-?, , -h--help	Pokaż informacje pomocy i użycia

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 pomocy i użycia

develop-mcp approve

Zatwierdź serwer MCP.

a365 develop-mcp approve [options]

To polecenie zatwierdza serwer MCP do użycia w środowisku.

approve Opcje

Option	Description
-s, --server-name <server-name>	Nazwa serwera MCP do zatwierdzenia
--dry-run	Pokaż, co można zrobić bez wykonywania
-?, , -h--help	Pokaż informacje pomocy i użycia

develop-mcp block

Blokuj serwer MCP.

a365 develop-mcp block [options]

Użyj tego polecenia, aby zablokować używanie serwera MCP w środowisku.

block Opcje

Option	Description
-s, --server-name <server-name>	Nazwa serwera MCP do zablokowania
--dry-run	Pokaż, co można zrobić bez wykonywania
-?, , -h--help	Pokaż informacje pomocy i użycia

develop-mcp package-mcp-server

Wygeneruj pakiet serwera MCP do przesłania w centrum administracyjnym Microsoft.

a365 develop-mcp package-mcp-server [options]

Użyj tego polecenia, aby utworzyć pakiet wdrożeniowy dla serwera MCP, który można przesłać do centrum administracyjnego firmy Microsoft.

package-mcp-server Opcje

Option	Description
--server-name <server-name>	Nazwa serwera MCP (WYMAGANE)
--developer-name <developer-name>	Nazwa wyświetlana wydawcy lub dewelopera (WYMAGANE)
--icon-url <icon-url>	Publiczny adres URL do ikony PNG dla serwera MCP (WYMAGANE)
--output-path <output-path>	Katalog docelowy wygenerowanego pakietu ZIP (WYMAGANE)
--dry-run	Pokaż, co można zrobić bez wykonywania
-?, , -h--help	Pokaż informacje pomocy i użycia

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
--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 pomocy i użycia