Başlatılamayan veya görev çözemeyen bir MCP sunucusunu düzeltin

Sağlanan başlatıcıyı MCP ana uygulamanızın çalıştığı makinede bir terminalde çalıştırın. Sorunu kontrollü biçimde yeniden oluşturmak için Node.js 22 ve onunla birlikte gelen npx aracını kullanın; daha eski, ayrıca kurulmuş bir başlatıcının kullanılmadığını kontrol edin.

node --version
npx --yes --package=https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz solvethree-mcp
# The process waits for JSON-RPC on stdin. Silence is not a failed startup.
# Use the MCP host to initialize and list tools. Press Ctrl-C to stop this check.
# Never paste an API key or proxy password into troubleshooting logs.

Hiçbir şey yazdırmadan açık kalan bir süreç mutlaka takılmış değildir. Bu, yerel bir stdio sunucusudur: stdin üzerinden MCP JSON-RPC mesajlarını bekler. Bağlantıyı başlatmak ve araçları listelemek için MCP ana uygulamanızı kullanın; yürütülebilir dosyayı tek başına çalıştırmak bu el sıkışmasını gerçekleştirmez.

Süreç sonlanırsa önce başlatma hatasını okuyun. Yürütülebilir dosya bulunamadı hatası, kuruluma veya PATH değişkenine işaret eder; paket indirme hatası ise görev çözülmeden önce gerçekleşir. Bunların hiçbiri hatalı API anahtarı, proxy veya site profili olduğuna kanıt değildir.

solvethree'yi uzak bir HTTP uç noktası olarak değil, yerel bir stdio sunucusu olarak kaydedin. Ana uygulama, başlatıcı örneğinde gösterilen argümanlarla npx çalıştırmalıdır. Barındırılan bir MCP uç noktası yoktur.

Ana uygulama npx'i bulamıyor.

Ana uygulamanın PATH değerini terminalinizin PATH değeriyle karşılaştırın. Bir masaüstü uygulaması kabuk yapılandırmanızı devralmayabilir.

Şunu deneyin: npx'in bulunduğu dizini ana uygulamanın erişimine açın veya yerel olarak çalışan aynı yürütülebilir dosyanın mutlak yolunu yapılandırın.

Ana uygulama farklı bir Node.js veya npx sürümü çalıştırıyor.

Yalnızca terminalinizin hangi sürümleri kullandığını değil, ana uygulamanın hangi yürütülebilir dosyaları bulduğunu kontrol edin.

Şunu deneyin: Ana uygulamayı test edilmiş kuruluma yönlendirin. Ortamını değiştirdikten sonra ana uygulamayı yeniden başlatın.

Başlatma sırasında hatalı biçimlendirilmiş JSON veya beklenmeyen çıktı bildiriliyor.

stdout'a yazılan kabuk karşılama metinlerini, sarmalayıcı mesajlarını veya hata ayıklama çıktılarını arayın.

Şunu deneyin: stdout'u yalnızca MCP JSON-RPC için kullanın. Tanılama çıktısını stderr'e gönderin; böylece ana uygulama bunu protokol trafiği olarak değerlendirmeden toplayabilir.

Ana uygulama başlatma sırasında beklemeyi bırakıyor.

Başlatma günlüğünü inceleyin ve yavaş başlatılan bir süreç ile zaten sonlanmış bir süreci ayırt edin.

Şunu deneyin: Codex tarzı yapılandırma için belgelenmiş startup_timeout_sec değeri olan 60'ı kullanın. Daha uzun beklemek, eksik bir yürütülebilir dosyayı veya açıkça bildirilen bir başlatma hatasını düzeltmez.

Ana uygulama bir solvethree aracının kayıtlı olmadığını söylüyor.

Sunucunun başlatıldığını doğrulayın ve keşif sonucunda döndürülen araçları inceleyin.

Şunu deneyin: Sunucu kaydını düzeltin veya yeniden bağlanıp araçları tekrar keşfedin. Eksik bir araç, API kimlik doğrulama hatası veya başarısız bir çözüm değildir.

Sunucu solvethree_capabilities, solvethree_create_recaptcha, solvethree_create_kasada, solvethree_create_tmpt ve solvethree_get_task araçlarını sunar. Keşif başarılı olduğu hâlde ana uygulama bu adlardan birini çağıramıyorsa görev istekleri göndermeden önce bu uyumsuzluğu giderin.

1. 1.

   Ana uygulama sürecinin ortamını kontrol edin

   SOLVETHREE_API_KEY ve SOLVETHREE_PROXY değerlerini ana makinenin ortamı üzerinden sağlayın. Ayrı bir terminalde dışa aktarılan bir değişken, ana makinenin onu okuyabildiğini göstermez. Codex tarzı yapılandırmada env_vars her iki adı da içermelidir; bu aktarım listesi değişkenlerin değerlerini sağlamaz. Anahtarı veya proxy kimlik bilgilerini yazdırmadan mevcut olup olmadıklarını kontrol edin.

2. 2.

   Proxy'yi aracın gerçekten okuduğu yerde kontrol edin

   solvethree_create_recaptcha, kullandığı tek proxy'yi SOLVETHREE_PROXY üzerinden okur. Eksik bir ortam değerini bu araca proxy argümanı ekleyerek düzeltmeye çalışmayın. Proxy URL'si HTTP veya HTTPS kullanmalı; yol, sorgu veya fragment içermemelidir.

3. 3.

   reCAPTCHA site profilini kontrol edin

   API anahtarının tanımladığı çalışma alanında, istenen site ve reCAPTCHA türü için etkin bir profil bulunmalıdır. Yakalama eylemini de kontrol edin: genel bir ana makine adı profili her eylemi çözmeyebilir. Bir görevde site ve action sağlamak profil oluşturmaz. Bunu çözmek için konsoldaki Site profilleri sayfasını veya profil kurulum kılavuzunu kullanın.

4. 4.

   Aracın girdilerini kontrol edin

   solvethree_create_recaptcha için site değerini ana makine adı olarak sağlayın; action ve requestId değerlerini de belirtin. recaptchaType isteğe bağlıdır ve varsayılanı enterprise-v3'tür. site yerine sayfa URL'si kullanmayın veya API'nin diğer görev türlerini bu araca eklemeyin.

Yetenek keşfi, kimlik doğrulamayı veya proxy erişimini test etmez. Başarılı bir capabilities çağrısından sonra oluşan kimlik doğrulama veya istek doğrulama hatası, başlatıcıyla değil çözüm isteğiyle ilgilidir. Bir yanıtı başarılı görev verisi olarak değerlendirmeden önce başarısız HTTP yanıtlarını ele alın.

Ana makinedeki zaman aşımı bir görev durumu değildir. Codex tarzı yapılandırmada tool_timeout_sec değeri 100 olarak kullanılır; ancak yanıtın kaybolması, görev oluşturmanın başarısız olduğunu yine de kanıtlamaz. Her oluşturma aracı requestId gerektirir ve en fazla bir görev oluşturur.

Bir görev kimliği aldıysanız o görevi alın. Aksi takdirde mevcut göreve yeniden ulaşmak için aynı oluşturma isteğini aynı requestId ile tekrarlayın. Sırf çağrı zaman aşımına uğradı diye yeni bir requestId üretmeyin. Bir kimliği değiştirilmiş görev girdileriyle yeniden kullanmak çakışmaya yol açar.

Görev hazır olduğunda çözümünü, döndürülen tarayıcı kimliği ve başarılı proxy ile gönderin. Web sitesi daha sonra isteği reddederse MCP'nin başlatılmasını değil, bu gönderimi inceleyin. Çözüm verilerini gizli tutun: MCP ana makinesi bu verileri alır.