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
-c, --config <config> Sökväg till konfigurationsfilen. Default: a365.config.json
-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
-c, --config <config> Konfigurationsfilsökväg (standard: a365.config.json)
-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
-c, --config <config> Konfigurationsfilsökväg (standard: a365.config.json)
--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
--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.

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 -