Kommandoreferens för Agent 365 CLI develop

Hantera MCP-verktygsservrar för agentutveckling. Kommandot develop innehåller alternativ för att hantera MCP-verktygsservrar (Model Context Protocol) för agentutveckling. Du kan visa tillgängliga servrar, visa konfigurerade servrar och lägga till eller ta bort MCP-servrar från agentkonfigurationen.

Minsta roll krävs: Ingen (lokal manifesthantering)

Syntax

a365 develop [command] [options]

Options

Option Description
-v, --verbose Aktivera utförlig loggning
-?, -h, --help Visa hjälp- och användningsinformation.

develop list-available

Visa en lista över alla MCP-servrar som är tillgängliga i katalogen (vad du kan installera).

a365 develop list-available [options]

Det här kommandot visar alla MCP-servrar som är tillgängliga i katalogen och du kan installera dem för användning med din agentutveckling.

list-available Alternativ

Option Description
--dry-run Visa vad kommandot skulle göra utan att köra det.
--skip-auth Skip authentication. Endast för testning. Kommandot misslyckas troligen utan giltig autentisering.
-?, -h, --help Visa hjälp- och användningsinformation.

Note

develop list-available kräver inte a365.config.json. Den läser miljön från miljövariabeln A365_ENVIRONMENT (standardinställning till prod).

develop list-configured

Lista för närvarande konfigurerade MCP-servrar från din lokala ToolingManifest.json.

a365 develop list-configured [options]

Det här kommandot visar alla MCP-servrar som du har konfigurerat i din lokala ToolingManifest.json-fil.

list-configured Alternativ

Option Description
--project-path <path> Sökväg till agentprojektkatalogen som innehåller ToolingManifest.json. Överstyrningar DeploymentProjectPath från a365.config.json.
--dry-run Visa vad kommandot skulle göra utan att köra det.
-?, -h, --help Visa hjälp- och användningsinformation.

develop add-mcp-servers

Lägg till MCP-servrar i den aktuella agentkonfigurationen.

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

Det här kommandot lägger till de angivna MCP-servrarna ToolingManifest.json i projektmappen. Den beviljar inte behörigheter till agentritningen.

Important

Detta kommando uppdateras ToolingManifest.json bara – det ger inte behörigheter till agentens blueprint. Hur du tillämpar behörigheter beror på var du befinner dig i installationsprocessen:

  • Före den första installationen: Fortsätt med a365 setup all. MCP-behörigheter tillämpas som en del av den första skissen.
  • När skissen redan finns: En global administratör måste köras a365 setup permissions mcp separat. Administratören måste verifiera att det deploymentProjectPath pekar på projektmappen som innehåller den uppdaterade ToolingManifest.json.

add-mcp-servers Argument

Ange ett eller flera MCP-servernamn som ska läggas till i agentkonfigurationen. Du kan ange flera servernamn avgränsade med blanksteg.

Argument Description
<servers> Namn på DE MCP-servrar som ska läggas till

add-mcp-servers Alternativ

Använd de här alternativen för att anpassa kommandots add-mcp-servers beteende.

Option Description
--project-path <path> Sökväg till agentprojektkatalogen som innehåller ToolingManifest.json. Överstyrningar DeploymentProjectPath från a365.config.json.
--dry-run Visa vad kommandot skulle göra utan att köra det.
-?, -h, --help Visa hjälp- och användningsinformation.

develop remove-mcp-servers

Ta bort MCP-servrar från den aktuella agentkonfigurationen.

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

Det här kommandot tar bort angivna MCP-servrar från din aktuella agentkonfiguration.

remove-mcp-servers Argument

Argument Description
<servers> Namn på DE MCP-servrar som ska tas bort

remove-mcp-servers Alternativ

Option Description
--project-path <path> Sökväg till agentprojektkatalogen som innehåller ToolingManifest.json. Överstyrningar DeploymentProjectPath från a365.config.json.
--dry-run Visa vad kommandot skulle göra utan att köra det.
-?, -h, --help Visa hjälp- och användningsinformation.

develop add-permissions

Lägg till MCP-server-API-behörigheter för att Microsoft Entra program för utvecklingsscenarier där du behöver konfigurera anpassade program för åtkomst till MCP-servrar.

a365 develop add-permissions [options]

add-permissions Alternativ

Använd de här alternativen om du vill lägga till nödvändiga API-behörigheter och omfång i din appregistrering och använda värden från verktygsmanifestet.

Option Description
-m, --manifest <manifest> Sökväg till ToolingManifest.json (standard: <deploymentProjectPath>/ToolingManifest.json)
--app-id <app-id> Program-ID (klient)-ID för att lägga till behörigheter till (standard: clientAppId från konfiguration)
--scopes <scopes> Specifika omfång som ska läggas till (blankstegsavgränsade) (standard: Alla omfång från ToolingManifest.json)
--dry-run Visa vad kommandot skulle göra utan att göra ändringar
-v, --verbose Visa detaljerade utdata
-?, -h, --help Visa hjälp- och användningsinformation.

Important

Programmet som anges av --app-id eller clientAppId måste ha behörigheten Application.ReadWrite.All i Microsoft Entra. Det här kommandot är för anpassade klientprogram. Om du vill konfigurera behörigheter för agentritningar använder du a365 setup permissions mcp i stället.

develop get-token

Hämta ägartoken för att testa MCP-servrar under utveckling med hjälp av interaktiv webbläsarautentisering.

a365 develop get-token [options]

get-token Alternativ

Använd de här alternativen för att begära en åtkomsttoken, kontrollera omfång, uppdatera beteende och välja utdataformatet.

Option Description
--app-id <app-id> Program-ID (klient) för autentisering (standard: clientAppId från konfiguration)
-m, --manifest <manifest> Sökväg till ToolingManifest.json (standard: <deploymentProjectPath>/ToolingManifest.json)
--scopes <scopes> Specifika omfång som ska begäras (utrymmesavgränsade) (standard: Läs från ToolingManifest.json)
-o, --output <output> Utdataformat: table, jsoneller raw (standard: table)
--force-refresh Tvinga tokenuppdateringen att kringgå cacheminnet
--device-code Autentisera med enhetskodflödet istället för det interaktiva webbläsarflödet (Windows Account Manager (WAM)-mäklaren på Windows). Lär dig om autentisering av get-token enhetskod
--resource <resource> Resursnyckelord för att hämta token för: mcp (standard) eller powerplatform
--resource-id <resource-id> Anpassat resursprogram-ID (GUID) för resurser som inte omfattas av --resource nyckelord
-v, --verbose Visa detaljerade utdata inklusive fullständig token
-?, -h, --help Visa hjälp- och användningsinformation.

get-token resursalternativ

Använd alternativen --resource och --resource-id för att hämta token för olika Azure resurser:

  • --resource: Använd ett nyckelord för att välja en fördefinierad resurs:
    • mcp (standard): Agent 365-verktyg för MCP-servrar
    • powerplatform: Power Platform API
  • --resource-id: Ange ett anpassat resursprogram-ID (GUID) för resurser som inte omfattas av nyckelord

Important

Du kan inte använda --resource och --resource-id tillsammans. När du använder något av alternativen tar du med --scopes. Endast mcp-standardflödet stöder manifestbaserad omfångsmatchning.

get-token Autentisering av enhetskod

På Windows använder det standardiserade interaktiva webbläsarflödet Windows Account Manager (WAM)-mäklaren, som avvisar vissa Exchange-specifika Microsoft Graph-scopes (till exempel MailboxSettings.ReadWrite och ExchangeMessageTrace.Read.All).

Du behöver inte upptäcka detta själv. Om WAM avvisar de begärda scopes rapporterar CLI avvisningen och försöker automatiskt igen med enhetskodflödet, så kommandot lyckas fortfarande utan --device-code.

Eftersom WAM måste försöka och misslyckas innan CLI försöker om, är reservupplösningen långsammare och upplevelsen suboptimal. Klara när --device-code du vill välja det flödet direkt och undvika det misslyckade försöket:

  • Du kör där ingen interaktiv webbläsare kan öppnas, som en fjärrterminal eller SSH-session.
  • Du vet redan att du begär Exchange-scopes och vill hoppa över det misslyckade WAM-försöket och dess varning.
  • Du kör get-token upprepade gånger med samma scopes, till exempel över flera ritningar, där fördröjningen per körning blir hög.
$params = @{
  ResourceId = "00000003-0000-0000-c000-000000000000"
  Scopes     = "MailboxSettings.ReadWrite ExchangeMessageTrace.Read.All"
  DeviceCode = $true
}

a365 develop get-token @params

Kommandot visar en URL (https://microsoft.com/devicelogin) och en kod för att slutföra inloggningen i din webbläsare.

develop start-mock-tooling-server

Starta en modellverktygsserver för testning och utveckling.

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

Det här kommandot startar en modellverktygsserver för testning och utveckling. Genom att använda den här servern kan du simulera MCP-serverinteraktioner utan att kräva faktiska serverimplementeringar.

start-mock-tooling-server Alternativ

Använd de här alternativen för att anpassa kommandots start-mock-tooling-server beteende.

Option Description Default
-p, --port <port> Portnummer för den falska servern 5309
-v, --verbose Aktivera utförlig loggning false
-?, -h, --help Visa hjälp- och användningsinformation -
-bg Kör servern på en ny terminal -