Kommandoreferens för Agent 365 CLI develop-mcp

Hantera MCP-servrar i Dataverse-miljöer. Kommandot develop-mcp ger alternativ för att publicera, avpublicera och registrera MCP-servrar för användning i Dataverse-miljöer.

Note

, develop-mcp approvedevelop-mcp block, och develop-mcp package-mcp-server kommandona tas bort från Agent 365:s CLI. Hyresgästadministratörer utför nu servergodkännande och blockering i Microsoft admincenter — väntande förfrågningar granskas på sidan Requested Agents. CLI:n producerar inte längre MCP-serverpaket för inlämning till Admin Center; Administratörer ombord och hanterar servrar direkt i administrationscentret.

Minsta roll som krävs: Varierar beroende på underkommando

Syntax

a365 develop-mcp [command] [options]

Options

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

develop-mcp list-environments

Visa en lista över alla Dataverse-miljöer som är tillgängliga för MCP-serverhantering.

a365 develop-mcp list-environments [options]

Det här kommandot visar alla Dataverse-miljöer där du kan hantera MCP-servrar.

list-environments Alternativ

Option Description
--dry-run Visa vad som skulle göras utan att köra
-v, --verbose Aktivera utförlig loggning
-?, , -h--help Visa hjälp- och användningsinformation

develop-mcp list-servers

Lista MCP-servrar i en specifik Dataverse-miljö.

a365 develop-mcp list-servers [options]

Det här kommandot visar alla MCP-servrar som för närvarande distribueras i den angivna Dataverse-miljön.

list-servers Alternativ

Option Description
-e, --environment-id <environment-id> ID för Dataverse-miljö
--dry-run Visa vad som skulle göras utan att köra
-v, --verbose Aktivera utförlig loggning
-?, , -h--help Visa hjälp- och användningsinformation

develop-mcp publish

Publicera en MCP-server till en Dataverse-miljö.

a365 develop-mcp publish [options]

Använd det här kommandot för att publicera en MCP-server till den angivna Dataverse-miljön.

När du publicerar skapar CLI:n en <server-name>-PublicClients Microsoft Entra appregistrering i din tenant. Denna app har OAuth-behörigheter som klientvärdar (såsom Visual Studio Code och Microsoft 365 Copilot CLI) använder för att anropa den publicerade MCP-servern. Eftersom kommandot skapar en appregistrering måste kontot som kör CLI:n ha behörigheten Application.ReadWrite.All Microsoft Graph. Att köra publish utan den misslyckas.

Note

Tillhandahåll --publisher-name anpassade (användarskapade) MCP-servrar. Värdet skrivs till det publicerade paketets utvecklarmetadata och krävs för dessa servrar. Det ignoreras för förstapartsservrar som ägs av Microsoft (till exempel msdyn_DataverseMCPServer), som alltid publicerar som "Microsoft". När du utelämnar det uppmanar CLI interaktivt om det; pass --yes för att publicera utan prompts i CI eller skriptade sammanhang.

publish Alternativ

Option Description
-e, --environment-id <environment-id> ID för Dataverse-miljö
-s, --server-name <server-name> MCP-servernamn som ska publiceras
-a, --alias <alias> Alias för MCP-servern
-d, --display-name <display-name> Visningsnamn för MCP-servern
-p, --publisher-name <publisher-name> Publisher-namnet skrivet till det publicerade paketets metadata. Krävs för anpassade (användarskapade) MCP-servrar; ignorerades till förmån för förstapartsservrar ägda av Microsoft. Prompt interaktivt när den utelämnades.
-y, --yes Hoppa över det interaktiva "Fortsätt med publicering? (y/N)" confirmation. Använd i CI eller skriptade sammanhang.
--dry-run Visa vad som skulle göras utan att köra
-v, --verbose Aktivera utförlig loggning
-?, , -h--help Visa hjälp- och användningsinformation

develop-mcp unpublish

Avpublicera en MCP-server från en Dataverse-miljö.

a365 develop-mcp unpublish [options]

Använd det här kommandot för att ta bort en MCP-server från den angivna Dataverse-miljön.

unpublish Alternativ

Option Description
-e, --environment-id <environment-id> ID för Dataverse-miljö
-s, --server-name <server-name> MCP-servernamn för avpublicera
--dry-run Visa vad som skulle göras utan att köra
-?, , -h--help Visa hjälp- och användningsinformation

develop-mcp register-external-mcp-server

Registrera en extern MCP-server med Entra, extern OAuth, API-nyckel eller ingen autentisering.

a365 develop-mcp register-external-mcp-server [options]

Använd detta kommando för att registrera en externt hostad (tredjeparts) MCP-server hos din tenant. Kommandot skapar de Microsoft Entra-appregistreringar som plattformen behöver, anropar Agent 365-plattformen för att lägga till MCP-servern och konfigurerar omdirigerings-URI:er och API-behörigheter på de nya appregistreringarna.

Servernamnet måste börja med prefixet ext_ och vara högst 20 tecken långt, till exempel ext_MyServer. Verktygsnamn måste exakt matcha de namn som exponeras av den fjärrstyrda MCP-servern. Ommatchade namn gör att verktygsinkallelser misslyckas vid körning.

Du kan ange parametrar på tre sätt:

  • Skicka dem som kommandoradsalternativ.
  • Tillhandahåll en JSON-fil med --input-file. Kommandoradsalternativ åsidosätter värden från filen. Se register-external-mcp-server-sample.json i CLI-mallarna för filstrukturen.
  • Utelämna alla nödvändiga värden som ska promptas interaktivt.

När registreringen lyckas, be din tenant-administratör att godkänna den nya MCP-servern innan agenterna kan använda den. Om du registrerade dig med ExternalOAuth, lägg också till den visade omdirigerings-URI:n i din externa IDP-applikation.

Important

Om registreringen misslyckas efter att Microsoft Entra-appregistreringarna har skapats, rullas inte apparna automatiskt tillbaka. Ta bort dem manuellt i Azure-portalen innan du försöker igen.

register-external-mcp-server Alternativ

Vissa alternativ krävs endast för specifika autentiseringstyper, som beskrivs i beskrivningskolumnen.

Option Description
-s, --server-name <server-name> MCP-servernamn. Måste börja med ext_ och vara högst 20 tecken, till exempel ext_MyServer
-u, --server-url <server-url> Fjärr-MCP-server-URL. Måste vara en giltig HTTP- eller HTTPS-URL
-a, --auth-type <auth-type> Autentiseringstyp: EntraOAuth, ExternalOAuth, , APIKey, eller NoAuth
--publisher <publisher> Publisher-namn (används i paketmetadata)
--description <description> Serverbeskrivning (används i paketmetadata)
--tools <tools> Till exempel en komma-separerad lista över verktygsnamn som exponeras av denna server. tool1,tool2,tool3
-f, --input-file <input-file> Väg till en JSON-fil med registreringsparametrarna
--remote-scopes <remote-scopes> Scopes för den fjärrstyrda MCP-servern, till exempel api://{appId-guid}/{scopeName}. Används med EntraOAuth
-t, --tenant-id <tenant-id> Entra tenant ID för appregistreringen. Defaults till den nuvarande az login hyresgästen
--service-tree-id <service-tree-id> ServiceTree-ID för entra-appens registrering. Obligatoriskt i Microsoft företagshyresgäster
-l, --secret-lifetime-months <months> Livstid i månader (1-24) för genererade klienthemligheter i de skapade entra-apparna. Som standard är det 24 månader (2 år). Sätt ett värde som är lägre än appManagementPolicies taket i din hyresgäst om din hyresgästförsäkring kräver en kortare maxgräns
--idp-authorization-url <url> Extern OAuth-auktoriserings-URL. Krävs när --auth-type är ExternalOAuth
--idp-token-url <url> Extern OAuth-token-URL. Krävs när --auth-type är ExternalOAuth
--idp-scopes <scopes> Externa OAuth-scopes. Krävs när --auth-type är ExternalOAuth
--idp-client-id <client-id> Extern OAuth-klient-ID. Krävs när --auth-type är ExternalOAuth
--idp-client-secret <client-secret> Extern OAuth-klienthemlighet. Krävs när --auth-type är ExternalOAuth
--api-key-location <location> API-nyckelplats: Header eller Query. Krävs när --auth-type är APIKey
--api-key-name <name> API-nyckelparameter eller headernamn, till exempel X-API-Key eller token. Krävs när --auth-type är APIKey
--dry-run Visa vad som skulle göras utan att köra
-v, --verbose Aktivera utförlig loggning
-?, , -h--help Visa hjälp- och användningsinformation
  • Last updated on