Agent 365:n komentorivikäyttöliittymän develop-mcp komentoviittaus

HALLITSE MCP-palvelimia Dataverse-ympäristöissä. Komento develop-mcp tarjoaa vaihtoehdot julkaista, poistaa julkaisu, rekisteröidä ja myöntää agenttioikeudet MCP-palvelimille Dataverse-ympäristöissä.

Note

Käskyt develop-mcp approve, develop-mcp block, ja develop-mcp package-mcp-server poistetaan Agent 365 CLI:stä. Vuokralaisten ylläpitäjät suorittavat nyt palvelimen hyväksynnän ja eston Microsoft hallintakeskuksessa — odottavat pyynnöt tarkistetaan Requested Agents -sivulla. Komentokeskus ei enää tuota MCP-palvelinpaketteja Admin Centerin lähettämiseen; Ylläpitäjät ottavat käyttöön ja hallinnoivat palvelimia suoraan hallintokeskuksessa.

Vaadittu vähimmäisrooli: Vaihtelee alivaliokunnan mukaan

Syntax

a365 develop-mcp [command] [options]

Asetukset

Option	Description
-v, --verbose	Yksityiskohtaisen kirjaamisen käyttöönotto
-?, -h, --help	Näytä ohjeet ja käyttöohjeet

develop-mcp evaluate

Arvioi MCP-palvelintasi tieteellisten parhaiden käytäntöjen perusteella arvioidaksesi tuotantovalmiutta. Tämä työkalu tuottaa kattavan arviointiraportin, jossa on pisteytyksiä, selityksiä ja toimenpiteitä. Komento tunnistaa MCP-palvelimen käyttämät työkalut, suorittaa joukon deterministisiä ja tekoälyn pisteyttämiä semanttisia tarkistuksia niiden skeemoja vastaan ja tuottaa HTML-raportin, joka arvioi skeeman laatua ja listaa priorisoidut toimintokohteet parannuksiin.

a365 develop-mcp evaluate --server-url <server-url> [--auth-token <auth-token>] [options]

evaluate asetukset

Option	Description
-u, --server-url <server-url>	Required. MCP-palvelimen suoratoistettavan HTTP-päätepisteen URL (yleensä päättyy )./mcp
--auth-token <auth-token>	Optional. Tarvitaan vain, kun MCP-palvelin tarvitsee todennuksen. Kantajatunnus palvelimelle. Suosi ympäristömuuttujaa A365_MCP_AUTH_TOKEN ; komentorivin kautta välitetty token näkyy prosessilistauksissa ja shell-historiassa.
-o, --output-dir <output-dir>	Hakemisto tarkistuslistalle ja raporttitiedostoille. Oletuksena nykyinen hakemisto (.).
--eval-engine <eval-engine>	Mikä paikallinen koodausagentti pisteytää semanttiset tarkistukset: auto (oletus; kokeile GitHub Copilot, sitten Claude Code), github-copilot, claude-code tai none (ohita tekoälypisteytys ja odota ennalta pisteytetty tarkistuslista).
-v, --verbose	Ota yksityiskohtainen kirjaaminen käyttöön.
-?, -h, --help	Näytä ohjeet ja käyttötiedot.

evaluate Esimerkkejä

Arvioi paikallinen palvelin automaattisella moduulin valinnalla:

a365 develop-mcp evaluate --server-url "http://localhost:5000/mcp"

Arvioi todennettu palvelin siten, että tunnus toimitetaan ympäristömuuttujan kautta ja artefaktit kirjoitetaan alikansioon:

$env:A365_MCP_AUTH_TOKEN = "<bearer-token>"
a365 develop-mcp evaluate --server-url "https://my-mcp-server.contoso.com/mcp" --output-dir "./eval"

Luo pelkkä tarkistusluettelo ja pisteytä se sitten oman LLM:si avulla:

a365 develop-mcp evaluate --server-url "https://my-mcp-server.contoso.com/mcp" --eval-engine none

Pakota tietty pisteytysmoduuli:

a365 develop-mcp evaluate --server-url "http://localhost:5000/mcp" --eval-engine claude-code

Opi arvioimaan MCP-palvelimia

evaluate ympäristömuuttujat

Käytä seuraavia ympäristömuuttujia autentikoinnin mahdollistamiseen ja halutessa ohjata, mitä mallia kukin paikallinen pisteytysmoottori käyttää.

Environment variable	Purpose
A365_MCP_AUTH_TOKEN	MCP-palvelimen kantaja-token, jota käytetään, kun --auth-token sitä ei siirretä. Parempi kuin lipu, koska se pitää tokenin poissa prosessilistauksista ja shell-historiasta.
A365_EVAL_COPILOT_MODEL	Ohita GitHub Copilot -malli. Vaatii tarkan mallin ID:n, esimerkiksi claude-haiku-4.5.
A365_EVAL_CLAUDE_MODEL	Ohita Claude-koodin malli. Hyväksyy mallin aliaksen (esimerkiksi haiku) tai täyden mallitunnuksen.

develop-mcp grant-agents-access

Myönnä BYO-tuo oma (BYO) MCP-palvelimelle lupa agenttia identiteettejä, joilta puuttuu se.

a365 develop-mcp grant-agents-access --mcp-server-name <NAME> --agent-blueprint-id <GUID> [options]

Vähimmäisvaaditut käyttöoikeudet: Global Administrator (tai jokin muu rooli, jolla on oikeus luoda koko vuokralaisen OAuth2-käyttöoikeuksia)

Käytä tätä komentoa löytääksesi ja korjataksesi agentin identiteettejä, jotka eivät voi kutsua omaa MCP-palvelinta (BYO), koska niiltä puuttuu Tools.ListInvoke.All siihen oikeus. Komento listaa ne agentti-instanssit, joilta puuttuu käyttöoikeus, ja antaa sinun valita, kenelle se myönnetään.

MCP-palvelimen nimi ratkeaa Microsoft Entra -sovellukseksi, johon - BYO nimeen liitetään. Esimerkiksi ratkeaa ext_Learn1 .ext_Learn1 - BYO Avustus itsessään on koko vuokralaisen (AllPrincipals) delegoitu OAuth2-käyttöoikeus kyseisen sovelluksen palvelupäähenkilölle, joten se koskee kaikkia nykyisiä ja tulevia agentti-instansseja blueprintista, ei vain niitä, jotka on lueteltu ajonaikana.

Yleensä et tiedä blueprint GUID:tä etukäteen. Ilman arvoa, tai virheellistä arvoa--agent-blueprint-id, tulostetaan Microsoft:n ensimmäisen osapuolen blueprint-nimet ja ID:t, jotta voit löytää sen. Ohittaessa --help se tulostaa saman listan.

Kun komento raportoi agentin instanssista, joilta puuttuu käyttöoikeus, valitse enter all myöntääksesi sen jokaiselle näytetylle instanssille, pilkulla erotettu lista näytetyistä numeroista (esim. 1,3) myöntääksesi sen tietyille instansseille tai paina Enteriä ohittaaksesi myöntämisen. Läpäise --yes myöntämään jokaiselle listatulle instanssille ilman kehotusta, esimerkiksi skriptissä.

Jos useampi Entra-sovellus jakaa saman <name> - BYO näyttönimen, komento listaa kaikki osumat ja kysyy, kumpaa käyttää arvaamisen sijaan.

grant-agents-access asetukset

Option	Description
--agent-blueprint-id <agent-blueprint-id>	Agentin blueprint ID (GUID) agenttiinstansseille. Jos jätät tämän vaihtoehdon pois tai annat virheellisen arvon, komento tulostaa ensimmäisen osapuolen blueprint-nimet ja ID:t.
-s, --mcp-server-name <mcp-server-name>	Required. MCP-palvelimen nimi. Entra-sovellus ratkeaa seuraavasti <name> - BYO.
--tenant-id <tenant-id>	Azure AD-vuokraajan tunnus. Oletuksena nykyinen Azure CLI -konteksti.
-y, --yes	Myönnä puuttuva lupa kaikille listattu agentti-instanssille ilman kehotusta.
--device-code	Käytä laitekoodin tunnistautumista interaktiivisen selainprosessin sijaan (WAM-välittäjä Windows:ssa). Käytä silloin, kun WAM ei pysty näyttämään kirjautumisdialogia, kuten sulautettua tai etäpäätettä. Avautuu https://microsoft.com/devicelogin selaimessasi.
--dry-run	Ilmoita, mitkä agentti-instanssit puuttuvat luvan ilman myöntämistä.
-v, --verbose	Yksityiskohtaisen kirjaamisen käyttöönotto
-?, -h, --help	Näytä ohjeet ja käyttöohjeet

develop-mcp list-environments

Luettele kaikki MCP-palvelimen hallintaan käytettävissä olevat Dataverse-ympäristöt.

a365 develop-mcp list-environments [options]

Tämä komento näyttää kaikki Dataverse-ympäristöt, joissa voit hallita MCP-palvelimia.

list-environments asetukset

Option	Description
--dry-run	Näytä, mitä tehdään ilman suorittamista
-v, --verbose	Yksityiskohtaisen kirjaamisen käyttöönotto
-?, -h, --help	Näytä ohjeet ja käyttöohjeet

develop-mcp list-servers

Luetteloi MCP-palvelimet tietyssä Dataverse-ympäristössä.

a365 develop-mcp list-servers [options]

Tämä komento listaa kaikki MCP-palvelimet, jotka ovat tällä hetkellä käytössä määritellyssä Dataverse-ympäristössä.

list-servers asetukset

Option	Description
-e, --environment-id <environment-id>	Dataverse-ympäristön tunnus
--dry-run	Näytä, mitä tehdään ilman suorittamista
-v, --verbose	Yksityiskohtaisen kirjaamisen käyttöönotto
-?, -h, --help	Näytä ohjeet ja käyttöohjeet

develop-mcp publish

Julkaise MCP-palvelin Dataverse-ympäristöön.

a365 develop-mcp publish [options]

Tämän komennon avulla voit julkaista MCP-palvelimen määritettyyn Dataverse-ympäristöön.

Important

MCP-palvelimen julkaiseminen ei hyväksy sitä. Julkaiseminen vain lähettää palvelimen vuokralaisellesi ja luo odottavan hyväksyntäpyynnön. Ennen kuin mikään agentti voi käyttää palvelinta, vuokralaisylläpitäjän on hyväksyttävä se Requested Tools -sivulla Microsoft 365 -hallintakeskus:ssä. Kunnes ylläpitäjä hyväksyy pyynnön, palvelin pysyy agenttien käytettävissä ollessaan. Kun komento onnistuu, komentokeskus tulostaa muistutuksen pyytää vuokralaisylläpitäjää hyväksymään palvelin.

Kun julkaiset sovelluksen, CLI luo <server-name>-PublicClients Microsoft Entra -sovelluksen rekisteröinnin vuokralasellesi. Tämä sovellus sisältää OAuth-oikeudet, joita asiakaspalvelimet (kuten Visual Studio Code ja Microsoft Copilot CLI) käyttävät kutsuakseen julkaistua MCP-palvelinta. Koska komento luo sovelluksen rekisteröinnin, CLI:tä ajavalla tilillä täytyy olla Application.ReadWrite.All Microsoft Graph -oikeus. Juokseminen publish ilman sitä epäonnistuu.

Note

Tarjoa --publisher-name räätälöityjä (käyttäjän luomia) MCP-palvelimia. Arvo kirjoitetaan julkaistun paketin kehittäjämetatietoihin ja se on välttämätön näille palvelimille. Se jätetään huomiotta ensimmäisen osapuolen Microsoft omistamilla palvelimilla (esimerkiksi msdyn_DataverseMCPServer), jotka aina julkaisevat "Microsoft". Kun jätät sen pois, komentorivi pyytää sitä interaktiivisesti; Voi julkaista --yes ilman kehotuksia CI- tai skriptatuissa konteksteissa.

publish asetukset

Option	Description
-e, --environment-id <environment-id>	Dataverse-ympäristön tunnus
-s, --server-name <server-name>	Julkaistava MCP-palvelimen nimi
-a, --alias <alias>	Alias MCP-palvelimelle
-d, --display-name <display-name>	MCP-palvelimen näyttönimi
-p, --publisher-name <publisher-name>	Publisher-nimi kirjoitettuna julkaistun paketin metatietoihin. Vaaditaan räätälöidyille (käyttäjän luomille) MCP-palvelimille; jätetty huomiotta ensimmäisen osapuolen Microsoft-omisteisilla palvelimilla. Pyydetään interaktiivisesti, kun se jätettiin pois.
-y, --yes	Ohittakaa interaktiivinen "Jatkatko julkaisemista?" (y/N)" confirmation. Käyttö CI- tai skriptatuissa konteksteissa.
--dry-run	Näytä, mitä tehdään ilman suorittamista
-v, --verbose	Yksityiskohtaisen kirjaamisen käyttöönotto
-?, -h, --help	Näytä ohjeet ja käyttöohjeet

Opi, miten vuokralaishallinnoijat hyväksyvät MCP-palvelimet

develop-mcp unpublish

Peruuta MCP-palvelimen julkaisu Dataverse-ympäristöstä.

a365 develop-mcp unpublish [options]

Tämän komennon avulla voit poistaa MCP-palvelimen määritetystä Dataverse-ympäristöstä.

unpublish asetukset

Option	Description
-e, --environment-id <environment-id>	Dataverse-ympäristön tunnus
-s, --server-name <server-name>	MCP-palvelimen nimi peruuta julkaisu
--dry-run	Näytä, mitä tehdään ilman suorittamista
-?, -h, --help	Näytä ohjeet ja käyttöohjeet

develop-mcp register-external-mcp-server

Rekisteröi ulkoinen MCP-palvelin Entralla, ulkoisella OAuthilla, API-avaimella tai ilman tunnistautumista.

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

Käytä tätä komentoa rekisteröidäksesi ulkoisesti isännöidyn (kolmannen osapuolen) MCP-palvelimen vuokralaisellasi. Komento luo alustan tarvitsemat Microsoft Entra -sovellusrekisteröinnit, kutsuu Agent 365 -alustaa lisätäkseen MCP-palvelimen ja konfiguroi uudelleenohjaus-URI:t ja API-oikeudet uusiin sovellusrekisteröinteihin.

Palvelimen nimen tulee alkaa ext_ etuliitteellä ja olla enintään 20 merkkiä pitkä, esimerkiksi ext_MyServer. Työkalujen nimien on täsmälleen vastattava etä-MCP-palvelimen paljastamia nimiä. Epäsopivat nimet aiheuttavat työkalukutsujen epäonnistumisen ajonaikana.

Voit antaa parametreja kolmella tavalla:

• Välitä ne komentorivivaihtoehtoina.
• Toimita JSON-tiedosto, jossa --input-fileon . Komentorivivaihtoehdot ohittavat tiedoston arvot. Katso register-external-mcp-server-sample.json CLI-malleista tiedostorakenne.
• Jätä pois kaikki interaktiivisesti pyydettävät arvot.

Kun rekisteröinti on onnistunut, pyydä vuokralaisen ylläpitäjää hyväksymään uusi MCP-palvelin ennen kuin agentit voivat käyttää sitä. Jos olet rekisteröitynyt , ExternalOAuthlisää myös näkyvä uudelleenohjaus-URI ulkoiseen IDP-sovellukseesi.

Important

Jos rekisteröinti epäonnistuu Microsoft Entra -sovellusrekisteröintien luomisen jälkeen, sovelluksia ei automaattisesti peruta. Poista ne manuaalisesti Azure-portaalista ennen uudelleenyrittämistä.

register-external-mcp-server asetukset

Jotkin vaihtoehdot vaaditaan vain tietyille todennustyypeille, kuten kuvaussarakkeessa kuvataan.

Option	Description
-s, --server-name <server-name>	MCP-palvelimen nimi. Aloitettava ja ext_ enintään 20 merkillä, esimerkiksi. ext_MyServer
-u, --server-url <server-url>	Etä-MCP-palvelimen URL. On oltava kelvollinen HTTP- tai HTTPS-URL
-a, --auth-type <auth-type>	Todennustyyppi: EntraOAuth, ExternalOAuth, APIKey, tai NoAuth
--publisher <publisher>	Publisher-nimi (käytetty paketin metatiedoissa)
--description <description>	Palvelimen kuvaus (käytetty pakettien metatiedoissa)
--tools <tools>	Pilkulla eroteltu lista työkalujen nimistä, jotka tämä palvelin paljastaa, esimerkiksi tool1,tool2,tool3
-f, --input-file <input-file>	Polku JSON-tiedostoon rekisteröintiparametreilla
--remote-scopes <remote-scopes>	Esimerkiksi etä-MCP-palvelimen skokoopit, api://{appId-guid}/{scopeName}. Käytetty yhdessä EntraOAuth
-t, --tenant-id <tenant-id>	Entra-vuokralaisen tunnus sovelluksen rekisteröintiä varten. Oletusarvot nykyiselle az login vuokralaiselle
--service-tree-id <service-tree-id>	ServiceTree ID Entra-sovelluksen rekisteröintiä varten. Vaadittu Microsoft-yritysvuokralaisissa
-l, --secret-lifetime-months <months>	Elinikä kuukausina (1–24) luoduille asiakassalaisuuksille luoduissa Entra-sovelluksissa. Oletuksena on 24 kuukautta (2 vuotta). Aseta arvo, joka on pienempi kuin appManagementPolicies vuokralaisen katto, jos vuokralaisvakuutuksesi asettaa lyhyemmän maksimimäärän
--idp-authorization-url <url>	Ulkoinen OAuth-valtuutusosoite. Vaaditaan, kun --auth-type on ExternalOAuth
--idp-token-url <url>	Ulkoinen OAuth-token-osoite. Vaaditaan, kun --auth-type on ExternalOAuth
--idp-scopes <scopes>	Ulkoiset OAuth-tähtäimet. Vaaditaan, kun --auth-type on ExternalOAuth
--idp-client-id <client-id>	Ulkoinen OAuth-asiakastunniste. Vaaditaan, kun --auth-type on ExternalOAuth
--idp-client-secret <client-secret>	Ulkoinen OAuth-asiakassalaisuus. Vaaditaan, kun --auth-type on ExternalOAuth
--api-key-location <location>	API-avaimen sijainti: Header tai Query. Vaaditaan, kun --auth-type on APIKey
--api-key-name <name>	API-avainparametri tai otsikonnimi, esimerkiksi X-API-Key tai token. Vaaditaan, kun --auth-type on APIKey
--dry-run	Näytä, mitä tehdään ilman suorittamista
-v, --verbose	Yksityiskohtaisen kirjaamisen käyttöönotto
-?, -h, --help	Näytä ohjeet ja käyttöohjeet