solvethree MCP'yi Codex'e ekleyin

1. 1.

   Node.js 22 ve npx'i erişilebilir hâle getirin

   Codex'i çalıştıran süreç bunlara erişebilmelidir. Bunları Codex'in erişemediği ayrı bir ortama kurmak, sunucuyu başlatmasını sağlamaz.

2. 2.

   Ana sistemin ortam değişkenlerini ayarlayın

   SOLVETHREE_API_KEY değişkenini çalışma alanınızın API anahtarına, SOLVETHREE_PROXY değişkenini ise proxy URL'sine ayarlayın. Codex'i bu değişkenlere erişebilecek şekilde başlatın. IDE entegrasyonu için IDE sürecinin de bunları devraldığından emin olun. API anahtarını istemlere veya kaynak kontrolüne eklemeyin.

3. 3.

   reCAPTCHA site profilini etkinleştirin

   Site profilleri bölümünde HTTPS sayfa URL'sini ekleyin, reCAPTCHA türünü seçin ve yakalama eylemini sağlayın. Profil etkinleşene kadar bekleyin. İhtiyacınız olan ana makine adını, yakalama eylemini ve türü yapılandırın; bir görevin sitesi ve eylemi profil oluşturmaz. Bu ilk hedefinizse site profili kurulumuna bakın.

Codex CLI ve IDE, ~/.codex/config.toml dosyasını paylaşır. Güvenilir bir projenin .codex/config.toml dosyasını da kullanabilirsiniz. Şu sunucu kaydını ekleyin:

[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

Bu kayıt, resmi SDK'nın solvethree-mcp yürütülebilir dosyasını npx üzerinden çalıştırır. env_vars mevcut ana sistem değişkenlerini iletir; değerlerini atamaz. Bu yerel sunucu için girilecek barındırılan bir MCP uç noktası veya OAuth oturum açma işlemi yoktur.

startup_timeout_sec, sunucunun başlaması için 60 saniye tanır. tool_timeout_sec, bir araç çağrısı için 100 saniye tanır. Bu ayarların hiçbiri hedef web sitesinin bir çözümü kabul ettiği anlamına gelmez.

Yapılandırılmış sunucuyu incelemek için codex mcp list komutunu çalıştırın veya Codex TUI içinde /mcp bölümünü açın. Sunucu başlatılamıyorsa Codex'in npx dosyasını bulabildiğini ve her iki ortam değişkenini de devraldığını kontrol edin.

1. 1.

   Yetenekleri inceleyin

   Çözüm aracını seçmeden önce Codex'in solvethree_capabilities aracını çağırmasını sağlayın. reCAPTCHA için solvethree_create_recaptcha kullanın.

2. 2.

   reCAPTCHA girdilerini sağlayın

   site alanını ana makine adı olarak, action alanını ve bir requestId sağlayın. Araç, isteğe bağlı recaptchaType ve waitMs alanlarını da kabul eder; varsayılan tür enterprise-v3 değeridir. Kullandığı tek proxy'yi SOLVETHREE_PROXY değişkeninden okur; bu nedenle bunu çağrı başına bir proxy ayarı olarak değerlendirmeyin. reCAPTCHA isteğine type veya url alanları eklemeyin.

3. 3.

   Görev kimliğini saklayın ve durumunu kontrol edin

   Her oluşturma çağrısı en fazla bir görev oluşturur. Döndürülen kimliği kullanarak bu görevi solvethree_get_task ile alın. Durumu pending veya solving olduğu sürece kontrol etmeye devam edin. Yalnızca ready durumu kullanılabilir bir çözüm içerir. Durum failed olursa sorgulamayı durdurun ve neyi değiştireceğinize karar vermeden önce errorCode ve error alanlarını inceleyin.

MCP sunucusu bir tarayıcıyı yönetmez, mevcut oturumunu incelemez veya form doldurmaz. Uygulamanızın hazır reCAPTCHA sonucunu alıp solution.token değerini amaçlanan hedefe göndermesi gerekir.

Döndürülen userAgent ve secChUa tarayıcı kimliğini, çözüm için kullanılan proxy ile birlikte kullanın. Tarayıcınız veya HTTP istemciniz farklı bir proxy ya da ilgisiz bir tarayıcı kimliği kullanıyorsa göndermeden önce bunu düzeltin. MCP sunucusunu eklemek bu ayarları sizin yerinize yapılandırmaz.

Codex, özel çözüm verilerini araç yanıtı üzerinden alır; bu nedenle bunları paylaşılan raporlara ve günlüklere dahil etmeyin. Bir görevin ready durumunda olması, bir çözüm üretildiği anlamına gelir; hedefin uygulama isteğini kabul edip etmediğini belirlemek için hedefin yanıtını ayrıca kontrol edin.