Agent 365 CLI-Befehlsreferenz develop-mcp

Verwalten von MCP-Servern in Dataverse-Umgebungen. Der Befehl develop-mcp bietet Optionen zum Veröffentlichen, Entveröffentlichen und Registrieren von MCP-Servern für den Einsatz in Dataverse-Umgebungen.

Note

Die develop-mcp approve, develop-mcp block, und develop-mcp package-mcp-server Befehle werden aus der CLI von Agent 365 entfernt. Tenant-Administratoren führen nun die Servergenehmigung und Sperrung im Microsoft Admin Center durch – ausstehende Anfragen werden auf der Seite Requested Agents geprüft. Die CLI erstellt keine MCP-Serverpakete mehr für die Einreichung an das Admin Center; Admins integrieren und verwalten Server direkt im Verwaltungszentrum.

Mindestrolle erforderlich: Variiert je nach Unterbefehl

Syntax

a365 develop-mcp [command] [options]

Options

Option	Description
-v, --verbose	Ausführliche Protokollierung aktivieren
-?, -h--help	Anzeigen von Hilfe- und Nutzungsinformationen

develop-mcp list-environments

Listet alle Dataverse-Umgebungen auf, die für die MCP-Serververwaltung verfügbar sind.

a365 develop-mcp list-environments [options]

Mit diesem Befehl werden alle Dataverse-Umgebungen angezeigt, in denen Sie MCP-Server verwalten können.

list-environments-Optionen

Option	Description
--dry-run	Zeigen Sie an, was ohne Ausführung geschehen würde.
-v, --verbose	Ausführliche Protokollierung aktivieren
-?, -h--help	Anzeigen von Hilfe- und Nutzungsinformationen

develop-mcp list-servers

Auflisten von MCP-Servern in einer bestimmten Dataverse-Umgebung.

a365 develop-mcp list-servers [options]

Dieser Befehl zeigt alle MCP-Server an, die derzeit in der angegebenen Dataverse-Umgebung bereitgestellt werden.

list-servers-Optionen

Option	Description
-e, --environment-id <environment-id>	Dataverse-Umgebungs-ID
--dry-run	Zeigen Sie an, was ohne Ausführung geschehen würde.
-v, --verbose	Ausführliche Protokollierung aktivieren
-?, -h--help	Anzeigen von Hilfe- und Nutzungsinformationen

develop-mcp publish

Veröffentlichen Sie einen MCP-Server in einer Dataverse-Umgebung.

a365 develop-mcp publish [options]

Verwenden Sie diesen Befehl, um einen MCP-Server in der angegebenen Dataverse-Umgebung zu veröffentlichen.

Beim Veröffentlichen erstellt die CLI eine <server-name>-PublicClients Microsoft Entra App-Registrierung in Ihrem Mieter. Diese App besitzt die OAuth-Berechtigungen, die Client-Hosts (wie Visual Studio Code und die Microsoft 365 Copilot CLI) verwenden, um den veröffentlichten MCP-Server aufzurufen. Da der Befehl eine App-Registrierung erstellt, muss das Konto, das die CLI ausführt, die Berechtigung Application.ReadWrite.All Microsoft Graph haben. Ohne sie zu laufen publish , schlägt fehl.

Note

Stellen Sie benutzerdefinierte (vom Nutzer erstellte) MCP-Server bereit --publisher-name . Der Wert wird in die Entwicklermetadaten des veröffentlichten Pakets geschrieben und ist für diese Server erforderlich. Es wird bei First-Party-Microsoft-eigenen Servern ignoriert (zum Beispiel msdyn_DataverseMCPServer), die immer als "Microsoft" veröffentlichen. Wenn du es weglässt, fordert die CLI interaktiv danach auf; übergehen --yes , um ohne Eingabeaufforderungen in CI oder geskripteten Kontexten zu veröffentlichen.

publish-Optionen

Option	Description
-e, --environment-id <environment-id>	Dataverse-Umgebungs-ID
-s, --server-name <server-name>	MCP-Servername, der veröffentlicht werden soll
-a, --alias <alias>	Alias für den MCP-Server
-d, --display-name <display-name>	Anzeigename für den MCP-Server
-p, --publisher-name <publisher-name>	Der Name des Publisher wurde in die Metadaten des veröffentlichten Pakets geschrieben. Erforderlich für benutzerdefinierte (benutzerdefinierte) MCP-Server; ignoriert zugunsten von First-Party-Servern von Microsoft. Interaktiv angefordert, wenn es weggelassen wurde.
-y, --yes	Überspringe das interaktive "Weiter mit dem Veröffentlichen? (y/N)" confirmation. Verwendung in CI- oder geskripteten Kontexten.
--dry-run	Zeigen Sie an, was ohne Ausführung geschehen würde.
-v, --verbose	Ausführliche Protokollierung aktivieren
-?, -h--help	Anzeigen von Hilfe- und Nutzungsinformationen

develop-mcp unpublish

Heben Sie die Veröffentlichung eines MCP-Servers aus einer Dataverse-Umgebung auf.

a365 develop-mcp unpublish [options]

Verwenden Sie diesen Befehl, um einen MCP-Server aus der angegebenen Dataverse-Umgebung zu entfernen.

unpublish-Optionen

Option	Description
-e, --environment-id <environment-id>	Dataverse-Umgebungs-ID
-s, --server-name <server-name>	MCP-Servername zum Aufheben der Veröffentlichung
--dry-run	Zeigen Sie an, was ohne Ausführung geschehen würde.
-?, -h--help	Anzeigen von Hilfe- und Nutzungsinformationen

develop-mcp register-external-mcp-server

Registrieren Sie einen externen MCP-Server bei Entra, externem OAuth, API-Schlüssel oder ohne Authentifizierung.

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

Verwenden Sie diesen Befehl, um einen extern gehosteten (Drittanbieter-) MCP-Server bei Ihrem Tenant zu registrieren. Der Befehl erstellt die Microsoft Entra-App-Registrierungen, die die Plattform benötigt, ruft die Agent 365-Plattform auf, um den MCP-Server hinzuzufügen, und konfiguriert umleitende URIs und API-Berechtigungen für die neuen App-Registrierungen.

Der Servername muss mit dem ext_ Präfix beginnen und maximal 20 Zeichen lang sein, zum Beispiel ext_MyServer. Werkzeugnamen müssen exakt mit den vom entfernten MCP-Server bereitgestellten Namen übereinstimmen. Nicht übereinstimmende Namen führen dazu, dass Werkzeugaufrufe zur Laufzeit fehlschlagen.

Sie können Parameter auf drei Arten bereitstellen:

• Geben Sie sie als Kommandozeilenoptionen durch.
• Stellen Sie eine JSON-Datei mit --input-file. Kommandozeilenoptionen überschreiben Werte aus der Datei. Siehe register-external-mcp-server-sample.json in den CLI-Vorlagen für die Dateistruktur.
• Lassen Sie alle erforderlichen Werte, die interaktiv angefordert werden müssen, weg.

Nachdem die Registrierung erfolgreich ist, bitte deinen Mieteradministrator, den neuen MCP-Server zu genehmigen, bevor Agenten ihn nutzen können. Wenn du dich mit ExternalOAuthregistriert hast, füge auch die angezeigte Redirect-URI deiner externen IDP-Anwendung hinzu.

Important

Wenn die Registrierung nach der Erstellung der Microsoft Entra-App-Registrierungen fehlschlägt, werden die Apps nicht automatisch zurückgesetzt. Lösche sie manuell im Azure-Portal, bevor du es erneut versuchst.

register-external-mcp-server-Optionen

Einige Optionen sind nur für bestimmte Authentifizierungstypen erforderlich, wie in der Spalte Beschreibung beschrieben.

Option	Description
-s, --server-name <server-name>	MCP-Servername. Muss zum Beispiel mit ext_ 20 Zeichen beginnen und höchstens 20 Zeichen umfassen ext_MyServer
-u, --server-url <server-url>	Entfernte MCP-Server-URL. Muss eine gültige HTTP- oder HTTPS-URL sein
-a, --auth-type <auth-type>	Authentifizierungstyp: EntraOAuth, ExternalOAuth, , APIKeyoder NoAuth
--publisher <publisher>	Publisher-Name (verwendet in Paketmetadaten)
--description <description>	Serverbeschreibung (verwendet in Paketmetadaten)
--tools <tools>	Komma-getrennte Liste von Werkzeugnamen, die von diesem Server offengelegt werden, zum Beispiel tool1,tool2,tool3
-f, --input-file <input-file>	Pfad zu einer JSON-Datei mit den Registrierungsparametern
--remote-scopes <remote-scopes>	Scopes für den entfernten MCP-Server, zum Beispiel api://{appId-guid}/{scopeName}. Wird mit EntraOAuth verwendet.
-t, --tenant-id <tenant-id>	Entra Tenant-ID für die App-Registrierung. Standardmäßig zum aktuellen az login Mieter
--service-tree-id <service-tree-id>	ServiceTree-ID für die Entra-App-Registrierung. Erforderlich in Microsoft-Unternehmensmietern
-l, --secret-lifetime-months <months>	Lebensdauer in Monaten (1–24) für generierte Client-Geheimnisse in den erstellten Entra-Apps. Standardmäßig 24 Monate (2 Jahre). Setzen Sie einen niedrigeren Wert als die appManagementPolicies Obergrenze Ihres Mieters, wenn Ihre Mieterpolice ein kürzeres Maximum durchsetzt
--idp-authorization-url <url>	Externe OAuth-Autorisierungs-URL. Erforderlich, wenn --auth-typeExternalOAuth
--idp-token-url <url>	Externe OAuth-Token-URL. Erforderlich, wenn --auth-typeExternalOAuth
--idp-scopes <scopes>	Externe OAuth-Scopes. Erforderlich, wenn --auth-typeExternalOAuth
--idp-client-id <client-id>	Externe OAuth-Client-ID. Erforderlich, wenn --auth-typeExternalOAuth
--idp-client-secret <client-secret>	Externes OAuth-Clientgeheimnis. Erforderlich, wenn --auth-typeExternalOAuth
--api-key-location <location>	API-Schlüsselstandort: Header oder Query. Erforderlich, wenn --auth-typeAPIKey
--api-key-name <name>	API-Schlüsselparameter oder Header-Name, zum Beispiel X-API-Key oder token. Erforderlich, wenn --auth-typeAPIKey
--dry-run	Zeigen Sie an, was ohne Ausführung geschehen würde.
-v, --verbose	Ausführliche Protokollierung aktivieren
-?, -h--help	Anzeigen von Hilfe- und Nutzungsinformationen