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

HALLITSE MCP-palvelimia Dataverse-ympäristöissä. Komento develop-mcp tarjoaa vaihtoehdot julkaista, poistaa ja rekisteröidä MCP-palvelimia käytettäväksi 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ötiedot

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, joka sisältää ympäristömuuttujan antaman tunnuksen ja alikansioon kirjoitetut artefaktit:

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

Luo vain tarkistusluettelo ja pisteytä se omalla LLM:lläsi:

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 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ötiedot

develop-mcp list-servers

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

a365 develop-mcp list-servers [options]

Tämä komento näyttää kaikki MCP-palvelimet, jotka on tällä hetkellä otettu käyttöön määritetyssä 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ötiedot

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.

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 365 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ötiedot

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ötiedot

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ötiedot
  • Last updated on