Kommandoreferanse for Agent 365 CLI develop

Administrer MCP-verktøyservere for agentutvikling. Kommandoen develop inneholder alternativer for å administrere MCP-verktøyservere (Model Context Protocol) for agentutvikling. Du kan vise tilgjengelige servere, vise konfigurerte servere og legge til eller fjerne MCP-servere fra agentkonfigurasjonen.

Minimumsrolle kreves: Ingen (lokal manifestbehandling)

Syntax

a365 develop [command] [options]

Alternativer

Option Description
-v, --verbose Aktiver detaljert logging
-?, -h, --help Vis informasjon om hjelp og bruk.

develop list-available

Vis alle MCP-servere som er tilgjengelige i katalogen (det du kan installere).

a365 develop list-available [options]

Denne kommandoen viser alle MCP-servere som er tilgjengelige i katalogen, og du kan installere dem for bruk med agentutviklingen.

list-available Alternativer

Option Description
--dry-run Vis hva kommandoen ville gjort uten å kjøre den.
--skip-auth Skip authentication. Bare for testing. Kommandoen mislykkes sannsynligvis uten gyldig godkjenning.
-?, -h, --help Vis informasjon om hjelp og bruk.

Note

develop list-available krever ikke a365.config.json. Den leser miljøet fra miljøvariabelen A365_ENVIRONMENT (standard er ).prod

develop list-configured

Liste over for øyeblikket konfigurerte MCP-servere fra den lokale ToolingManifest.json.

a365 develop list-configured [options]

Denne kommandoen viser alle MCP-servere som du har konfigurert i den lokale ToolingManifest.json-filen.

list-configured Alternativer

Option Description
--project-path <path> Vei til agentprosjektmappen som inneholder ToolingManifest.json. Overstyringer DeploymentProjectPath fra a365.config.json.
--dry-run Vis hva kommandoen ville gjort uten å kjøre den.
-?, -h, --help Vis informasjon om hjelp og bruk.

develop add-mcp-servers

Legg til MCP-servere i gjeldende agentkonfigurasjon.

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

Denne kommandoen legger til de angitte MCP-serverne ToolingManifest.json i prosjektmappen. Den gir ikke tillatelse til agenttegningen.

Important

Denne kommandoen oppdateres ToolingManifest.json bare – den gir ikke tillatelser til agentens blueprint. Hvordan du bruker tillatelser avhenger av hvor du er i oppsettsprosessen:

  • Før første installasjon: Fortsett med a365 setup all. MCP-tillatelser brukes som en del av den første opprettingen av tegning.
  • Etter at tegningen allerede finnes: En global administrator må kjøre a365 setup permissions mcp separat. Administratoren må verifisere at det deploymentProjectPath peker på prosjektmappen som inneholder den oppdaterte ToolingManifest.json.

add-mcp-servers Argumenter

Angi ett eller flere MCP-servernavn som skal legges til agentkonfigurasjonen. Du kan angi flere servernavn atskilt med mellomrom.

Argument Description
<servers> Navn på MCP-serverne som skal legges til

add-mcp-servers Alternativer

Bruk disse alternativene til å tilpasse virkemåten til add-mcp-servers kommandoen.

Option Description
--project-path <path> Vei til agentprosjektmappen som inneholder ToolingManifest.json. Overstyringer DeploymentProjectPath fra a365.config.json.
--dry-run Vis hva kommandoen ville gjort uten å kjøre den.
-?, -h, --help Vis informasjon om hjelp og bruk.

develop remove-mcp-servers

Fjern MCP-servere fra gjeldende agentkonfigurasjon.

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

Denne kommandoen fjerner angitte MCP-servere fra gjeldende agentkonfigurasjon.

remove-mcp-servers Argumenter

Argument Description
<servers> Navn på MCP-serverne som skal fjernes

remove-mcp-servers Alternativer

Option Description
--project-path <path> Vei til agentprosjektmappen som inneholder ToolingManifest.json. Overstyringer DeploymentProjectPath fra a365.config.json.
--dry-run Vis hva kommandoen ville gjort uten å kjøre den.
-?, -h, --help Vis informasjon om hjelp og bruk.

develop add-permissions

Legg til API-tillatelser for MCP-server i Microsoft Entra programmer for utviklingsscenarioer der du må konfigurere egendefinerte programmer for å få tilgang til MCP-servere.

a365 develop add-permissions [options]

add-permissions Alternativer

Bruk disse alternativene til å legge til nødvendige API-tillatelser og omfang i appregistreringen, og dra nytte av verdier fra verktøymanifestet.

Option Description
-m, --manifest <manifest> Bane til ToolingManifest.json (standard: <deploymentProjectPath>/ToolingManifest.json)
--app-id <app-id> Program-ID (klient)-ID for å legge til tillatelser i (standard: clientAppId fra konfigurasjon)
--scopes <scopes> Bestemte omfang som skal legges til (mellomromsdelt) (standard: Alle omfang fra ToolingManifest.json)
--dry-run Vis hva kommandoen ville gjort uten å gjøre endringer
-v, --verbose Vis detaljerte utdata
-?, -h, --help Vis informasjon om hjelp og bruk.

Important

Programmet som er angitt av --app-id eller clientAppId, må ha tillatelsen Application.ReadWrite.All i Microsoft Entra. Denne kommandoen er for egendefinerte klientprogrammer. Hvis du vil konfigurere tillatelser for agenttegninger, bruker du a365 setup permissions mcp i stedet.

develop get-token

Hent bærertokener for testing av MCP-servere under utvikling ved hjelp av interaktiv nettlesergodkjenning.

a365 develop get-token [options]

get-token Alternativer

Bruk disse alternativene til å be om et tilgangstoken, kontrollere omfang, oppdatere virkemåte og velge utdataformat.

Option Description
--app-id <app-id> Program-ID for godkjenning (standard: clientAppId fra konfigurasjon)
-m, --manifest <manifest> Bane til ToolingManifest.json (standard: <deploymentProjectPath>/ToolingManifest.json)
--scopes <scopes> Bestemte omfang som skal bes om (mellomromseparert) (standard: Lese fra ToolingManifest.json)
-o, --output <output> Utdataformat: table, jsoneller raw (standard: table)
--force-refresh Tving oppdatering av tokenoppdatering utenom hurtigbuffer
--device-code Autentiser deg med enhetskodeflyten i stedet for den interaktive nettleserflyten (Windows Account Manager (WAM)-megleren på Windows). Lær om autentisering av get-token enhetskoder
--resource <resource> Ressursnøkkelord for å hente token for: mcp (standard) eller powerplatform
--resource-id <resource-id> Egendefinert ressursprogram-ID (GUID) for ressurser som ikke dekkes av --resource nøkkelord
-v, --verbose Vis detaljerte utdata, inkludert fullstendig token
-?, -h, --help Vis informasjon om hjelp og bruk.

get-token ressursalternativer

Bruk alternativene --resource og --resource-id for å få tokener for ulike Azure ressurser:

  • --resource: Bruk et nøkkelord til å velge en forhåndsdefinert ressurs:
    • mcp (standard): Agent 365-verktøy for MCP-servere
    • powerplatform: API for Power Platform
  • --resource-id: Angi en egendefinert ressursprogram-ID (GUID) for ressurser som ikke dekkes av nøkkelord

Important

Du kan ikke bruke --resource og --resource-id sammen. Når du bruker et av alternativene, kan du inkludere --scopes. Bare standard MCP-flyt støtter manifestbasert omfangsoppløsning.

get-token Enhetskodeautentisering

På Windows bruker den standard interaktive nettleserflyten Windows Account Manager (WAM)-megleren, som avviser visse Exchange-spesifikke Microsoft Graph-omfang (for eksempel MailboxSettings.ReadWrite og ExchangeMessageTrace.Read.All).

Du trenger ikke oppdage dette selv. Hvis WAM avviser de forespurte scopene, rapporterer CLI avvisningen og prøver automatisk på nytt med enhetskodeflyten, så kommandoen lykkes fortsatt uten --device-code.

Fordi WAM må forsøke og feile før CLI-en prøver på nytt, er fallbacken tregere og opplevelsen suboptimal. Bestå --device-code når du vil velge den flyten på forhånd og unngå det mislykkede forsøket:

  • Du kjører der ingen interaktiv nettleser kan åpnes, som for eksempel en ekstern terminal eller SSH-økt.
  • Du vet allerede at du ber om Exchange-scopes og vil hoppe over det mislykkede WAM-forsøket og advarselen.
  • Du kjører get-token gjentatte ganger med de samme scopene, for eksempel på tvers av flere blåkopier, hvor forsinkelsen per kjøring legger seg opp.
$params = @{
  ResourceId = "00000003-0000-0000-c000-000000000000"
  Scopes     = "MailboxSettings.ReadWrite ExchangeMessageTrace.Read.All"
  DeviceCode = $true
}

a365 develop get-token @params

Kommandoen viser en URL (https://microsoft.com/devicelogin) og en kode for å fullføre innlogging i nettleseren din.

develop start-mock-tooling-server

Start en mock-verktøyserver for test- og utviklingsformål.

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

Denne kommandoen starter en mock-verktøyserver for test- og utviklingsformål. Ved å bruke denne serveren kan du simulere samhandlinger mellom MCP-servere uten å kreve faktiske serverimplementeringer.

start-mock-tooling-server Alternativer

Bruk disse alternativene til å tilpasse virkemåten til start-mock-tooling-server kommandoen.

Option Description Default
-p, --port <port> Portnummer for mock-serveren 5309
-v, --verbose Aktiver detaljert logging false
-?, -h, --help Vis informasjon om hjelp og bruk -
-bg Kjør serveren på en ny terminal -