Agent 365 CLI-Befehlsreferenz develop

Verwalten Sie MCP-Toolserver für die Agententwicklung. Der develop Befehl bietet Optionen zum Verwalten von MCP-Toolservern (Model Context Protocol) für die Agententwicklung. Sie können verfügbare Server auflisten, konfigurierte Server anzeigen und MCP-Server aus Ihrer Agentkonfiguration hinzufügen oder entfernen.

Minimale Rolle erforderlich: Keine (lokale Manifestverwaltung)

Syntax

a365 develop [command] [options]

Options

develop list-available

Auflisten aller MCP-Server, die im Katalog verfügbar sind (was Sie installieren können).

a365 develop list-available [options]

Dieser Befehl zeigt alle MCP-Server an, die im Katalog verfügbar sind, und Sie können sie für die Verwendung mit Ihrer Agent-Entwicklung installieren.

list-available-Optionen

develop list-configured

Auflisten der derzeit konfigurierten MCP-Server von Ihrem lokalen ToolingManifest.json.

a365 develop list-configured [options]

Dieser Befehl zeigt alle MCP-Server an, die Sie derzeit in Ihrer lokalen ToolingManifest.json Datei konfiguriert haben.

list-configured-Optionen

develop add-mcp-servers

Fügen Sie MCP-Server zur aktuellen Agentkonfiguration hinzu.

a365 develop add-mcp-servers [<servers>...] [options]

Mit diesem Befehl werden die angegebenen MCP-Server ToolingManifest.json in Ihrem Projektordner hinzugefügt. Sie gewährt dem Agent-Blueprint keine Berechtigungen.It doesn't grant permissions to the agent blueprint.

add-mcp-servers-Argumente

Geben Sie einen oder mehrere MCP-Servernamen an, die Der Agentkonfiguration hinzugefügt werden sollen. Sie können mehrere Servernamen durch Leerzeichen getrennt angeben.

add-mcp-servers-Optionen

Verwenden Sie diese Optionen, um das Verhalten des add-mcp-servers Befehls anzupassen.

develop remove-mcp-servers

Entfernen Sie MCP-Server aus der aktuellen Agent-Konfiguration.

a365 develop remove-mcp-servers [<servers>...] [options]

Mit diesem Befehl werden angegebene MCP-Server aus der aktuellen Agent-Konfiguration entfernt.

remove-mcp-servers-Argumente

remove-mcp-servers-Optionen

develop add-permissions

Fügen Sie MCP-Server-API-Berechtigungen zu Microsoft Entra Anwendungen für Entwicklungsszenarien hinzu, in denen Sie benutzerdefinierte Anwendungen für den Zugriff auf MCP-Server konfigurieren müssen.

a365 develop add-permissions [options]

add-permissions-Optionen

Verwenden Sie diese Optionen, um Ihrer App-Registrierung erforderliche API-Berechtigungen und Bereiche hinzuzufügen und Werte aus dem Toolmanifest zu nutzen.

develop get-token

Rufen Sie Bearertoken zum Testen von MCP-Servern während der Entwicklung mithilfe der interaktiven Browserauthentifizierung ab.

a365 develop get-token [options]

get-token-Optionen

Verwenden Sie diese Optionen, um ein Zugriffstoken, Steuerelementbereiche, Aktualisierungsverhalten anzufordern und das Ausgabeformat auszuwählen.

get-token Ressourcenoptionen

Verwenden Sie die Optionen --resource und --resource-id, um Token für verschiedene Azure-Ressourcen abzurufen:

• --resource: Verwenden Sie ein Schlüsselwort, um eine vordefinierte Ressource auszuwählen:
  • mcp (Standard): Agent 365-Tools für MCP-Server
  • powerplatform: Power Platform-API
• --resource-id: Geben Sie eine benutzerdefinierte Ressourcenanwendungs-ID (GUID) für Ressourcen ein, die nicht von Schlüsselwörtern abgedeckt werden

get-token Gerätecode-Authentifizierung

Unter Windows verwendet der standardmäßige interaktive Browserfluss den Windows Account Manager (WAM)-Broker, der bestimmte Exchange-spezifische Microsoft Graph-Scopes ablehnt (zum Beispiel MailboxSettings.ReadWrite und ExchangeMessageTrace.Read.All).

Du musst das nicht selbst erkennen. Wenn WAM die angeforderten Scopes ablehnt, meldet die CLI die Ablehnung und versucht es automatisch erneut mit dem Gerätecodefluss, sodass der Befehl auch ohne --device-codeerfolgreich ist.

Da WAM es versuchen und scheitern muss, bevor die CLI erneut versucht wird, ist der Rückfall langsamer und die Erfahrung suboptimal. Bestehen --device-code , wenn du diesen Fluss von Anfang an wählen willst und den gescheiterten Versuch vermeiden willst:

• Du spielst dort, wo kein interaktiver Browser geöffnet werden kann, wie zum Beispiel ein entferntes Terminal oder eine SSH-Sitzung.
• Du weißt bereits, dass du Exchange-Scopes anforderst und möchtest den gescheiterten WAM-Versuch und dessen Warnung überspringen.
• Man läuft get-token wiederholt mit denselben Scopes, zum Beispiel über mehrere Baupläne, wobei sich die Verzögerung pro Durchlauf summiert.

$params = @{
  ResourceId = "00000003-0000-0000-c000-000000000000"
  Scopes     = "MailboxSettings.ReadWrite ExchangeMessageTrace.Read.All"
  DeviceCode = $true
}

a365 develop get-token @params

Der Befehl zeigt eine URL (https://microsoft.com/devicelogin) und einen Code an, um die Anmeldung in Ihrem Browser abzuschließen.

develop start-mock-tooling-server

Starten Sie einen Simulierten Toolingserver zu Test- und Entwicklungszwecken.

a365 develop start-mock-tooling-server [options]

Mit diesem Befehl wird ein Simulierter Toolserver für Test- und Entwicklungszwecke gestartet. Mithilfe dieses Servers können Sie MCP-Serverinteraktionen simulieren, ohne dass tatsächliche Serverimplementierungen erforderlich sind.

start-mock-tooling-server-Optionen

Verwenden Sie diese Optionen, um das Verhalten des start-mock-tooling-server Befehls anzupassen.