تخطَّ إلى المحتوى

اربط Claude Code أو Codex أو Cursor بـ MonstarX

باختصارلدى MonstarX خادم MCP على https://monstarx.com/mcp. أضفه إلى Claude Code أو Codex أو Cursor أو VS Code أو Gemini CLI أو Windsurf أو ChatGPT أو تطبيق Claude، وسجّل الدخول مرة واحدة في متصفحك، ثم قل «أرسل هذا التطبيق إلى MonstarX وأعطني الرابط». بعدها يستطيع وكيلك إرسال إصدارات جديدة، وجلب تغييرات MonstarX، وطلب الإنشاء من MonstarX، وضبط الأسرار، والنشر.

وكلاء البرمجة بالذكاء الاصطناعي، مثل Claude Code وCodex وCursor، بارعون في كتابة التطبيقات، لكنهم يتركون لك كل ما عدا ذلك: مكانًا لتشغيل التطبيق، ورابطًا لمشاركته، ونطاقًا، وقاعدة بيانات، واختبارات، وطريقة تتيح لغير المطورين مواصلة تغييره. وMonstarX هو كل ما عدا ذلك.

اربط وكيلك بـ MonstarX مرة واحدة، وعندها تكفي عبارة مثل «أرسل هذا التطبيق إلى MonstarX» لتضع ما أنشأه على MonstarX، يعمل في معاينة مباشرة مع رابط للمشاركة. ومن تلك اللحظة يمكنك مواصلة الإنشاء في وكيلك أو في MonstarX أو في كليهما، فالعمل يسير في الاتجاهين.

يتصل الوكلاء عبر MCP (بروتوكول Model Context Protocol، وهو طريقة قياسية تتيح لأدوات الذكاء الاصطناعي استخدام خدمات أخرى). ويوجد خادم MCP الخاص بـ MonstarX على:

https://monstarx.com/mcp

دليل المطورين الكامل موجود في صفحة MCP في MonstarX.

  1. افتح الإعداداتAPI & MCP. تحت ربط وكيل برمجة، اختر وكيلك.

  2. أبقِ تسجيل الدخول عبر المتصفح محددًا، وانسخ الإعداد المعروض إلى وكيلك. وتعرض التبويبات أدناه الإعداد نفسه لأكثر الوكلاء استخدامًا.

  3. سجّل الدخول إلى MonstarX عندما يطلب وكيلك ذلك. يفتح متصفحك MonstarX: سجّل الدخول واضغط السماح. لا حاجة إلى مفتاح.

  4. قل لوكيلك: «أرسل هذا التطبيق إلى MonstarX وأعطني الرابط.»

تشترك أداة سطر الأوامر في Claude Code، وتبويب Code في تطبيق سطح المكتب، وإضافات بيئات التطوير في إعداد واحد. شغّل:

نافذة طرفيّة
claude mcp add --transport http --scope user monstarx https://monstarx.com/mcp

ثم شغّل /mcp في Claude Code، واختر monstarx ثم Authenticate (أو شغّل claude mcp login monstarx). يفتح متصفحك MonstarX: سجّل الدخول واضغط السماح.

يجعل الخيار --scope user خادم MonstarX متاحًا في كل مجلد، وإذا حذفته يُضاف إلى المشروع الحالي فقط.

تغطي صفحة الإعدادات أيضًا Grok وLovable وBolt & v0 وReplit وFigma وأخرى، أي أداة تتحدث بروتوكول MCP. ودليل المطورين الكامل، مع المزيد من العملاء، موجود خلف زر التوثيق في أعلى الإعداداتAPI & MCP.

ماذا لو احتاج وكيلي إلى مفتاح؟

Section titled “ماذا لو احتاج وكيلي إلى مفتاح؟”

تستخدم Windsurf وGemini CLI والسكربتات وأنظمة CI مفتاح API بدل تسجيل الدخول عبر المتصفح. أنشئ مفتاحًا من الإعداداتAPI & MCP تحت مفاتيح API، ثم بدّل إعداد الوكيل إلى مفتاح API لتحصل على النسخة التي تتضمن المفتاح. راجع API & MCP لمعرفة كيف تنشئ المفاتيح وتستخدمها وتبطلها، وأبقِ المفاتيح بعيدًا عن الشفرة والمحادثات: فالمفتاح يتصرف باسمك في كل مشروع.

ماذا يمكنني أن أطلب من وكيلي؟

Section titled “ماذا يمكنني أن أطلب من وكيلي؟”

بعد الربط، تحدّث مع وكيلك بكلمات بسيطة. جرّب ما يلي:

  • «أرسل هذا التطبيق إلى MonstarX وأعطني الرابط.»
  • «أرسل تغييراتي إلى MonstarX.»
  • «اجلب أحدث إصدار من MonstarX وادمجه مع تغييراتي.»
  • «اطلب من MonstarX إضافة دفع عبر Stripe، ثم اجلب تغييراته.»
  • «انشره على MonstarX.»

وفي تطبيق محادثة بلا سطر أوامر (تطبيق Claude أو ChatGPT)، جرّب «أنشئ لي تطبيق حجز لصالوني على MonstarX»، أو «استورد github.com/me/my-app إلى MonstarX»، أو «ماذا يفعل MonstarX في مشروع مراقبة الميناء الخاص بي؟».

ماذا يحدث عندما يرسل وكيلي تطبيقًا؟

Section titled “ماذا يحدث عندما يرسل وكيلي تطبيقًا؟”
  1. يطلب الوكيل من MonstarX رابط رفع لمرة واحدة، ثم يرسل مجلد تطبيقك بأمر واحد. تبقى node_modules ومخرجات البناء وملفات .env على جهازك، ولا تمر الملفات أبدًا عبر نموذج الذكاء الاصطناعي، فلا يكلّف التطبيق الكبير رموزًا (tokens) أكثر من التطبيق الصغير.

  2. يتحقق MonstarX من نوع التطبيق، وهو الفحص نفسه المستخدم عند استيراد تطبيق، ثم يشغّله في معاينة مباشرة بحزمه الخاصة.

  3. يتلقى الوكيل رابط المشروع، وما وجده MonstarX، وأي مفاتيح ما زال التطبيق يحتاج إليها.

يصبح كل إرسال لاحق إصدارًا جديدًا في الإصدارات، يحمل اسم الوكيل («أُرسل من Claude Code»)، مع ملاحظة في المحادثة لتعرف أنت ووكيل الإنشاء في MonstarX ما الذي تغيّر. وإذا أنشأ أحد شيئًا في MonstarX منذ آخر نسخة حصل عليها وكيلك، يُرفض الإرسال بدل أن يستبدل عمله: فينزّل الوكيل إصدار MonstarX، ويدمج التغييرات، ثم يرسل مجددًا.

ما الأدوات التي يمنحها MonstarX لوكيلي؟

Section titled “ما الأدوات التي يمنحها MonstarX لوكيلي؟”
الأداةماذا تفعل
get_accountحسابك وخطتك وما تبقى من حصتك
list_projectsمشاريعك، من الأحدث تعديلًا
get_projectنظرة سريعة على مشروع واحد: ما يفعله MonstarX، والمعاينة، والنشر، والأسرار الناقصة
prepare_uploadرابط رفع لمرة واحدة والأمر اللازم لإرسال المجلد الحالي، كمشروع جديد أو كإصدار جديد
import_from_githubاستيراد تطبيق من مستودع على GitHub
push_filesكتابة بضعة ملفات مباشرةً، للتعديلات الصغيرة أو للوكلاء الذين لا يملكون سطر أوامر
create_projectجعل MonstarX ينشئ تطبيقًا جديدًا من وصف أو صور أو مستندات
read_filesسرد ملفات المشروع أو قراءتها
download_projectرابط تنزيل لمرة واحدة والأمر اللازم لفك ضغط المشروع
send_messageطلب الإنشاء أو الإجابة أو التخطيط من وكيل الإنشاء في MonstarX، كأنك كتبت في مساحة العمل
get_messagesقراءة محادثة المشروع، مع خيار انتظار انتهاء MonstarX من الرد
stopإيقاف ما يشغّله MonstarX في مشروع
publish_projectنشر الإصدار الحالي على الإنترنت
set_secretsحفظ المفاتيح التي يقرؤها التطبيق، مشفّرة، في الخدمات السحابية ← الأسرار
get_logsحالة المعاينة ومخرجاتها، ويمكنها تشغيل معاينة متوقفة

كل أداة تعمل على المشاريع التي تملكها فقط. والأدوات التي تقرأ فقط موسومة بذلك، فيستطيع الوكلاء تشغيلها دون استئذان، أما النشر فيستأذنك دائمًا أولًا.

  • الرفع: حتى 100 MB لملف .tar.gz (وهو ما يُنشئه أمر الإرسال) أو 50 MB لملف .zip. وتُستبعد الملفات التي يزيد حجمها على 10 MB وتُدرج في قائمة.
  • push_files: 200 ملف، بحد 400 KB للملف و2 MB لكل استدعاء.
  • روابط الرفع والتنزيل تعمل مرة واحدة، لمدة 15 دقيقة.
  • الإرسال الذي سيحذف معظم المشروع (أي يترك أقل من ربع ملفاته) يُرفض، فهو في الغالب مجلد خاطئ.
  • يُرفض الإرسال أثناء إنشاء MonstarX في ذلك المشروع.
  • الحصة: طلب الإنشاء من MonstarX (send_message وcreate_project) يستهلك حصة خطتك. أما الإرسال والاستيراد والتنزيل والقراءة والنشر فلا تستهلكها.
  • مفاتيح API: حتى 20 مفتاحًا لكل حساب. ويبقى تسجيل الدخول عبر المتصفح صالحًا 90 يومًا من الاستخدام.

استكشاف الأخطاء وإصلاحها

Section titled “استكشاف الأخطاء وإصلاحها”
  • لا تظهر أدوات MonstarX. يحمّل معظم الوكلاء الخوادم عند بدء الجلسة، فابدأ جلسة جديدة. وفي Claude Code، يوضح الأمر /mcp ما إذا كان MonstarX متصلًا.
  • رسالة “Sign in” أو خطأ عدم التفويض. انتهت صلاحية تسجيل الدخول أو أُبطل المفتاح. سجّل الدخول مجددًا (/mcp في Claude Code، أو codex mcp login monstarx) أو أنشئ مفتاحًا جديدًا.
  • لا يستطيع Codex الرفع. بيئته المعزولة تحجب الشبكة: وافق على الأمر، أو اسمح بالوصول إلى الشبكة.
  • “This upload has 3 files and the project has 214”. شُغّل الأمر في المجلد الخطأ. شغّله في المجلد الذي يوجد فيه package.json.
  • “The files in MonstarX changed since your copy was taken”. أنشأ أحدهم شيئًا في MonstarX بعد آخر إرسال لك. اطلب من وكيلك التنزيل والدمج والإرسال مجددًا.
  • لا يُعثر على مستودع GitHub خاص. اربط GitHub في MonstarX أولًا. راجع GitHub.
  • لا يعمل التطبيق. اطلب من وكيلك فحص السجلات، ويمكن ضبط أي مفتاح ناقص بالأداة set_secrets.

افتح الإعداداتAPI & MCP وانقر على قطع الاتصال بجوار الوكيل تحت الوكلاء المرتبطون، فيُسجَّل خروجه فورًا. أما الوكيل الذي يستخدم مفتاحًا فيتوقف عندما تنقر على إبطال بجوار ذلك المفتاح. راجع API & MCP.

هل أحتاج إلى مفتاح API؟

عادةً لا. يسجّل معظم الوكلاء الدخول عبر متصفحك: تسجّل الدخول إلى MonstarX وتضغط السماح. أما المفاتيح فهي للوكلاء والسكربتات وأنظمة CI التي لا تستطيع فتح متصفح.

هل ستُرفع ملفات .env الخاصة بي؟

لا. يستبعدها أمر الإرسال، وإذا وصل أحدها رغم ذلك فلا يحفظه MonstarX. احفظ المفاتيح في الخدمات السحابية ← الأسرار، أو اطلب من وكيلك استخدام set_secrets.

هل يمكنني مواصلة الإنشاء في وكيلي وفي MonstarX معًا؟

نعم. أرسل من وكيلك، وأنشئ في MonstarX، ثم اطلب من وكيلك جلب أحدث إصدار. ويمنع فحص المراجعة أيًّا من الجانبين من الكتابة فوق عمل الآخر.

ما التطبيقات التي تعمل على MonstarX؟

تطبيقات MonstarX وتطبيقات Vite (React وVue وSvelte، أي كل تصدير من Lovable وBolt وv0) تعمل وتُنشر هنا. أما Next.js وRemix وAstro وNuxt وSvelteKit فتعمل في المعاينة لكنها تُنشر على استضافتها الخاصة. ويمكن إعادة إنشاء غيرها تطبيقَ ويب.

هل هذا هو نفسه موصلات MCP؟

لا، إنه الاتجاه المعاكس. هنا يستخدم وكيلك MonstarX. أما موصلات MCP فتتيح لـ MonstarX استخدام خوادم MCP أخرى.