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, godkänna, blockera, paketera och registrera MCP-servrar för användning i Dataverse-miljöer.

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

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
-c, --config <config> Konfigurationsfilsökväg (standard: a365.config.json)
--dry-run Visa vad som skulle göras utan att köra
-?, , -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
-c, --config <config> Konfigurationsfilsökväg (standard: a365.config.json)
--dry-run Visa vad som skulle göras utan att köra
-?, , -h--help Visa hjälp- och användningsinformation

develop-mcp approve

Godkänn en MCP-server.

a365 develop-mcp approve [options]

Det här kommandot godkänner en MCP-server för användning i miljön.

approve Alternativ

Option Description
-s, --server-name <server-name> MCP-servernamn att godkänna
-c, --config <config> Konfigurationsfilsökväg (standard: a365.config.json)
--dry-run Visa vad som skulle göras utan att köra
-?, , -h--help Visa hjälp- och användningsinformation

develop-mcp block

Blockera en MCP-server.

a365 develop-mcp block [options]

Använd det här kommandot för att blockera att en MCP-server används i din miljö.

block Alternativ

Option Description
-s, --server-name <server-name> MCP-servernamn som ska blockeras
-c, --config <config> Konfigurationsfilsökväg (standard: a365.config.json)
--dry-run Visa vad som skulle göras utan att köra
-?, , -h--help Visa hjälp- och användningsinformation

develop-mcp package-mcp-server

Generera MCP-serverpaket för sändning i Microsoft administrationscenter.

a365 develop-mcp package-mcp-server [options]

Använd det här kommandot för att skapa ett distributionspaket för en MCP-server som du kan skicka till Microsofts administrationscenter.

package-mcp-server Alternativ

Option Description
--server-name <server-name> MCP-servernamn (OBLIGATORISKT)
--developer-name <developer-name> Visningsnamn för utgivare eller utvecklare (OBLIGATORISKT)
--icon-url <icon-url> Offentlig URL till en PNG-ikon för MCP-servern (KRÄVS)
--output-path <output-path> Målkatalog för det genererade ZIP-paketet (KRÄVS)
--dry-run Visa vad som skulle göras utan att köra
-c, --config <config> Konfigurationsfilsökväg (standard: a365.config.json)
-?, , -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
--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