إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
مرجع أمر Agent 365 CLI
إدارة خوادم MCP في بيئات Dataverse. يوفر الأمر develop-mcp خيارات لنشر وإلغاء نشر وتسجيل خوادم MCP لاستخدامها في بيئات داتافيرس.
Note
تمت إزالة أوامر develop-mcp approve، develop-mcp block، و develop-mcp package-mcp-server من وحدة تحكم الوكيل 365. يقوم مسؤولو المستأجرين الآن بإجراء الموافقة على الخوادم وحظر الخوادم في مركز الإدارة Microsoft — ويتم مراجعة الطلبات المعلقة في صفحة Requested Agents. لم يعد CLI ينتج حزم خوادم MCP لتقديم مراكز الإدارة؛ يقوم المسؤولون بانضمام وإدارة الخوادم مباشرة في مركز الإدارة.
الحد الأدنى للدور المطلوب: يختلف حسب الأمر الفرعي
Syntax
a365 develop-mcp [command] [options]
Options
| Option | Description |
|---|---|
-v، --verbose |
تمكين التسجيل التفصيلي |
-?، -h، --help |
إظهار معلومات التعليمات والاستخدام |
develop-mcp evaluate
قيم خادم MCP الخاص بك مقابل أفضل الممارسات العلمية لتقييم جاهزية الإنتاج. تنتج هذه الأداة تقرير تقييم شامل يتضمن الدرجات والتفسيرات وعناصر العمل. تكتشف الأوامر الأدوات التي يعرضها خادم MCP، وتجري مجموعة من الفحوصات الدلالية الحتمية والمدرجة بالذكاء الاصطناعي ضد مخططاتها، وتنتج تقرير HTML يقيم جودة المخطط ويسرد عناصر الإجراءات ذات الأولوية للتحسين.
a365 develop-mcp evaluate --server-url <server-url> [--auth-token <auth-token>] [options]
evaluate خيارات
| Option | Description |
|---|---|
-u، --server-url <server-url> |
Required. رابط نقطة نهاية HTTP القابل للتدفق في خادم MCP (عادة ما ينتهي ب /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 (تجنب تسجيل الذكاء الاصطناعي وتوقع قائمة تحقق مسبقا). |
-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"
قم بإنشاء قائمة الاختيار فقط، ثم سجلها باستخدام LLM الخاص بك:
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
evaluate متغيرات البيئة
استخدم المتغيرات البيئية التالية لتوفير المصادقة والتحكم اختياريا في أي نموذج يستخدمه كل محرك تسجيل محلي.
| Environment variable | Purpose |
|---|---|
A365_MCP_AUTH_TOKEN |
رمز حامل لخادم MCP، يستخدم عندما --auth-token لا يتم تمريره. مفضل على العلم لأنه يمنع الرمز من الدخول إلى قوائم العمليات وتاريخ الشل. |
A365_EVAL_COPILOT_MODEL |
تجاوز نموذج GitHub Copilot. يتطلب معرف نموذج دقيق، على سبيل المثال claude-haiku-4.5. |
A365_EVAL_CLAUDE_MODEL |
تجاوز نموذج كود كلود. يقبل اسم مستعار للنموذج (على سبيل المثال haiku) أو معرف نموذج كامل. |
develop-mcp list-environments
سرد جميع بيئات Dataverse المتوفرة لإدارة خادم MCP.
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 |
--dry-run |
إظهار ما سيتم القيام به دون تنفيذ |
-v، --verbose |
تمكين التسجيل التفصيلي |
-?، -h، --help |
إظهار معلومات التعليمات والاستخدام |
develop-mcp publish
نشر خادم MCP إلى بيئة Dataverse.
a365 develop-mcp publish [options]
استخدم هذا الأمر لنشر خادم MCP إلى بيئة Dataverse المحددة.
عند النشر، يقوم مؤشر التحكم بإنشاء تسجيل تطبيق <server-name>-PublicClients Microsoft Entra في المستأجر الخاص بك. يحمل هذا التطبيق صلاحيات OAuth التي يستخدمها مستضيفو العميل (مثل تعليمة Visual Studio برمجية وMicrosoft 365 Copilot CLI) لاستدعاء خادم MCP المنشور. نظرا لأن الأمر ينشئ تسجيل تطبيق، يجب أن يحصل الحساب الذي يشغل وحدة التحكم على إذن Application.ReadWrite.All Microsoft Graph. التشغيل publish بدونه يفشل.
Note
توفير --publisher-name خوادم MCP مخصصة (أنشأها المستخدمون). تكتب القيمة على بيانات تعريف المطور للحزمة المنشورة وهي مطلوبة لهذه الخوادم. يتم تجاهله في الخوادم المملوكة ل Microsoft من الطرف الأول (مثل msdyn_DataverseMCPServer)، التي تنشر دائما ك "Microsoft". عندما تحذفه، يقوم مؤشر القيادة بتوجيه له بشكل تفاعلي؛ التمرير --yes للنشر بدون التعليمات في سياقات CI أو البرمجة المكتوبة.
publish خيارات
| Option | Description |
|---|---|
-e، --environment-id <environment-id> |
معرف بيئة Dataverse |
-s، --server-name <server-name> |
اسم خادم MCP للنشر |
-a، --alias <alias> |
الاسم المستعار لخادم MCP |
-d، --display-name <display-name> |
اسم العرض لخادم MCP |
-p، --publisher-name <publisher-name> |
اسم Publisher مكتوب على بيانات الحزمة المنشورة. مطلوب لخوادم MCP المخصصة (التي أنشأها المستخدمون)؛ تم تجاهلها بالنسبة لخوادم Microsoft المملوكة للطرف الأول. يتم الاستفسار منها بشكل تفاعلي عند حذفه. |
-y، --yes |
تجاوز التفاعل "هل تتابع النشر؟ (y/N)" confirmation. استخدامه في CI أو السياقات المكتوبة. |
--dry-run |
إظهار ما سيتم القيام به دون تنفيذ |
-v، --verbose |
تمكين التسجيل التفصيلي |
-?، -h، --help |
إظهار معلومات التعليمات والاستخدام |
develop-mcp unpublish
إلغاء نشر خادم MCP من بيئة Dataverse.
a365 develop-mcp unpublish [options]
استخدم هذا الأمر لإزالة خادم MCP من بيئة Dataverse المحددة.
unpublish خيارات
| Option | Description |
|---|---|
-e، --environment-id <environment-id> |
معرف بيئة Dataverse |
-s، --server-name <server-name> |
اسم خادم MCP لإلغاء النشر |
--dry-run |
إظهار ما سيتم القيام به دون تنفيذ |
-?، -h، --help |
إظهار معلومات التعليمات والاستخدام |
develop-mcp register-external-mcp-server
سجل خادم MCP خارجي يحتوي على Entra، أو OAuth خارجي، أو مفتاح API، أو بدون مصادقة.
a365 develop-mcp register-external-mcp-server [options]
استخدم هذا الأمر لتسجيل خادم MCP مستضاف خارجيا (طرف ثالث) مع المستأجر الخاص بك. ينشئ الأمر تسجيلات تطبيق Microsoft Entra التي تحتاجها المنصة، ويستدعي منصة Agent 365 لإضافة خادم MCP، ويضبط إعادة توجيه URIs وأمنيات API على تسجيلات التطبيقات الجديدة.
يجب أن يبدأ اسم الخادم بالبادئة ext_ وأن يكون طوله على الأكثر 20 حرفا، على سبيل المثال ext_MyServer. يجب أن تتطابق أسماء الأدوات تماما مع الأسماء التي يعرضها خادم MCP البعيد. الأسماء غير المتطابقة تسبب فشل استدعاءات الأدوات أثناء وقت التشغيل.
يمكنك توفير المعلمات بثلاث طرق:
- مررها كخيارات سطر الأوامر.
- قدم ملف JSON مع
--input-file. خيارات سطر الأوامر تتجاوز القيم من الملف. انظرregister-external-mcp-server-sample.jsonفي قوالب سطر الأوامر لبنية الملفات. - احذف أي قيمة مطلوبة ليتم تحفيزها بشكل تفاعلي.
بعد نجاح التسجيل، اطلب من مسؤول المستأجر الموافقة على خادم MCP الجديد قبل أن يتمكن الوكلاء من استخدامه. إذا سجلت في ExternalOAuth، أضف أيضا رابط إعادة التوجيه المعروض إلى تطبيق IDP الخارجي.
Important
إذا فشل التسجيل بعد إنشاء تسجيلات تطبيق Microsoft Entra، فلن يتم التراجع عن التطبيقات تلقائيا. قم بحذفها يدويا من بوابة Azure قبل إعادة المحاولة.
register-external-mcp-server خيارات
بعض الخيارات مطلوبة فقط لأنواع مصادقة محددة، كما هو موضح في عمود الوصف.
| Option | Description |
|---|---|
-s، --server-name <server-name> |
اسم خادم MCP. يجب أن تبدأ ext_ ب وتكون على الأكثر 20 حرفا، على سبيل المثال ext_MyServer |
-u، --server-url <server-url> |
رابط خادم MCP البعيد. يجب أن يكون رابط HTTP أو HTTPS صالحا |
-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> |
على سبيل المثال api://{appId-guid}/{scopeName}، نكوبات خادم MCP البعيد. يُستخدم مع EntraOAuth |
-t، --tenant-id <tenant-id> |
معرف المستأجر Entra لتسجيل التطبيق. الافتراضية إلى المستأجر الحالي az login |
--service-tree-id <service-tree-id> |
معرف ServiceTree لتسجيل تطبيق إنترا. مطلوب في مستأجري Microsoft المؤسسيين |
-l، --secret-lifetime-months <months> |
مدى الحياة بشهر (1-24) لأسرار العملاء المولدة على تطبيقات إنترا التي تم إنشاؤها. الافتراضية تصبح 24 شهرا (سنتان). حدد قيمة أقل من الحد الأقصى appManagementPolicies في مستأجرك إذا كانت وثيقة المستأجر تفرض حدا قصويا أقصر |
--idp-authorization-url <url> |
رابط تفويض OAuth الخارجي. مطلوب عندما --auth-type يكون ExternalOAuth |
--idp-token-url <url> |
رابط الرمز الخارجي OAuth. مطلوب عندما --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> |
موقع مفتاح واجهة برمجة التطبيقات (API): Header أو Query. مطلوب عندما --auth-type يكون APIKey |
--api-key-name <name> |
مثل اسم معلمة مفتاح أو رأس واجهة برمجة التطبيقات، X-API-Key أو token. مطلوب عندما --auth-type يكون APIKey |
--dry-run |
إظهار ما سيتم القيام به دون تنفيذ |
-v، --verbose |
تمكين التسجيل التفصيلي |
-?، -h، --help |
إظهار معلومات التعليمات والاستخدام |