تكامل MCP
يدعم OpenFactory Model Context Protocol حتى تساعد مساعدات الذكاء الاصطناعي في إنشاء البناءات وفحص الوصفات وإدارة الأجهزة الافتراضية ومراجعة نتائج الاختبار.
استخدم MCP عندما تريد العمل مع OpenFactory من Claude أو Cursor أو Claude Code أو OpenAI Codex أو عميل متوافق آخر دون التنقل بين الأدوات.
المتطلبات
- عميل MCP يدعم خوادم MCP البعيدة
- للوصول المرتبط بالحساب، سجّل الدخول إلى OpenFactory في هذا المتصفح
- لوصول الضيف، استخدم رمز الضيف المولّد المعروض أدناه
تُعرض مفاتيح API للحساب مرة عند الإنشاء ويمكن إلغاؤها من اللوحة. رموز الضيف معرّفات متصفح لوصول محسوب؛ ليست أسرار حساب.
نقاط النهاية
| النقل | URL | الاستخدام |
|---|---|---|
| Streamable HTTP | https://console.openfactory.tech/mcp-stream/mcp | نقطة MCP في OpenFactory |
Streamable HTTP هو النقل الوحيد المدعوم. نقاط HTTP+SSE الأقدم (/mcp/sse،
/mcp/messages) سُحبت وتعيد الآن 410 Gone؛ وجّه أي عميل ما زال يستخدمها إلى
عنوان Streamable HTTP أعلاه بنفس ترويسة Authorization. يدعم Claude Code وClaude
Desktop وCursor وCodex وOpenCode جميعا Streamable HTTP.
إعداد للنسخ واللصق
أعد تشغيل Claude Desktop أو Cursor أو OpenAI Codex أو أي عميل MCP طويل التشغيل بعد
تغيير إعدادات MCP. يقرأ OpenAI Codex خوادم MCP من ~/.codex/config.toml ويتصل بـ
Streamable HTTP مباشرة: لا حاجة لجسر mcp-remote. قد تطلب موصلات Claude.ai المخصصة
عنوان الخادم والترويسة كحقلين منفصلين.
القدرات المتاحة
يعرض OpenFactory أدوات مواجهة للعميل من أجل:
| الفئة | أمثلة |
|---|---|
| البناءات | سرد البناءات، إنشاؤها من وصفات، فحص الحالة، إعادة المحاولة عند الفشل |
| الوصفات | تصفح القوالب، التحقق من الوصفات، تخصيص القوالب |
| الصور | روابط تنزيل للمخرجات المكتملة |
| الأجهزة الافتراضية | سردها، إنشاء أجهزة اختبار، تشغيل أو إيقاف، فتح روابط اللوحة |
| الاختبارات | تشغيل التحقق، سرد التشغيلات، فحص النتائج، إدارة مجموعات اختبار قابلة لإعادة الاستخدام |
| اختبار واجهة التطبيق | قيادة جهاز مختبر لاختبار أي عنوان تطبيق: سيناريوهات واجهة قابلة لإعادة الاستخدام وتتصلب ذاتيا. لا يلزم نشر |
| نشر التطبيق | نشر مستودع Git كتطبيق ويب حي بعنوان معاينة عام (https://<slug>.apps.openfactory.tech) |
يمكن أن يختلف توفر الأدوات حسب الخطة وأذونات المؤسسة.
مجموعات اختبار قابلة لإعادة الاستخدام
يمكن إنشاء مجموعات الاختبار قبل بناء متغير أو ISO. عرّف حالة اختبار واحدة أو أكثر
وتحققات مخصصة واختبارات مسبقة التعريف وفتحات هدف ISO مسماة مثل primary أو
client أو server. عندما تكون البناءات جاهزة، اربط كل فتحة ببناء مكتمل وشغّل
المجموعة.
| الأداة | الاستخدام |
|---|---|
create_test_suite | إنشاء مجموعة قابلة لإعادة الاستخدام دون متغير مبني |
list_test_suites | سرد المجموعات المتاحة لمستخدم MCP الحالي |
get_test_suite | عرض تعريف المجموعة وتاريخ التشغيل الحديث |
update_test_suite_targets | ربط فتحات هدف ISO المسماة ببناءات مكتملة |
run_test_suite | تشغيل مجموعة ضد فتحات هدف ISO المرتبطة |
list_test_suite_runs | سرد التشغيلات المنشأة من مجموعة |
get_test_suite_status | عرض جاهزية التأليف وحالة أحدث تشغيل |
اختبار واجهة التطبيق: أي عنوان، بلا نشر
اختبر واجهة أي تطبيق ويب بتوجيه جهاز مختبر مُدار إلى عنوان. لا تنشر تطبيقك مع OpenFactory لاختباره. يفتح جهاز المختبر خادم تطوير محليا، أو نشرا للمعاينة/الإنتاج على Vercel أو AWS أو Netlify أو أي مضيف، أو أي عنوان عام يصل إليه الجهاز. يبقى تطبيقك حيث يعمل أصلا.
تُكتب السيناريوهات بلغة عادية وهي تتصلب ذاتيا: يتعلم التشغيل الأول موضع كل عنصر
واجهة، وتعيد التشغيلات اللاحقة من تلك الذاكرة (متخطية المرور البصري البطيء). ذلك يجعل
الإعادة سريعة ومقاومة لتغييرات واجهة صغيرة. تدعم السيناريوهات متغيرات البيئة
(${VAR}) والمصادقة الثنائية (${totp:VAR}، RFC 6238) لعمليات الدخول؛ تُمرَّر
الأسرار وقت التشغيل ولا تُخزَّن.
| الأداة | الاستخدام |
|---|---|
ensure_tester_vm | جلب أو إنشاء جهاز مختبر سطح مكتب دائم |
create_app_scenario | حفظ سيناريو واجهة قابل لإعادة الاستخدام لعنوان تطبيق |
run_app_scenario | تشغيله (مرّر أسرار وقت التشغيل هنا) وتسجيل لقطات + حكم |
list_app_scenarios / get_app_scenario | تصفح السيناريوهات وذاكرتها المتصلبة |
start_app_test / record_app_test_step / finish_app_test | قيادة وتسجيل تشغيل عارض بنفسك |
annotate_screenshot | رسم صناديق تمييز معنونة على لقطة |
انظر اختبار واجهة التطبيق لسير العمل الكامل ومخطط الخطوات وأمثلة المصادقة الثنائية.
نشر التطبيق: مستودع Git إلى عنوان عام
انشر تطبيقا ويب مباشرة من مستودع Git واحصل على عنوان معاينة عام
(https://<slug>.apps.openfactory.tech) يمكنك فتحه أو مشاركته أو توجيه سيناريو اختبار
إليه. يستنسخ OpenFactory المستودع ويثبّت الاعتماديات ويبدأ التطبيق ويفحص صحته. لا شيء
للربط: لا توجيه منافذ ولا أنفاق ولا DNS.
هذا يتوافق مع اختبار واجهة التطبيق: انشر تطبيقك ثم شغّل سيناريو ضد عنوان المعاينة، أو تخطّ النشر واختبر تطبيقا تستضيفه أصلا (Vercel، AWS، …).
| الأداة | الاستخدام |
|---|---|
create_app | تسجيل مستودع Git كتطبيق (الاسم، المصدر، التسمية) |
deploy_app | نشر التطبيق وإعادة عنوان المعاينة العام |
list_apps / get_app | تصفح تطبيقاتك وعناوينها وتاريخ النشر |
iterate_app | توزيع تغيير بلغة طبيعية على تطبيق؛ يطبقه وكيل ويعيد النشر |
get_app_build_status | استطلاع حالة نشر التطبيق وتذاكر التغيير قيد التنفيذ |
انظر نشر التطبيق لسير العمل الكامل. لتمكين مستخدميك من نطق تغييرات على تطبيقك من زر ميكروفون، انظر ودجة التكرار الصوتي.
أمثلة موجهات
Show my most recent OpenFactory builds and summarize any failures.Create a Debian server image with SSH, Docker, a deploy user, and default verification tests.Validate this recipe before I start a build.Start a VM from my latest completed build and give me the console link.Create a reusable smoke test suite for example-project with primary and client ISO slots. I will bind the builds later.Create a smoke-login scenario for my app at https://my-app.vercel.app, run it in a tester VM, and verify the dashboard loads. I'll give you the password and 2FA seed at run time.ملاحظات الأمان
- استخدم مفاتيح API فقط مع عملاء تثق بهم.
- ألغِ المفاتيح القديمة من اللوحة عند تدوير الأجهزة أو مغادرة مشروع.
- فضّل أذونات أدوات تتطلب الموافقة للإجراءات التي تنشئ بناءات أو تشغّل أجهزة أو تغيّر البنية.
- لا تلصق مفاتيح OpenFactory API في موجهات أو تذاكر أو مستودعات عامة أو مستندات مشتركة.
استكشاف الأخطاء
الأدوات لا تظهر
أعد تشغيل عميل MCP وأكد أن عنوان الخادم هو بالضبط:
https://console.openfactory.tech/mcp-stream/mcpإذا كان عميلك مضبوطا بعنوان /mcp/sse المسحوب فسيحصل على 410 Gone: غيّر العنوان
إلى أعلاه؛ لا يلزم تغيير آخر.
المصادقة تفشل
حدّث هذه الصفحة وانسخ الإعداد المولّد مجددا. يجب أن يستخدم المستخدمون المسجّلون ترويسة
Authorization المولّدة. يجب أن يستخدم الضيوف ترويسة X-Guest-Id المولّدة من إعداد
النسخ واللصق أعلاه.
إجراءات البناء أو الجهاز تفشل
تحقق من خطة OpenFactory وأذونات المؤسسة وحالة البناء. بعض الإجراءات تتطلب بناء مكتمل أو استحقاق جهاز دائم أو أذونات المؤسسات.
أخطاء النقل
حدّث عميل MCP إذا كان لا يدعم Streamable HTTP. إذا تعذر التحديث، انتقل إلى نقطة توافق HTTP+SSE.