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 evaluate

Bewerten Sie Ihren MCP-Server anhand wissenschaftlicher Best Practices, um die Produktionsbereitschaft zu beurteilen. Dieses Tool erstellt einen umfassenden Bewertungsbericht mit Werten, Erklärungen und Aktionspunkten. Der Befehl entdeckt die Werkzeuge, die ein MCP-Server bereitstellt, führt eine Reihe deterministischer und KI-bewerteter semantischer Prüfungen an deren Schemata durch und erstellt einen HTML-Bericht, der die Schemaqualität bewertet und priorisierte Aktionspunkte zur Verbesserung auflistet.

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

evaluate-Optionen

Option	Description
-u, --server-url <server-url>	Required. Die streambare HTTP-Endpunkt-URL des MCP-Servers (endet typischerweise mit /mcp).
--auth-token <auth-token>	Optional. Nur benötigt, wenn der MCP-Server eine Authentifizierung benötigt. Inhabertoken für den Server. Bevorzuge die A365_MCP_AUTH_TOKEN Umgebungsvariable; ein Token, das über die Befehlszeile weitergegeben wird, ist für Prozesslisten und Shell-Historie sichtbar.
-o, --output-dir <output-dir>	Verzeichnis für die Checklisten- und Berichtsdateien. Standardmäßig ist das aktuelle Verzeichnis (.).
--eval-engine <eval-engine>	Welcher lokale Codieragent bewertet die semantischen Prüfungen: auto (Standard; Versuche GitHub Copilot, dann Claude Code), github-copilot, claude-code oder none (KI-Bewertung überspringen und eine vorab bewertete Checkliste erwarten).
-v, --verbose	Ermöglicht das Erstellen ausführlicher Protokolldateien.
-?, -h, --help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

Beispiele für evaluate

Auswerten eines lokalen Servers mit automatischer Engine-Auswahl:

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

Werten Sie einen authentifizierten Server mit dem token aus, das über eine Umgebungsvariable bereitgestellt wird, und Artefakte, die in einen Unterordner geschrieben werden:

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

Generieren Sie nur die Prüfliste, und bewertet sie dann mit Ihrem eigenen LLM:

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

Erzwingen einer bestimmten Bewertungs-Engine:

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

Lerne, wie man MCP-Server bewertet

evaluate Umgebungsvariablen

Verwenden Sie die folgenden Umgebungsvariablen, um Authentifizierung bereitzustellen und optional zu steuern, welches Modell jede lokale Bewertungs-Engine verwendet.

Environment variable	Purpose
A365_MCP_AUTH_TOKEN	Inhabertoken für den MCP-Server, verwendet, wenn --auth-token er nicht weitergegeben wird. Bevorzugt gegenüber dem Flag, weil es den Token aus Prozesslisten und Shell-Historie heraushält.
A365_EVAL_COPILOT_MODEL	Überschreiben Sie das GitHub Copilot-Modell. Erfordert zum Beispiel claude-haiku-4.5eine exakte Modell-ID.
A365_EVAL_CLAUDE_MODEL	Überschreiben Sie das Claude-Code-Modell. Akzeptiert ein Modellalias (zum Beispiel haiku) oder eine vollständige Modell-ID.

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 listet alle MCP-Server auf, 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.

Important

Das Veröffentlichen eines MCP-Servers genehmigt ihn nicht. Die Veröffentlichung reicht den Server nur an deinen Tenant ein und erstellt eine ausstehende Genehmigungsanfrage. Bevor ein Agent den Server nutzen kann, muss ein Tenant-Administrator ihn auf der Seite "Requested Tools" im Microsoft 365 Admin Center genehmigen. Bis der Administrator die Anfrage genehmigt, bleibt der Server für Agenten nicht verfügbar. Wenn der Befehl erfolgreich ist, druckt die CLI eine Erinnerung aus, um Ihren Tenant-Administrator zu bitten, den Server zu genehmigen.

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

Erfahren Sie, wie Tenant-Administratoren MCP-Server genehmigen

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>	Name des MCP-Servers. 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-type ist ExternalOAuth
--idp-token-url <url>	Externe OAuth-Token-URL. Erforderlich, wenn --auth-type ist ExternalOAuth
--idp-scopes <scopes>	Externe OAuth-Scopes. Erforderlich, wenn --auth-type ist ExternalOAuth
--idp-client-id <client-id>	Externe OAuth-Client-ID. Erforderlich, wenn --auth-type ist ExternalOAuth
--idp-client-secret <client-secret>	Externes OAuth-Clientgeheimnis. Erforderlich, wenn --auth-type ist ExternalOAuth
--api-key-location <location>	API-Schlüsselstandort: Header oder Query. Erforderlich, wenn --auth-type ist APIKey
--api-key-name <name>	API-Schlüsselparameter oder Header-Name, zum Beispiel X-API-Key oder token. Erforderlich, wenn --auth-type ist APIKey
--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