Agent 365 CLI-Befehlsreferenz develop-mcp

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

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
-c, --config <config> Konfigurationsdateipfad (Standard: a365.config.json)
--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
-c, --config <config> Konfigurationsdateipfad (Standard: a365.config.json)
--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.

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
-c, --config <config> Konfigurationsdateipfad (Standard: a365.config.json)
--dry-run Zeigen Sie an, was ohne Ausführung geschehen würde.
-?, -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
-c, --config <config> Konfigurationsdateipfad (Standard: a365.config.json)
--dry-run Zeigen Sie an, was ohne Ausführung geschehen würde.
-?, -h--help Anzeigen von Hilfe- und Nutzungsinformationen

develop-mcp approve

Genehmigen eines MCP-Servers.

a365 develop-mcp approve [options]

Dieser Befehl genehmigt einen MCP-Server für die Verwendung in der Umgebung.

approve-Optionen

Option Description
-s, --server-name <server-name> MCP-Servername, der genehmigt werden soll
-c, --config <config> Konfigurationsdateipfad (Standard: a365.config.json)
--dry-run Zeigen Sie an, was ohne Ausführung geschehen würde.
-?, -h--help Anzeigen von Hilfe- und Nutzungsinformationen

develop-mcp block

Blockieren eines MCP-Servers.

a365 develop-mcp block [options]

Verwenden Sie diesen Befehl, um zu verhindern, dass ein MCP-Server in Ihrer Umgebung verwendet wird.

block-Optionen

Option Description
-s, --server-name <server-name> MCP-Servername, der blockiert werden soll
-c, --config <config> Konfigurationsdateipfad (Standard: a365.config.json)
--dry-run Zeigen Sie an, was ohne Ausführung geschehen würde.
-?, -h--help Anzeigen von Hilfe- und Nutzungsinformationen

develop-mcp package-mcp-server

Generieren Sie MCP-Serverpaket für die Übermittlung im Microsoft Admin Center.

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

Verwenden Sie diesen Befehl, um ein Bereitstellungspaket für einen MCP-Server zu erstellen, den Sie an das Microsoft Admin Center übermitteln können.

package-mcp-server-Optionen

Option Description
--server-name <server-name> MCP-Servername (ERFORDERLICH)
--developer-name <developer-name> Publisher- oder Entwickleranzeigename (ERFORDERLICH)
--icon-url <icon-url> Öffentliche URL zu einem PNG-Symbol für den MCP-Server (ERFORDERLICH)
--output-path <output-path> Zielverzeichnis für das generierte ZIP-Paket (REQUIRED)
--dry-run Zeigen Sie an, was ohne Ausführung geschehen würde.
-c, --config <config> Konfigurationsdateipfad (Standard: a365.config.json)
-?, -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
--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
  • Last updated on