MCP ile yapay zekâ ajanınıza CAPTCHA çözümü ekleyin

Resmî @solvethree/sdk indirme paketi, solvethree-mcp yürütülebilir dosyasını içerir. Aşağıdaki yapılandırmalar, bunu verilen paket URL'sinden çalıştırmak için npx kullanır. Girmeniz gereken barındırılan bir MCP uç noktası yoktur.

• MCP istemcinizin çalıştığı ortamda npx komutunun kullanılabilir olmasını sağlayın.
• İstemci ortamında SOLVETHREE_API_KEY değişkenini çalışma alanınızın API anahtarına ayarlayın. Bunu tarayıcı koduna veya istemlere dahil etmeyin.
• Aynı ortamda SOLVETHREE_PROXY değişkenini ayarlayın. reCAPTCHA aracı, kullandığı tek proxy'yi araç isteğinden değil, bu değişkenden okur.

JSON MCP yapılandırmasını kabul eden bir istemci için şu sunucu girdisini ekleyin:

{
  "mcpServers": {
    "solvethree": {
      "command": "npx",
      "args": [
        "--yes",
        "--package=https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz",
        "solvethree-mcp"
      ]
    }
  }
}

Codex için bunun yerine şu TOML yapılandırmasını kullanın. env_vars girdisi, iki değişkeni istemci ortamından aktarır; değerlerini ayarlamaz.

[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 ortam değişkenleri kullanılabilir durumdayken istemciyi başlatın veya yeniden yükleyin. solvethree_capabilities, solvethree_create_recaptcha, solvethree_create_kasada, solvethree_create_tmpt ve solvethree_get_task araçlarını kullanıma sunduğunu kontrol edin.

Bir reCAPTCHA görevi oluşturmadan önce hedef site profilini yapılandırın ve çalışma alanınız için etkin olduğundan emin olun. MCP üzerinden ana makine adı ve eylem göndermek bu profili oluşturmaz.

Kullanılabilir yetenekleri incelemek için solvethree_capabilities kullanın. reCAPTCHA v3 Enterprise için şu istekle solvethree_create_recaptcha çağrısı yapın:

{
  "site": "accounts.example.com",
  "action": "login",
  "requestId": "agent-login-001",
  "waitMs": 0
}

accounts.example.com değerini hedef sitenizle, login değerini ise uygulamanızın ihtiyaç duyduğu eylemle değiştirin. Bu mantıksal görev için bir requestId seçin ve istekle birlikte saklayın. waitMs sıfıra ayarlandığında, bu çağrıda tamamlanmasını beklemek yerine sonucu ayrı olarak alın.

Temeldeki görev API'sinde bu alan isteğe bağlı olsa da her MCP oluşturma çağrısı bir requestId gerektirir. 1–64 ASCII harfi, rakam, alt çizgi veya kısa çizgi kullanın.

1. 1.

   Döndürülen görev kimliğini saklayın

   Görev oluşturmak, sonucu almak değildir. Ajanın aynı görevi alabilmesi için görev kimliğini kaydedin.

2. 2.

   solvethree_get_task çağrısı yapın

   Oluşturma çağrısının döndürdüğü görev kimliğini kullanın. Durum pending veya solving ise görevi daha sonra yeniden alın. Bu durumların hiçbiri kullanılabilir bir çözüm içermez.

3. 3.

   Son durumu işleyin

   ready durumunda çözümü tarayıcı veya uygulama entegrasyonunuza aktarın. failed durumunda errorCode ve error alanlarını inceleyin ve o görevi yoklamayı bırakın.

reCAPTCHA için solution.token değerini tarayıcınız veya uygulama isteğiniz üzerinden gönderin. İsteğin User-Agent ve sec-ch-ua başlıklarını döndürülen userAgent ve secChUa değerlerinden ayarlayın ve SOLVETHREE_PROXY içinde yapılandırılan proxy'yi yeniden kullanın. Sağlayıcınız çıkışları döndürüyorsa bu proxy oturumunu sabit tutun.

Kasada üstbilgiler, Ticketmaster TMPT ise ham bir çerez değeri döndürür. İstediğiniz göreve ait çıktıyı uygulayın; bu sonuçlar birbirinin yerine kullanılamaz.

MCP sunucusu tarayıcıyı kontrol etmez veya formları doldurmaz. Çalıştığı ana uygulama özel çözüm verilerini alır, gönderimi ise sizin uygulamanız yapar. Hedefin yanıtını ayrıca kontrol edin: hazır durumu, solvethree'nin bir çözüm ürettiği anlamına gelir; hedefin bunu kabul ettiği anlamına gelmez.

Bağlantı zaman aşımı, görev oluşturmanın başarısız olduğunu kanıtlamaz. Bir görev kimliği aldıysanız görevi sorgulayın. Aksi takdirde mevcut görevi kurtarmak için aynı oluşturma isteğini aynı requestId ve değiştirilmemiş görev girdileriyle tekrarlayın. Sırf yanıt kayboldu diye yeni bir kimlik üretmeyin.

Bir istek kimliğini farklı görev girdileriyle yeniden kullanmak çakışmaya yol açar. Görevin kendisi başarısız olduysa neyi değiştireceğinize karar vermeden önce hatasını okuyun; geçersiz girdileri körü körüne yeniden göndermek onları düzeltmez. İstek hataları ile görev başarısızlıkları arasındaki fark için CAPTCHA API hataları sayfasına bakın.