הוספת 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 ב־TUI של 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 מציינת שנוצר פתרון; בדקו בנפרד את תשובת היעד כדי לקבוע אם הוא קיבל את בקשת היישום.