Naslaginformatie over cli-opdrachten develop voor agent 365

BEHEER MCP-hulpprogrammaservers voor agentontwikkeling. De develop opdracht biedt opties voor het beheren van MCP-hulpprogrammaservers (Model Context Protocol) voor agentontwikkeling. U kunt beschikbare servers weergeven, geconfigureerde servers weergeven en MCP-servers toevoegen aan of verwijderen uit uw agentconfiguratie.

Minimale rol vereist: Geen (lokaal manifestbeheer)

Syntax

a365 develop [command] [options]

Options

Option	Description
-v, --verbose	Uitgebreide logboekregistratie inschakelen
-?, , -h--help	Help- en gebruiksgegevens weergeven.

develop list-available

Geef alle MCP-servers weer die beschikbaar zijn in de catalogus (wat u kunt installeren).

a365 develop list-available [options]

Met deze opdracht worden alle MCP-servers weergegeven die beschikbaar zijn in de catalogus en kunt u deze installeren voor gebruik met uw agentontwikkeling.

list-available Opties

Option	Description
--dry-run	Weergeven wat de opdracht zou doen zonder deze uit te voeren.
--skip-auth	Skip authentication. Alleen voor testen. De opdracht mislukt waarschijnlijk zonder geldige verificatie.
-?, , -h--help	Help- en gebruiksgegevens weergeven.

Note

develop list-available vereist niet a365.config.json. Het leest de omgeving uit de A365_ENVIRONMENT omgevingsvariabele (standaard staat het prod).

develop list-configured

Vermeld momenteel geconfigureerde MCP-servers van uw lokale ToolingManifest.json.

a365 develop list-configured [options]

Met deze opdracht worden alle MCP-servers weergegeven die u momenteel hebt geconfigureerd in uw lokale ToolingManifest.json-bestand.

list-configured Opties

Option	Description
--project-path <path>	Pad naar de agent projectmap die bevat ToolingManifest.json. Overrides DeploymentProjectPath van a365.config.json.
--dry-run	Weergeven wat de opdracht zou doen zonder deze uit te voeren.
-?, , -h--help	Help- en gebruiksgegevens weergeven.

develop add-mcp-servers

MCP-servers toevoegen aan de huidige agentconfiguratie.

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

Met deze opdracht worden de opgegeven MCP-servers toegevoegd aan ToolingManifest.json de projectmap. Er worden geen machtigingen verleend aan de blauwdruk van de agent.

Important

Dit commando werkt alleen bij ToolingManifest.json - het geeft geen rechten aan de agent blueprint. Hoe je rechten toepast hangt af van waar je je bevindt in het opzetproces:

• Voor de eerste installatie: Ga verder met a365 setup all. MCP-machtigingen worden toegepast als onderdeel van het maken van de eerste blauwdruk.
• Nadat de blauwdruk al bestaat: een globale beheerder moet afzonderlijk worden uitgevoerd a365 setup permissions mcp . De beheerder moet verifiëren dat verwijst deploymentProjectPath naar de projectmap met de bijgewerkte ToolingManifest.json.

add-mcp-servers Argumenten

Geef een of meer MCP-servernamen op die u wilt toevoegen aan uw agentconfiguratie. U kunt meerdere servernamen opgeven, gescheiden door spaties.

Argument	Description
<servers>	Namen van de MCP-servers die moeten worden toegevoegd

add-mcp-servers Opties

Gebruik deze opties om het gedrag van de add-mcp-servers opdracht aan te passen.

Option	Description
--project-path <path>	Pad naar de agent projectmap die bevat ToolingManifest.json. Overrides DeploymentProjectPath van a365.config.json.
--dry-run	Weergeven wat de opdracht zou doen zonder deze uit te voeren.
-?, , -h--help	Help- en gebruiksgegevens weergeven.

develop remove-mcp-servers

MCP-servers verwijderen uit de huidige agentconfiguratie.

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

Met deze opdracht verwijdert u de opgegeven MCP-servers uit de huidige agentconfiguratie.

remove-mcp-servers Argumenten

Argument	Description
<servers>	Namen van de MCP-servers die moeten worden verwijderd

remove-mcp-servers Opties

Option	Description
--project-path <path>	Pad naar de agent projectmap die bevat ToolingManifest.json. Overrides DeploymentProjectPath van a365.config.json.
--dry-run	Weergeven wat de opdracht zou doen zonder deze uit te voeren.
-?, , -h--help	Help- en gebruiksgegevens weergeven.

develop add-permissions

Voeg API-machtigingen voor MCP-servers toe aan Microsoft Entra toepassingen voor ontwikkelingsscenario's waarbij u aangepaste toepassingen moet configureren voor toegang tot MCP-servers.

a365 develop add-permissions [options]

add-permissions Opties

Gebruik deze opties om vereiste API-machtigingen en -bereiken toe te voegen aan uw app-registratie, waarbij gebruik wordt gemaakt van waarden uit het hulpprogrammamanifest.

Option	Description
-m, --manifest <manifest>	Pad naar ToolingManifest.json (standaard: <deploymentProjectPath>/ToolingManifest.json)
--app-id <app-id>	Toepassings-id (client) om machtigingen toe te voegen aan (standaard: clientAppId van configuratie)
--scopes <scopes>	Specifieke bereiken die moeten worden toegevoegd (door spaties gescheiden) (standaard: Alle bereiken van ToolingManifest.json)
--dry-run	Weergeven wat de opdracht zou doen zonder wijzigingen aan te brengen
-v, --verbose	Gedetailleerde uitvoer weergeven
-?, , -h--help	Help- en gebruiksgegevens weergeven.

Important

De toepassing die is opgegeven door --app-id of clientAppId moet de machtiging Application.ReadWrite.All hebben in Microsoft Entra. Deze opdracht is bedoeld voor aangepaste clienttoepassingen. Als u machtigingen voor agentblauwdrukken wilt configureren, gebruikt a365 setup permissions mcp u in plaats daarvan.

develop get-token

Bearer-tokens ophalen voor het testen van MCP-servers tijdens de ontwikkeling met behulp van interactieve browserverificatie.

a365 develop get-token [options]

get-token Opties

Gebruik deze opties om een toegangstoken aan te vragen, bereiken te beheren, gedrag te vernieuwen en de uitvoerindeling te kiezen.

Option	Description
--app-id <app-id>	Toepassings-id (client) voor verificatie (standaard: clientAppId van configuratie)
-m, --manifest <manifest>	Pad naar ToolingManifest.json (standaard: <deploymentProjectPath>/ToolingManifest.json)
--scopes <scopes>	Specifieke bereiken die moeten worden aangevraagd (door spaties gescheiden) (standaard: lezen uit ToolingManifest.json)
-o, --output <output>	Uitvoerindeling: table, jsonof raw (standaard: table)
--force-refresh	Token vernieuwen omslaan van cache afdwingen
--device-code	Authenticeer je via de apparaatcodeflow in plaats van de interactieve browserflow (de Windows Account Manager (WAM) broker op Windows). Leer over get-token apparaatcode-authenticatie
--resource <resource>	Trefwoord resource voor het ophalen van token voor: mcp (standaard) of powerplatform
--resource-id <resource-id>	Id van aangepaste resourcetoepassing (GUID) voor resources die niet worden gedekt door --resource trefwoorden
-v, --verbose	Gedetailleerde uitvoer weergeven, inclusief volledig token
-?, , -h--help	Help- en gebruiksgegevens weergeven.

get-token resourceopties

Gebruik de opties --resource en --resource-id om tokens op te halen voor verschillende Azure resources:

• --resource: Gebruik een trefwoord om een vooraf gedefinieerde resource te selecteren:
  • mcp (standaard): Agent 365 Tools voor MCP-servers
  • powerplatform: Power Platform-API
• --resource-id: Voer een aangepaste id van de resourcetoepassing (GUID) in voor resources die niet worden gedekt door trefwoorden

Important

Je kunt geen A --resource Together gebruiken--resource-id. Wanneer u een van beide opties gebruikt, neemt u het volgende op --scopes. Alleen de standaard MCP-stroom biedt ondersteuning voor bereikomzetting op basis van manifesten.

get-token Apparaatcode-authenticatie

Op Windows gebruikt de standaard interactieve browserflow de Windows Account Manager (WAM) broker, die bepaalde Exchange-specifieke Microsoft Graph-scopes afwijst (bijvoorbeeld MailboxSettings.ReadWrite en ExchangeMessageTrace.Read.All).

Je hoeft dit niet zelf te detecteren. Als WAM de gevraagde scopes afwijst, rapporteert de CLI de afwijzing en probeert automatisch opnieuw met de apparaatcodeflow, zodat het commando nog steeds slaagt zonder --device-code.

Omdat WAM moet proberen en falen voordat de CLI opnieuw probeert, is de fallback trager en is de ervaring suboptimaal. Sla --device-code als je die flow vooraan wilt kiezen en de mislukte poging wilt vermijden:

• Je draait op een plek waar geen interactieve browser kan openen, zoals een externe terminal of SSH-sessie.
• Je weet al dat je Exchange-scopes aanvraagt en wilt de mislukte WAM-poging en de waarschuwing overslaan.
• Je draait get-token herhaaldelijk met dezelfde scopes, bijvoorbeeld over meerdere blueprints, waarbij de vertraging per run optelt.

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

a365 develop get-token @params

Het commando toont een URL (https://microsoft.com/devicelogin) en een code om het inloggen in je browser te voltooien.

develop start-mock-tooling-server

Start een mock tooling-server voor test- en ontwikkelingsdoeleinden.

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

Met deze opdracht wordt een mock tooling-server gestart voor test- en ontwikkelingsdoeleinden. Met behulp van deze server kunt u MCP-serverinteracties simuleren zonder daadwerkelijke server-implementaties te vereisen.

start-mock-tooling-server Opties

Gebruik deze opties om het gedrag van de start-mock-tooling-server opdracht aan te passen.

Option	Description	Default
-p, --port <port>	Poortnummer voor de mock-server	5309
-v, --verbose	Uitgebreide logboekregistratie inschakelen	false
-?, -h, --help	Help- en gebruiksgegevens weergeven	-
-bg	De server uitvoeren op een nieuwe terminal	-