إضافة solvethree MCP إلى Claude Desktop

ثبّت Node.js 22 على الجهاز الذي يشغّل Claude Desktop. جهّز مفتاح API لمساحة عملك وعنوان URL لوكيل HTTP أو HTTPS. يستخدم خادم MCP وكيلًا واحدًا يُمرّر عبر SOLVETHREE_PROXY؛ ولا تقبل أداة reCAPTCHA وسيطة للوكيل.

بالنسبة إلى reCAPTCHA، أنشئ أولًا ملف تعريف نشطًا في ملفات تعريف المواقع. أعِدّ اسم مضيف الهدف وإجراء الالتقاط ونوع reCAPTCHA التي تحتاج إليها. لا يؤدي تزويد Claude باسم مضيف وإجراء إلى إنشاء ملف التعريف هذا. راجع إعداد ملف تعريف الموقع إذا لم يكن نشطًا بعد.

1. 1.

   افتح ملف الإعدادات المحلي

   على macOS، استخدم ~/Library/Application Support/Claude/claude_desktop_config.json. وعلى Windows، استخدم %APPDATA%/Claude/claude_desktop_config.json.

2. 2.

   أضف خادم solvethree

   استخدم الإعدادات أدناه. إذا كان الملف يحتوي بالفعل على mcpServers، فأضف إدخال solvethree داخله بدلًا من استبدال خوادمك الأخرى. استبدل العنصرين النائبين لمتغيرَي البيئة دون كشف قيمتيهما.

3. 3.

   أعِد تشغيل Claude Desktop

   أعِد التشغيل بعد الحفظ ليشغّل التطبيق المضيف الخادم بالإعدادات الجديدة.

{
  "mcpServers": {
    "solvethree": {
      "command": "npx",
      "args": [
        "--yes",
        "--package=https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz",
        "solvethree-mcp"
      ],
      "env": {
        "SOLVETHREE_API_KEY": "REPLACE_WITH_YOUR_WORKSPACE_KEY",
        "SOLVETHREE_PROXY": "http://USER:PASSWORD@YOUR_PROXY:PORT"
      }
    }
  }
}

تُنزّل args أرشيف SDK الرسمي وتشغّل الملف التنفيذي solvethree-mcp كخادم stdio محلي. لا توجد نقطة نهاية MCP مستضافة لإدخالها.

ابدأ بـ solvethree_capabilities. استخدم solvethree_get_task لاسترجاع مهمة موجودة. لا تُعدّ أي من العمليتين طلبًا لإنشاء عملية حل جديدة.

• تقبل solvethree_create_recaptcha الحقل site بوصفه اسم مضيف، وaction وrequestId، مع الحقلين الاختياريين recaptchaType وwaitMs. النوع الافتراضي هو enterprise-v3؛ وتُقبل v3 أيضًا.
• تنشئ solvethree_create_kasada مهمة Kasada. يدعم Kasada المستقل حاليًا أهداف HTTPS على www.ticketmaster.com، وليس أي مواقع أخرى.
• تنشئ solvethree_create_tmpt مهمة TMPT. تستخدم مهام الفعاليات عنوان URL للفعالية؛ وتستخدم مهام تسجيل الدخول عنوان URL لمدخل تسجيل الدخول.

امنح Claude إذنًا صريحًا لإنشاء مهمة واحدة للهدف والإجراء المتفق عليهما. اشترط موافقة جديدة قبل أن يبدأ مهمة مدفوعة أخرى، بما في ذلك مهمة بديلة بعد الفشل أو رفض الهدف. يجب ألا يُعامل الإذن بفحص مهمة أو الاستعلام الدوري عنها على أنه إذن بإنشاء مهمة أخرى.

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

في حالتي pending أو solving، واصل استرجاع المهمة الحالية. وحدها حالة ready تتضمن حلًا قابلًا للاستخدام. عند failed، أوقف الاستعلام الدوري وافحص errorCode وerror؛ تُرد تكلفة عمليات الحل الفاشلة. لا تُعد إرسال المدخلات غير الصالحة نفسها تلقائيًا.

يتلقى Claude بيانات الحل الخاصة عبر مضيف MCP. اجعل تطبيقك يستخدم النتيجة للهدف المخصص لها، مع الوكيل الذي نجحت معه عملية الحل وقيمتي userAgent وsecChUa المُعادتين. لا تنفّذ الحل عبر الوكيل المُعدّ ثم ترسل النتيجة عبر عنوان IP مختلف أو بهوية متصفح غير مرتبطة بها.

تعني المهمة بحالة ready أنه تم إنشاء حل، لا أن الموقع قبل طلبك اللاحق. إذا رفضه الهدف، فافحص الرمز أو ملف تعريف الارتباط أو الترويسات الصادرة، والوكيل، وهوية المتصفح، وعنوان URL للهدف قبل السماح بعملية حل أخرى.