إضافة solvethree MCP إلى Codex

1. 1.

   أتح Node.js 22 وnpx

   يجب أن يكونا متاحين للعملية التي تشغّل Codex. تثبيتهما في بيئة منفصلة لا يستطيع Codex الوصول إليها لن يمكّنه من تشغيل الخادم.

2. 2.

   اضبط متغيرات بيئة المضيف

   اضبط SOLVETHREE_API_KEY على مفتاح API لمساحة عملك، وSOLVETHREE_PROXY على عنوان URL للوكيل. شغّل Codex مع إتاحة هذين المتغيرين. بالنسبة إلى تكامل IDE، تأكد من أن عملية IDE ترثهما أيضًا. لا تضع مفتاح API في المطالبات أو في نظام التحكم بالإصدارات.

3. 3.

   فعّل ملف تعريف موقع reCAPTCHA

   في ملفات تعريف المواقع، أضف عنوان URL لصفحة HTTPS، وحدد نوع reCAPTCHA، وأدخل إجراء الالتقاط. انتظر حتى يصبح ملف التعريف نشطًا. أعدّ اسم المضيف وإجراء الالتقاط والنوع الذي تحتاجه؛ فموقع المهمة وإجراؤها لا ينشئان ملف تعريف. راجع إعداد ملف تعريف الموقع إذا كان هذا هدفك الأول.

تستخدم واجهتا CLI وIDE في Codex الملف نفسه ~/.codex/config.toml. يمكنك أيضًا استخدام .codex/config.toml لمشروع موثوق. أضف إدخال الخادم التالي:

[mcp_servers.solvethree]
command = "npx"
args = ["--yes", "--package=https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz", "solvethree-mcp"]
env_vars = ["SOLVETHREE_API_KEY", "SOLVETHREE_PROXY"]
startup_timeout_sec = 60
tool_timeout_sec = 100

يشغّل الإدخال الملف التنفيذي solvethree-mcp من SDK الرسمية عبر npx. يمرّر env_vars متغيرات المضيف الموجودة؛ ولا يعيّن قيمها. لا توجد نقطة نهاية MCP مستضافة لإدخالها، ولا تسجيل دخول عبر OAuth لهذا الخادم المحلي.

يتيح startup_timeout_sec مهلة قدرها 60 ثانية لبدء تشغيل الخادم. ويتيح tool_timeout_sec مهلة قدرها 100 ثانية لاستدعاء الأداة. لا يعني أيٌّ من الإعدادين أن الموقع المستهدف قد قبل حلًا.

شغّل codex mcp list، أو افتح /mcp في واجهة Codex النصية، لفحص الخادم المُهيّأ. إذا تعذّر تشغيله، فتحقّق من أن Codex يستطيع العثور على npx وأنه ورث كلا متغيرَي البيئة.

1. 1.

   افحص الإمكانات

   اطلب من Codex استدعاء solvethree_capabilities قبل اختيار أداة الحل. بالنسبة إلى reCAPTCHA، استخدم solvethree_create_recaptcha.

2. 2.

   وفّر مدخلات reCAPTCHA

   وفّر site بوصفه اسم المضيف، وaction، وrequestId. تقبل الأداة أيضًا المعاملَين الاختياريَين recaptchaType وwaitMs؛ والنوع الافتراضي هو enterprise-v3. تقرأ الأداة إعداد الوكيل الوحيد من SOLVETHREE_PROXY، لذا لا تتعامل معه بوصفه إعداد وكيل خاصًا بكل استدعاء. لا تضف الحقلَين type أو url إلى طلب reCAPTCHA.

3. 3.

   الاحتفاظ بمعرّف المهمة والتحقق من حالتها

   ينشئ كل استدعاء إنشاء مهمة واحدة على الأكثر. استرجع تلك المهمة باستخدام solvethree_get_task ومعرّفها المُعاد. واصل التحقّق ما دامت حالتها pending أو solving. وحدها الحالة ready تحتوي على حل قابل للاستخدام. إذا أصبحت failed، فتوقّف عن الاستقصاء وافحص errorCode وerror قبل تحديد ما يجب تغييره.

لا يتحكّم خادم MCP في متصفح، ولا يفحص جلسته الحالية، ولا يملأ النماذج. يجب أن يأخذ تطبيقك نتيجة reCAPTCHA الجاهزة ويرسل solution.token إلى الهدف المقصود.

استخدم هوية المتصفح المُعادة في userAgent وsecChUa مع الوكيل نفسه المستخدم للحل. إذا كان متصفحك أو عميل HTTP يستخدم وكيلًا مختلفًا أو هوية متصفح غير مرتبطة، فصحّح ذلك قبل الإرسال. لا تؤدي إضافة خادم MCP إلى تهيئة هذه الإعدادات نيابةً عنك.

يتلقى Codex بيانات الحل الخاصة عبر استجابة الأداة، لذا أبقِها خارج التقارير والسجلات المشتركة. تعني حالة المهمة ready أنه تم توليد حل؛ تحقّق من استجابة الهدف بشكل منفصل لتحديد ما إذا كان قد قبل طلب التطبيق.