एजेंट 365 सीएलआई develop-mcp कमांड संदर्भ

Dataverse वातावरण में MCP सर्वर प्रबंधित करें. develop-mcp कमांड Dataverse वातावरण में उपयोग के लिए MCP सर्वर के लिए एजेंट अनुमतियाँ प्रकाशित करने, अप्रकाशित करने, पंजीकृत करने और अनुदान देने के विकल्प प्रदान करता है।

Note

, develop-mcp approveऔर develop-mcp blockdevelop-mcp package-mcp-server आदेश एजेंट 365 CLI से निकाल दिए जाते हैं। टैनेंट व्यवस्थापक अब सर्वर अनुमोदन और Microsoft व्यवस्थापन केंद्र — लंबित अनुरोधों की समीक्षा अनुरोधित एजेंट पृष्ठ पर की जाती है. CLI अब व्यवस्थापन केंद्र सबमिशन के लिए MCP सर्वर पैकेज का उत्पादन नहीं करता है; व्यवस्थापक सीधे व्यवस्थापक केंद्र में सर्वर को ऑनबोर्ड और प्रबंधित करते हैं।

न्यूनतम भूमिका की आवश्यकता: उप-आदेश के अनुसार भिन्न होता है

Syntax

a365 develop-mcp [command] [options]

विकल्प

Option	Description
-v, --verbose	वर्बोज़ लॉगिंग सक्षम करें
-?, , -h--help	मदद और उपयोग की जानकारी दिखाएं

develop-mcp evaluate

उत्पादन तत्परता का आकलन करने के लिए वैज्ञानिक सर्वोत्तम प्रथाओं के विरुद्ध अपने MCP सर्वर का मूल्यांकन करें। यह उपकरण स्कोर, स्पष्टीकरण और कार्रवाई आइटम के साथ एक व्यापक मूल्यांकन रिपोर्ट आउटपुट करता है। कमांड उन उपकरणों की खोज करता है जो एक MCP सर्वर उजागर करता है, उनके स्कीमा के खिलाफ नियतात्मक और AI-स्कोर किए गए सिमेंटिक चेक का एक सेट चलाता है, और एक HTML रिपोर्ट तैयार करता है जो स्कीमा गुणवत्ता को स्कोर करता है और सुधार के लिए प्राथमिकता वाले एक्शन आइटम को सूचीबद्ध करता है।

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

evaluate विकल्प

Option	Description
-u, --server-url <server-url>	Required. MCP सर्वर का स्ट्रीम करने योग्य HTTP एंडपॉइंट URL (आमतौर पर समाप्त होता है /mcp)।
--auth-token <auth-token>	Optional. केवल तभी आवश्यक है जब MCP सर्वर को प्रमाणीकरण की आवश्यकता हो। सर्वर के लिए वाहक टोकन। पर्यावरण चर को A365_MCP_AUTH_TOKEN प्राथमिकता दें; कमांड लाइन पर पारित एक टोकन लिस्टिंग और शेल इतिहास को संसाधित करने के लिए दिखाई देता है।
-o, --output-dir <output-dir>	चेकलिस्ट और रिपोर्ट फ़ाइलों के लिए निर्देशिका। वर्तमान निर्देशिका (). के लिए डिफ़ॉल्ट।
--eval-engine <eval-engine>	कौन सा स्थानीय कोडिंग एजेंट सिमेंटिक चेक स्कोर करता है: auto (डिफ़ॉल्ट; GitHub Copilot का प्रयास करें, फिर क्लाउड कोड), github-copilot, claude-code, या none (AI स्कोरिंग छोड़ें और पूर्व-स्कोर चेकलिस्ट की अपेक्षा करें)।
-v, --verbose	वर्बोज़ लॉगिंग सक्षम करें।
-?, , -h--help	मदद और उपयोग की जानकारी दिखाएं.

evaluate उदाहरण

स्वचालित इंजन चयन के साथ एक स्थानीय सर्वर का मूल्यांकन करें:

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

एक प्रमाणित सर्वर का मूल्यांकन करें, जिसमें एक पर्यावरण चर और सबफ़ोल्डर में लिखी गई कलाकृतियों के माध्यम से आपूर्ति की गई टोकन हो:

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

केवल चेकलिस्ट उत्पन्न करें, फिर इसे अपने स्वयं के एलएलएम के साथ स्कोर करें:

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

एक विशिष्ट स्कोरिंग इंजन को बाध्य करें:

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

MCP सर्वर का मूल्यांकन करने का तरीका जानें

evaluate परिवेश चर

प्रमाणीकरण प्रदान करने के लिए निम्नलिखित पर्यावरण चर का उपयोग करें और वैकल्पिक रूप से नियंत्रित करें कि प्रत्येक स्थानीय स्कोरिंग इंजन किस मॉडल का उपयोग करता है।

Environment variable	Purpose
A365_MCP_AUTH_TOKEN	MCP सर्वर के लिए Bearer टोकन, जब पास नहीं होता है तो --auth-token उपयोग किया जाता है। ध्वज पर प्राथमिकता दी जाती है क्योंकि यह टोकन को प्रक्रिया लिस्टिंग और शेल इतिहास से बाहर रखता है।
A365_EVAL_COPILOT_MODEL	GitHub Copilot मॉडल को ओवरराइड करें। एक सटीक मॉडल आईडी की आवश्यकता है, उदाहरण claude-haiku-4.5के लिए।
A365_EVAL_CLAUDE_MODEL	Claude Code मॉडल को ओवरराइड करें। एक मॉडल उपनाम (उदाहरण haikuके लिए) या एक पूर्ण मॉडल आईडी स्वीकार करता है।

develop-mcp grant-agents-access

अपने स्वयं के (BYO) MCP सर्वर को उन एजेंट पहचानों को अनुमति दें जो इसे याद कर रहे हैं।

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

न्यूनतम आवश्यक अनुमतियाँ: वैश्विक व्यवस्थापक (या टैनेंट-व्यापी OAuth2 अनुमति अनुदान बनाने के अधिकारों के साथ कोई अन्य भूमिका)

इस आदेश का उपयोग उन एजेंट पहचानों को ढूँढने और ठीक करने के लिए करें जो आपके स्वयं के (BYO) MCP सर्वर को कॉल नहीं कर सकते क्योंकि वे इसके लिए अनुमति खो Tools.ListInvoke.All रहे हैं. कमांड निर्दिष्ट ब्लूप्रिंट के एजेंट इंस्टेंस को सूचीबद्ध करता है जो अनुमति से चूक गए हैं, फिर आपको यह चुनने देता है कि इसे किसे देना है।

MCP सर्वर नाम एक Microsoft Entra अनुप्रयोग के लिए हल हो जाता है जहाँ - BYO नाम के लिए जोड़ा गया है। उदाहरण के लिए, ext_Learn1 करने के लिए संकल्प ext_Learn1 - BYO। अनुदान स्वयं उस एप्लिकेशन के सेवा प्रिंसिपल पर एक किरायेदार-व्यापी ()AllPrincipals प्रत्यायोजित OAuth2 अनुमति अनुदान है, इसलिए यह ब्लूप्रिंट के प्रत्येक वर्तमान और भविष्य के एजेंट उदाहरण पर लागू होता है, न कि केवल रन टाइम पर सूचीबद्ध लोगों पर।

आप आम तौर पर समय से पहले ब्लूप्रिंट GUID नहीं जानते हैं। किसी मान या अमान्य मान के बिना गुजरना--agent-blueprint-id, Microsoft प्रथम-पक्ष ब्लूप्रिंट नाम और IDs मुद्रित करता है ताकि आप इसे ढूँढ सकें. पासिंग एक --help ही सूची प्रिंट करता है।

कमांड द्वारा एजेंट इंस्टेंस को अनुमति गुम करने की रिपोर्ट करने के बाद, दिखाए गए प्रत्येक इंस्टेंस को इसे देने के लिए दर्ज करें all , दिखाए गए नंबरों की एक अल्पविराम-अलग सूची (उदाहरण के लिए) 1,3इसे विशिष्ट इंस्टेंस को देने के लिए, या अनुदान देने से बचने के लिए Enter दबाएं। संकेत के बिना प्रत्येक सूचीबद्ध उदाहरण को अनुदान देने के लिए पास --yes करें, उदाहरण के लिए एक स्क्रिप्ट में।

यदि एक से अधिक Entra एप्लिकेशन एक ही <name> - BYO प्रदर्शन नाम साझा करते हैं, तो कमांड सभी मैचों को सूचीबद्ध करता है और पूछता है कि अनुमान लगाने के बजाय किसका उपयोग करना है।

grant-agents-access विकल्प

Option	Description
--agent-blueprint-id <agent-blueprint-id>	एजेंट ब्लूप्रिंट आईडी (GUID) एजेंट आवृत्तियों की जाँच करने के लिए। यदि आप इस विकल्प को छोड़ देते हैं या कोई अमान्य मान प्रदान करते हैं, तो आदेश प्रथम-पक्ष ब्लूप्रिंट नाम और IDs मुद्रित करता है।
-s, --mcp-server-name <mcp-server-name>	Required. MCP सर्वर का नाम। Entra एप्लिकेशन के रूप में हल होता है <name> - BYO।
--tenant-id <tenant-id>	Azure AD टेनेंट ID. वर्तमान Azure CLI संदर्भ के लिए डिफ़ॉल्ट।
-y, --yes	बिना संकेत दिए प्रत्येक सूचीबद्ध एजेंट इंस्टेंस को गुम अनुमति प्रदान करें।
--device-code	इंटरैक्टिव ब्राउज़र प्रवाह (Windows पर WAM ब्रोकर) के बजाय डिवाइस कोड प्रमाणीकरण का उपयोग करें। तब उपयोग करें जब WAM साइन-इन संवाद नहीं दिखा सकता है, जैसे कि एम्बेडेड या दूरस्थ टर्मिनल। आपके ब्राउज़र में खुलता है https://microsoft.com/devicelogin ।
--dry-run	रिपोर्ट करें कि कौन से एजेंट की आवृत्तियाँ अनुमति दिए बिना उसे प्राप्त नहीं कर रही हैं.
-v, --verbose	वर्बोज़ लॉगिंग सक्षम करें
-?, , -h--help	मदद और उपयोग की जानकारी दिखाएं

develop-mcp list-environments

MCP सर्वर प्रबंधन के लिए उपलब्ध सभी Dataverse परिवेशों की सूची बनाएं।

a365 develop-mcp list-environments [options]

यह कमांड सभी Dataverse वातावरण प्रदर्शित करता है जहां आप MCP सर्वर प्रबंधित कर सकते हैं।

list-environments विकल्प

Option	Description
--dry-run	दिखाएँ कि निष्पादित किए बिना क्या किया जाएगा
-v, --verbose	वर्बोज़ लॉगिंग सक्षम करें
-?, , -h--help	मदद और उपयोग की जानकारी दिखाएं

develop-mcp list-servers

MCP सर्वरों को एक विशिष्ट Dataverse वातावरण में सूचीबद्ध करें.

a365 develop-mcp list-servers [options]

यह आदेश उन सभी MCP सर्वरों को सूचीबद्ध करता है जो वर्तमान में निर्दिष्ट Dataverse वातावरण में तैनात हैं।

list-servers विकल्प

Option	Description
-e, --environment-id <environment-id>	Dataverse परिवेश ID
--dry-run	दिखाएँ कि निष्पादित किए बिना क्या किया जाएगा
-v, --verbose	वर्बोज़ लॉगिंग सक्षम करें
-?, , -h--help	मदद और उपयोग की जानकारी दिखाएं

develop-mcp publish

एक MCP सर्वर को Dataverse परिवेश में प्रकाशित करें।

a365 develop-mcp publish [options]

निर्दिष्ट Dataverse परिवेश में MCP सर्वर प्रकाशित करने के लिए इस कमांड का उपयोग करें.

Important

किसी MCP सर्वर को प्रकाशित करना इसे अनुमोदित नहीं करता है। प्रकाशन केवल सर्वर को आपके टैनेंट को सबमिट करता है और एक लंबित अनुमोदन अनुरोध बनाता है। इससे पहले कि कोई भी एजेंट सर्वर का उपयोग कर सके, एक टैनेंट व्यवस्थापक को Microsoft 365 व्यवस्थापन केंद्र में अनुरोधित उपकरण पृष्ठ पर इसे अनुमोदित करना होगा। जब तक व्यवस्थापक अनुरोध को मंजूरी नहीं देता, तब तक सर्वर एजेंटों के लिए अनुपलब्ध रहता है। जब आदेश सफल होता है, तो CLI सर्वर को अनुमोदित करने के लिए आपके टैनेंट व्यवस्थापक से पूछने के लिए एक अनुस्मारक मुद्रित करता है।

जब आप प्रकाशित करते हैं, तो CLI आपके टैनेंट में एक <server-name>-PublicClients Microsoft Entra ऐप पंजीकरण बनाता है। यह ऐप OAuth अनुमतियाँ रखता है जो क्लाइंट होस्ट करता है (जैसे Visual Studio Code और Microsoft Copilot CLI) प्रकाशित MCP सर्वर को कॉल करने के लिए उपयोग करता है। आदेश एक अनुप्रयोग पंजीकरण बनाता है, क्योंकि CLI चला रहे खाते में Application.ReadWrite.All Microsoft Graph अनुमति होनी चाहिए। इसके बिना चलना publish विफल हो जाता है।

Note

कस्टम (उपयोगकर्ता द्वारा निर्मित) MCP सर्वर के लिए प्रदान करें --publisher-name । मान प्रकाशित पैकेज के डेवलपर मेटाडेटा के लिए लिखा गया है और इन सर्वरों के लिए आवश्यक है। इसे प्रथम-पक्ष Microsoft-स्वामित्व वाले सर्वर (उदाहरण के लिए, msdyn_DataverseMCPServer) के लिए अनदेखा किया जाता है, जो हमेशा "Microsoft" के रूप में प्रकाशित होते हैं। जब आप इसे छोड़ देते हैं, तो सीएलआई इसके लिए इंटरैक्टिव रूप से संकेत देता है; CI या स्क्रिप्टेड संदर्भों में संकेतों के बिना प्रकाशित करने के लिए पास --yes ।

publish विकल्प

Option	Description
-e, --environment-id <environment-id>	Dataverse परिवेश ID
-s, --server-name <server-name>	प्रकाशित करने के लिए MCP सर्वर का नाम
-a, --alias <alias>	MCP सर्वर के लिए उपनाम
-d, --display-name <display-name>	MCP सर्वर के लिए प्रदर्शन नाम
-p, --publisher-name <publisher-name>	प्रकाशित पैकेज मेटाडेटा के लिए लिखा गया Publisher नाम. कस्टम (उपयोगकर्ता द्वारा निर्मित) एमसीपी सर्वर के लिए आवश्यक; प्रथम-पक्ष Microsoft-स्वामित्व वाले सर्वरों के लिए अनदेखा किया गया. छोड़े जाने पर अंतःक्रियात्मक रूप से संकेत दिया गया।
-y, --yes	इंटरैक्टिव को छोड़ें "प्रकाशित के साथ आगे बढ़ें? (y/N)" confirmation. सीआई या स्क्रिप्टेड संदर्भों में उपयोग करें।
--dry-run	दिखाएँ कि निष्पादित किए बिना क्या किया जाएगा
-v, --verbose	वर्बोज़ लॉगिंग सक्षम करें
-?, , -h--help	मदद और उपयोग की जानकारी दिखाएं

MCP अनुरोधों की समीक्षा करें और उन्हें स्वीकार करें

develop-mcp unpublish

Dataverse परिवेश से MCP सर्वर को अप्रकाशित करें.

a365 develop-mcp unpublish [options]

निर्दिष्ट Dataverse वातावरण से MCP सर्वर को हटाने के लिए इस कमांड का उपयोग करें।

unpublish विकल्प

Option	Description
-e, --environment-id <environment-id>	Dataverse परिवेश ID
-s, --server-name <server-name>	अप्रकाशित करने के लिए MCP सर्वर का नाम
--dry-run	दिखाएँ कि निष्पादित किए बिना क्या किया जाएगा
-?, , -h--help	मदद और उपयोग की जानकारी दिखाएं

develop-mcp register-external-mcp-server

Entra, बाहरी OAuth, API कुंजी या कोई प्रमाणीकरण के साथ एक बाहरी MCP सर्वर पंजीकृत करें।

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

अपने टैनेंट के साथ बाहरी रूप से होस्ट किए गए (तृतीय-पक्ष) MCP सर्वर को पंजीकृत करने के लिए इस आदेश का उपयोग करें। कमांड प्लेटफ़ॉर्म के लिए आवश्यक Microsoft Entra ऐप पंजीकरण बनाता है, MCP सर्वर जोड़ने के लिए Agent 365 प्लेटफ़ॉर्म को कॉल करता है, और नए ऐप पंजीकरण पर URIs और API अनुमतियों को पुनर्निर्देशित करता है।

सर्वर का नाम उपसर्ग से ext_ शुरू होना चाहिए और अधिकतम 20 वर्ण लंबा होना चाहिए, उदाहरण ext_MyServerके लिए। उपकरण नाम ठीक से दूरस्थ MCP सर्वर द्वारा उजागर किए गए नामों से मेल खाना चाहिए। बेमेल नाम रनटाइम पर विफल करने के लिए उपकरण invocations के कारण है।

आप तीन तरीकों से मापदंडों की आपूर्ति कर सकते हैं:

• उन्हें कमांड-लाइन विकल्पों के रूप में पास करें।
• के साथ --input-fileएक JSON फ़ाइल प्रदान करें। आदेश-पंक्ति विकल्प फ़ाइल से मानों को ओवरराइड करते हैं। फ़ाइल संरचना के लिए CLI टेम्पलेट में देखें register-external-mcp-server-sample.json ।
• इंटरैक्टिव रूप से संकेत देने के लिए किसी भी आवश्यक मान को छोड़ दें।

पंजीकरण सफल होने के बाद, अपने टैनेंट व्यवस्थापक से नए MCP सर्वर को अनुमोदित करने के लिए कहें, इससे पहले कि एजेंट इसका उपयोग कर सकें। यदि आपने इसके साथ पंजीकरण ExternalOAuthकिया है, तो प्रदर्शित रीडायरेक्ट यूआरआई को अपने बाहरी आईडीपी एप्लिकेशन में भी जोड़ें।

Important

यदि Microsoft Entra अनुप्रयोग पंजीकरण बनाए जाने के बाद पंजीकरण विफल हो जाता है, तो ऐप्स स्वचालित रूप से वापस नहीं किए जाते हैं। पुन: प्रयास करने से पहले उन्हें Azure पोर्टल में मैन्युअल रूप से हटाएँ.

register-external-mcp-server विकल्प

कुछ विकल्पों की आवश्यकता केवल विशिष्ट प्रमाणीकरण प्रकारों के लिए होती है, जैसा कि विवरण स्तंभ में वर्णित है।

Option	Description
-s, --server-name <server-name>	MCP सर्वर का नाम। उदाहरण के लिए, अधिकतम 20 वर्णों से शुरू ext_ होना चाहिए और होना चाहिए ext_MyServer
-u, --server-url <server-url>	दूरस्थ MCP सर्वर URL. एक मान्य HTTP या HTTPS URL होना चाहिए
-a, --auth-type <auth-type>	प्रमाणीकरण प्रकार: EntraOAuth, ExternalOAuth, APIKey, या NoAuth
--publisher <publisher>	Publisher का नाम (पैकेज मेटाडेटा में उपयोग किया जाता है)
--description <description>	सर्वर विवरण (पैकेज मेटाडेटा में उपयोग किया जाता है)
--tools <tools>	उदाहरण के लिए, इस सर्वर द्वारा उजागर किए गए टूल नामों की अल्पविराम से अलग सूची tool1,tool2,tool3
-f, --input-file <input-file>	पंजीकरण मापदंडों के साथ JSON फ़ाइल का पथ
--remote-scopes <remote-scopes>	दूरस्थ MCP सर्वर के लिए स्कोप, उदाहरण api://{appId-guid}/{scopeName}के लिए। के साथ प्रयोग किया जाता है EntraOAuth
-t, --tenant-id <tenant-id>	ऐप पंजीकरण के लिए एंट्रा किरायेदार आईडी। वर्तमान az login टैनेंट के लिए डिफ़ॉल्ट
--service-tree-id <service-tree-id>	Entra ऐप पंजीकरण के लिए ServiceTree आईडी। Microsoft कॉर्पोरेट टैनेंट में आवश्यक
-l, --secret-lifetime-months <months>	बनाए गए Entra ऐप्स पर उत्पन्न क्लाइंट रहस्यों के लिए महीनों में जीवनकाल (1-24)। 24 महीने (2 वर्ष) तक डिफॉल्ट। यदि आपकी टैनेंट नीति कम अधिकतम लागू करती है, तो अपने टैनेंट में सीमा से छोटा appManagementPolicies मान सेट करें
--idp-authorization-url <url>	बाहरी OAuth प्राधिकरण URL. आवश्यक है जब --auth-type है ExternalOAuth
--idp-token-url <url>	बाहरी OAuth टोकन URL. आवश्यक है जब --auth-type है ExternalOAuth
--idp-scopes <scopes>	बाहरी OAuth स्कोप। आवश्यक है जब --auth-type है ExternalOAuth
--idp-client-id <client-id>	बाहरी OAuth क्लाइंट आईडी। आवश्यक है जब --auth-type है ExternalOAuth
--idp-client-secret <client-secret>	बाहरी OAuth क्लाइंट रहस्य। आवश्यक है जब --auth-type है ExternalOAuth
--api-key-location <location>	एपीआई कुंजी स्थान: Header या .Query आवश्यक है जब --auth-type है APIKey
--api-key-name <name>	एपीआई कुंजी पैरामीटर या हेडर नाम, उदाहरण X-API-Key के लिए या .token आवश्यक है जब --auth-type है APIKey
--dry-run	दिखाएँ कि निष्पादित किए बिना क्या किया जाएगा
-v, --verbose	वर्बोज़ लॉगिंग सक्षम करें
-?, , -h--help	मदद और उपयोग की जानकारी दिखाएं