مرجع أمر Agent 365 CLI develop

إدارة خوادم أدوات MCP لتطوير العامل. develop يوفر الأمر خيارات لإدارة خوادم أدوات MCP (بروتوكول سياق النموذج) لتطوير العامل. يمكنك سرد الخوادم المتوفرة وعرض الخوادم المكونة وإضافة خوادم MCP أو إزالتها من تكوين العامل.

الحد الأدنى للدور المطلوب: لا شيء (إدارة البيان المحلي)

Syntax

a365 develop [command] [options]

Options

Option	Description
-c، --config <config>	مسار ملف التكوين. Default: a365.config.json
-v، --verbose	تمكين التسجيل التفصيلي
-?، -h، --help	إظهار معلومات التعليمات والاستخدام.

develop list-available

سرد جميع خوادم MCP المتوفرة في الكتالوج (ما يمكنك تثبيته).

a365 develop list-available [options]

يعرض هذا الأمر كافة خوادم MCP المتوفرة في الكتالوج ويمكنك تثبيتها للاستخدام مع تطوير العامل الخاص بك.

list-available خيارات

Option	Description
--dry-run	إظهار ما سيفعله الأمر دون تنفيذه.
--skip-auth	Skip authentication. للاختبار فقط. من المحتمل أن يفشل الأمر دون مصادقة صالحة.
-?، -h، --help	إظهار معلومات التعليمات والاستخدام.

Note

develop list-available لا يتطلب a365.config.json. يقرأ البيئة من A365_ENVIRONMENT متغير البيئة (يتحول افتراضيا إلى prod).

develop list-configured

قائمة خوادم MCP المكونة حاليا من المحلي ToolingManifest.jsonالخاص بك.

a365 develop list-configured [options]

يعرض هذا الأمر كافة خوادم MCP التي قمت بتكوينها حاليا في ملف ToolingManifest.json المحلي.

list-configured خيارات

Option	Description
--project-path <path>	مسار إلى دليل مشروع الوكيل الذي يحتوي على ToolingManifest.json. تجاوز DeploymentProjectPath من a365.config.json.
--dry-run	إظهار ما سيفعله الأمر دون تنفيذه.
-?، -h، --help	إظهار معلومات التعليمات والاستخدام.

develop add-mcp-servers

إضافة خوادم MCP إلى تكوين العامل الحالي.

a365 develop add-mcp-servers [<servers>...] [options]

يضيف هذا الأمر خوادم MCP المحددة إلى ToolingManifest.json في مجلد المشروع. لا يمنح أذونات لمخطط العامل.

Important

هذا الأمر يحدث ToolingManifest.json فقط - ولا يمنح الأذونات لمخطط الوكيل. كيفية تطبيق الأصوات تعتمد على وضعك في عملية الإعداد:

• قبل الإعداد الأولي: تابع مع a365 setup all. يتم تطبيق أذونات MCP كجزء من إنشاء المخطط الأولي.
• بعد وجود المخطط بالفعل: يجب تشغيل a365 setup permissions mcp المسؤول العام بشكل منفصل. يجب على المسؤول التحقق من أن يشير deploymentProjectPath إلى مجلد المشروع الذي يحتوي على التحديث ToolingManifest.json.

add-mcp-servers الحجج

حدد واحدا أو أكثر من أسماء خوادم MCP لإضافتها إلى تكوين العامل. يمكنك توفير أسماء خوادم متعددة مفصولة بمسافات.

Argument	Description
<servers>	أسماء خوادم MCP المراد إضافتها

add-mcp-servers خيارات

استخدم هذه الخيارات لتخصيص سلوك add-mcp-servers الأمر.

Option	Description
--project-path <path>	مسار إلى دليل مشروع الوكيل الذي يحتوي على ToolingManifest.json. تجاوز DeploymentProjectPath من a365.config.json.
--dry-run	إظهار ما سيفعله الأمر دون تنفيذه.
-?، -h، --help	إظهار معلومات التعليمات والاستخدام.

develop remove-mcp-servers

إزالة خوادم MCP من تكوين العامل الحالي.

a365 develop remove-mcp-servers [<servers>...] [options]

يزيل هذا الأمر خوادم MCP المحددة من تكوين العامل الحالي.

remove-mcp-servers الحجج

Argument	Description
<servers>	أسماء خوادم MCP المراد إزالتها

remove-mcp-servers خيارات

Option	Description
--project-path <path>	مسار إلى دليل مشروع الوكيل الذي يحتوي على ToolingManifest.json. تجاوز DeploymentProjectPath من a365.config.json.
--dry-run	إظهار ما سيفعله الأمر دون تنفيذه.
-?، -h، --help	إظهار معلومات التعليمات والاستخدام.

develop add-permissions

أضف أذونات واجهة برمجة تطبيقات خادم MCP إلى Microsoft Entra التطبيقات لسيناريوهات التطوير حيث تحتاج إلى تكوين تطبيقات مخصصة للوصول إلى خوادم MCP.

a365 develop add-permissions [options]

add-permissions خيارات

استخدم هذه الخيارات لإضافة أذونات ونطاقات واجهة برمجة التطبيقات المطلوبة إلى تسجيل التطبيق الخاص بك، والاستفادة من القيم من بيان الأدوات.

Option	Description
-c، --config <config>	مسار ملف التكوين (افتراضي: a365.config.json)
-m، --manifest <manifest>	المسار إلى ToolingManifest.json (الافتراضي: <deploymentProjectPath>/ToolingManifest.json)
--app-id <app-id>	معرف التطبيق (العميل) لإضافة أذونات إلى (افتراضي: clientAppId من التكوين)
--scopes <scopes>	نطاقات محددة لإضافتها (مفصولة بمسافة) (افتراضي: كافة النطاقات من ToolingManifest.json)
--dry-run	إظهار ما سيفعله الأمر دون إجراء تغييرات
-v، --verbose	إظهار الإخراج التفصيلي
-?، -h، --help	إظهار معلومات التعليمات والاستخدام.

Important

يجب أن يكون للتطبيق المحدد بواسطة --app-id أو clientAppId إذن Application.ReadWrite.All في Microsoft Entra. هذا الأمر مخصص لتطبيقات العميل المخصصة. لتكوين أذونات لمخططات العامل، استخدم a365 setup permissions mcp بدلا من ذلك.

develop get-token

استرداد الرموز المميزة للحامل لاختبار خوادم MCP أثناء التطوير باستخدام مصادقة المستعرض التفاعلية.

a365 develop get-token [options]

get-token خيارات

استخدم هذه الخيارات لطلب رمز مميز للوصول، والتحكم في النطاقات، وتحديث السلوك، واختيار تنسيق الإخراج.

Option	Description
-c، --config <config>	مسار ملف التكوين (افتراضي: a365.config.json)
--app-id <app-id>	معرف التطبيق (العميل) للمصادقة (افتراضي: clientAppId من التكوين)
-m، --manifest <manifest>	المسار إلى ToolingManifest.json (الافتراضي: <deploymentProjectPath>/ToolingManifest.json)
--scopes <scopes>	نطاقات محددة لطلبها (مفصولة بمسافة) (افتراضي: قراءة من ToolingManifest.json)
-o، --output <output>	تنسيق الإخراج: tableأو jsonأو raw (افتراضي: table)
--force-refresh	فرض تحديث الرمز المميز لتجاوز ذاكرة التخزين المؤقت
--resource <resource>	الكلمة الأساسية للمورد للحصول على رمز مميز ل: mcp (افتراضي) أو powerplatform
--resource-id <resource-id>	معرف تطبيق الموارد المخصص (GUID) للموارد التي لا تغطيها --resource الكلمات الأساسية
-v، --verbose	إظهار الإخراج التفصيلي بما في ذلك الرمز المميز الكامل
-?، -h، --help	إظهار معلومات التعليمات والاستخدام.

get-token خيارات الموارد

استخدم خيارات --resource و --resource-id للحصول على رموز مميزة لموارد Azure المختلفة:

• --resource: استخدم كلمة أساسية لتحديد مورد معرف مسبقا:
  • mcp (افتراضي): أدوات العامل 365 لخوادم MCP
  • powerplatform: واجهة برمجة تطبيقات Power Platform
• --resource-id: أدخل معرف تطبيق مورد مخصص (GUID) للموارد التي لا تغطيها الكلمات الأساسية

Important

لا يمكنك استخدام --resource ذلك --resource-id معا. عند استخدام أي من الخيارين، قم بتضمين --scopes. يدعم تدفق MCP الافتراضي فقط دقة النطاق المستندة إلى البيان.

develop start-mock-tooling-server

ابدأ خادم أدوات وهمية لأغراض الاختبار والتطوير.

a365 develop start-mock-tooling-server [options]

يبدأ هذا الأمر خادم أدوات وهمية لأغراض الاختبار والتطوير. باستخدام هذا الخادم، يمكنك محاكاة تفاعلات خادم MCP دون الحاجة إلى تطبيقات الخادم الفعلية.

start-mock-tooling-server خيارات

استخدم هذه الخيارات لتخصيص سلوك start-mock-tooling-server الأمر.

Option	Description	Default
-p, --port <port>	رقم المنفذ لخادم النموذج	5309
-v, --verbose	تمكين التسجيل التفصيلي	false
-?, -h, --help	إظهار معلومات التعليمات والاستخدام	-
-bg	شغل الخادم على نافذة طرفية جديدة	-