مرجع أمر Agent 365 CLI develop-mcp

إدارة خوادم MCP في بيئات Dataverse. يوفر الأمر develop-mcp خيارات للنشر، إلغاء النشر، الموافقة، الحجب، التغليف، وتسجيل خوادم MCP لاستخدامها في بيئات Dataverse.

الحد الأدنى للدور المطلوب: يختلف حسب الأمر الفرعي

Syntax

a365 develop-mcp [command] [options]

Options

Option	Description
-v، --verbose	تمكين التسجيل التفصيلي
-?، -h، --help	إظهار معلومات التعليمات والاستخدام

develop-mcp list-environments

سرد جميع بيئات Dataverse المتوفرة لإدارة خادم MCP.

a365 develop-mcp list-environments [options]

يعرض هذا الأمر جميع بيئات Dataverse حيث يمكنك إدارة خوادم MCP.

list-environments خيارات

Option	Description
-c، --config <config>	مسار ملف التكوين (افتراضي: a365.config.json)
--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
-c، --config <config>	مسار ملف التكوين (افتراضي: a365.config.json)
--dry-run	إظهار ما سيتم القيام به دون تنفيذ
-v، --verbose	تمكين التسجيل التفصيلي
-?، -h، --help	إظهار معلومات التعليمات والاستخدام

develop-mcp publish

نشر خادم MCP إلى بيئة Dataverse.

a365 develop-mcp publish [options]

استخدم هذا الأمر لنشر خادم MCP إلى بيئة Dataverse المحددة.

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
-c، --config <config>	مسار ملف التكوين (افتراضي: a365.config.json)
--dry-run	إظهار ما سيتم القيام به دون تنفيذ
-?، -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 لإلغاء النشر
-c، --config <config>	مسار ملف التكوين (افتراضي: a365.config.json)
--dry-run	إظهار ما سيتم القيام به دون تنفيذ
-?، -h، --help	إظهار معلومات التعليمات والاستخدام

develop-mcp approve

الموافقة على خادم MCP.

a365 develop-mcp approve [options]

يوافق هذا الأمر على خادم MCP للاستخدام في البيئة.

approve خيارات

Option	Description
-s، --server-name <server-name>	اسم خادم MCP للموافقة عليه
-c، --config <config>	مسار ملف التكوين (افتراضي: a365.config.json)
--dry-run	إظهار ما سيتم القيام به دون تنفيذ
-?، -h، --help	إظهار معلومات التعليمات والاستخدام

develop-mcp block

حظر خادم MCP.

a365 develop-mcp block [options]

استخدم هذا الأمر لمنع استخدام خادم MCP في البيئة الخاصة بك.

block خيارات

Option	Description
-s، --server-name <server-name>	اسم خادم MCP المراد حظره
-c، --config <config>	مسار ملف التكوين (افتراضي: a365.config.json)
--dry-run	إظهار ما سيتم القيام به دون تنفيذ
-?، -h، --help	إظهار معلومات التعليمات والاستخدام

develop-mcp package-mcp-server

إنشاء حزمة خادم MCP لتقديمها على مركز إدارة Microsoft.

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

استخدم هذا الأمر لإنشاء حزمة توزيع لخادم MCP يمكنك إرسالها إلى مركز إدارة Microsoft.

package-mcp-server خيارات

Option	Description
--server-name <server-name>	اسم خادم MCP (مطلوب)
--developer-name <developer-name>	اسم عرض الناشر أو المطور (مطلوب)
--icon-url <icon-url>	عنوان URL عام لأيقونة PNG لخادم MCP (مطلوب)
--output-path <output-path>	الدليل الهدف لحزمة ZIP التي تم إنشاؤها (مطلوب)
--dry-run	إظهار ما سيتم القيام به دون تنفيذ
-c، --config <config>	مسار ملف التكوين (افتراضي: a365.config.json)
-?، -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 المؤسسيين
--idp-authorization-url <url>	رابط تفويض OAuth الخارجي. مطلوب عند --auth-typeExternalOAuth
--idp-token-url <url>	رابط الرمز الخارجي OAuth. مطلوب عند --auth-typeExternalOAuth
--idp-scopes <scopes>	منظارات خارجية OAuth. مطلوب عند --auth-typeExternalOAuth
--idp-client-id <client-id>	معرف العميل الخارجي OAuth. مطلوب عند --auth-typeExternalOAuth
--idp-client-secret <client-secret>	سر عميل OAuth الخارجي. مطلوب عند --auth-typeExternalOAuth
--api-key-location <location>	موقع مفتاح واجهة برمجة التطبيقات (API): Header أو Query. مطلوب عند --auth-typeAPIKey
--api-key-name <name>	مثل اسم معلمة مفتاح أو رأس واجهة برمجة التطبيقات، X-API-Key أو token. مطلوب عند --auth-typeAPIKey
--dry-run	إظهار ما سيتم القيام به دون تنفيذ
-v، --verbose	تمكين التسجيل التفصيلي
-?، -h، --help	إظهار معلومات التعليمات والاستخدام