Cara Mengatur Alat MCP CAPTCHA Solver di Qwen Code

TL;DR

• Qwen Code dapat terhubung ke layanan MCP resmi CapSolver sebagai proses lokal stdio.
• Tempatkan server di .qwen/settings.json proyek, menggunakan executable Python dari environment tempat paket dipasang.
• Tinjau dan setujui server proyek, lalu jalankan qwen mcp list untuk memeriksa koneksi.
• Server yang terhubung membuat tool tersedia; ini bukan bukti bahwa permintaan CAPTCHA berbayar atau pengiriman browser telah berhasil.
• Gunakan tool token untuk parameter CAPTCHA eksplisit dan tool browser untuk halaman yang dikelola layanan tersebut. Server MCP yang terpisah tidak otomatis berbagi tab browser.

Qwen Code adalah agen pengkodean open‑source yang berjalan di terminal. Pengembang dapat menggunakannya untuk mengerjakan kode aplikasi dan memanggil tool yang terhubung. Ketika alur kerja browser yang diotorisasi mencapai CAPTCHA, model pengkodean saja tidak menyediakan solusi CAPTCHA. Sebuah solver membutuhkan input tantangan yang relevan dan tempat yang jelas untuk mengembalikan hasilnya.

CapSolver mengekspose kemampuan tersebut melalui layanan MCP resminya. Panduan ini menghubungkan layanan tersebut ke Qwen Code, memeriksa bahwa klien dapat menjangkaunya, dan menjelaskan cara memilih tool yang sesuai. Contoh koneksi ini tidak mengharuskan model untuk mengimprovisasi kode Python atau mengarang payload API.

Apa yang disediakan integrasi Qwen Code

Integrasi ini memberi Qwen Code akses ke layanan terpisah yang mengimplementasikan tool terkait CAPTCHA. Qwen Code tetap menjadi klien yang menemukan tool dan meminta aksi; layanan menangani operasi solver yang terdokumentasi.

Proyek resmi Qwen Code menggambarkan produknya sebagai agen pengkodean terminal. MCP memperluas lingkungan itu dengan kapabilitas yang disuplai oleh server. Memasang server CAPTCHA tidak mengubah setiap tugas pengkodean menjadi tugas browser, dan pengeditan kode biasa tidak memerlukan solver.

Kasus yang berguna adalah pengembang yang memeriksa alur kerja browser yang diizinkan dan langkah berikutnya terblokir oleh CAPTCHA. Pengembang dapat memeriksa tantangan, memilih operasi yang didukung, dan menjaga hasilnya tetap terkait dengan halaman itu. Ini lebih sempit daripada meminta agen membuat seluruh situs web dapat diakses.

Jika MCP masih baru dalam alur kerja Anda, perbedaan antara klien dan panggilan API penting: deskripsi tool mengiklankan sebuah operasi, sementara pemanggilan aktual menjalankannya. Status koneksi menggambarkan ketersediaan, bukan keberhasilan eksekusi setiap operasi yang diiklankan.

Siapkan klien dan environment Python

Siapkan Qwen Code dan environment Python yang berisi server resmi sebelum mengedit konfigurasi proyek.

Koneksi yang dijelaskan di sini menggunakan Qwen Code 0.26.1 dengan capsolver-core 0.1.1 dan capsolver-mcp 0.1.3. Paket Qwen Code memerlukan Node.js 22 atau lebih baru. Ikuti instruksi instalasi resminya jika perintah qwen belum tersedia.

Pasang paket solver di environment Python yang Anda maksudkan akan diluncurkan oleh Qwen Code:

python -m pip install capsolver-core==0.1.1 capsolver-mcp==0.1.3

Panduan instalasi MCP resmi juga menjelaskan browser extra dan instalasi Chromium. Dependensi tersebut diperlukan untuk deteksi berbasis browser dan penyelesaian halaman. Dependensi tersebut terpisah dari proses membangun koneksi stdio.

Kunci API CapSolver yang valid dan saldo akun yang cukup adalah prasyarat untuk solving berbayar. Akses model di Qwen Code adalah prasyarat terpisah lainnya untuk penggunaan tool secara percakapan. Pemeriksaan koneksi di bawah ini hanya menguji startup server dan koneksi; tidak mengirimkan solve berbayar atau menjalankan tugas yang digerakkan model.

Simpan kunci akun di environment yang digunakan untuk memulai Qwen Code. Jangan tempelkan nilai asli ke konfigurasi proyek yang dilacak atau ke artikel, issue, screenshot, atau transkrip yang dibagikan.

Konfigurasikan server di proyek

Tambahkan entri capsolver ke objek mcpServers di .qwen/settings.json pada root proyek.

Qwen Code mendokumentasikan konfigurasi proyek dan substitusi variabel environment di referensi setup MCP. Gabungkan entri ini dengan pengaturan yang sudah ada alih‑alih mengganti server lain atau preferensi proyek.

{
  "mcpServers": {
    "capsolver": {
      "command": "/absolute/path/to/venv/bin/python",
      "args": ["-m", "capsolver_mcp"],
      "env": {
        "CAPSOLVER_API_KEY": "${CAPSOLVER_API_KEY}"
      },
      "trust": false
    }
  }
}

Ganti path executable dengan path Python aktual di dalam environment terpasang Anda. Path absolut mencegah terminal, editor, atau peluncur layanan menemukan instalasi Python lain melalui search path‑nya sendiri. Pertahankan path virtual environment itu sendiri; menyelesaikan symlink ke interpreter dasar dapat memilih interpreter tanpa paket yang terpasang.

Placeholder adalah referensi variabel environment, bukan kunci API. Variabel tersebut harus ada di environment proses ketika Qwen Code dimulai. Kunci yang disetel di satu terminal tidak otomatis tersedia untuk klien yang dimulai di tempat lain.

Konfigurasi ini menggunakan stdio: Qwen Code memulai modul Python sebagai proses lokal. Ia tidak memerlukan endpoint HTTP publik, port yang diekspos, atau kredensial MCP CMS yang digunakan oleh alur kerja publikasi konten.

Tukarkan Kode Bonus CapSolver Anda

Tingkatkan anggaran automasi Anda secara instan!
Gunakan kode bonus CAP26 saat mengisi saldo akun CapSolver Anda untuk mendapatkan bonus 5% tambahan pada setiap pengisian — tanpa batas.
Tukarkan sekarang di Dashboard CapSolver

Setujui dan verifikasi koneksi nyata

Setujui server proyek yang telah ditinjau, lalu periksa koneksinya dari direktori proyek yang sama.

qwen mcp approve capsolver
qwen mcp list

Untuk versi klien yang diuji, entri proyek yang belum disetujui muncul sebagai pending approval. Setelah disetujui, server dapat terhubung. Sinyal yang diharapkan berguna adalah entri capsolver berstatus connected; baris tersebut juga mengidentifikasi executable dan transport.

Approval dan trust memiliki tujuan berbeda. Menyetujui server yang telah ditinjau memungkinkan server tersebut terhubung. Menjaga trust tetap false mempertahankan perilaku konfirmasi panggilan tool yang normal. Jangan ubah pengaturan itu hanya untuk menyembunyikan masalah setup.

Jika koneksi gagal, periksa path executable terlebih dahulu, lalu pastikan environment Python yang sama dapat meng‑import paket terpasang. Periksa bahwa konfigurasi berada di proyek yang benar‑benar Anda buka. Referensi pengaturan Qwen menjelaskan sumber konfigurasi; entri duplikat di tempat lain dapat mempersulit troubleshooting.

Koneksi yang berhasil tanpa kunci solving tetap tidak membuktikan akses akun. Pemeriksaan koneksi dan operasi yang menimbulkan biaya menguji bagian sistem yang berbeda.

Pilih tool yang sesuai dengan langkah CAPTCHA

Pilih tool sesuai dengan informasi dan status browser yang sudah tersedia dalam alur kerja Anda.

Layanan resmi mengekspose get_supported_captchas, get_balance, detect_captchas, solve_captcha, dan solve_on_page. Mulailah dengan daftar tipe yang didukung saat Anda perlu mengonfirmasi nama kapabilitas layanan terinstal. Periksa saldo secara terpisah ketika mendiagnosis kesiapan akun.

Gunakan solve_captcha ketika alur kerja sudah memiliki tipe CAPTCHA dan parameter situs yang telah didokumentasikan. Hasilnya tetap perlu dikonsumsi oleh aplikasi yang memintanya. Untuk tugas berbasis token, menerima token tidak otomatis mengirim form atau membuktikan bahwa situs web menerima permintaan tersebut.

Gunakan tool browser hanya dengan setup browser yang telah didokumentasikan. detect_captchas memeriksa URL halaman. solve_on_page menggabungkan deteksi, solving, dan isi‑balik di dalam alur kerja browser layanan tersebut. Nama‑nama ini tidak menjanjikan akses ke tab yang dimiliki server MCP lain.

Untuk pemeriksaan percakapan awal, mintalah Qwen Code untuk mencantumkan tipe CAPTCHA yang didukung melalui server yang dikonfigurasi. Untuk tugas halaman yang diotorisasi, sebutkan halaman dan operasi yang diizinkan secara tepat, dan tinjau tool dan argumen yang dipilih sebelum eksekusi. Hindari instruksi terbuka untuk terus mencoba hingga situs mengizinkan akses.

Jaga handoff browser tetap eksplisit

Handoff browser harus mempertahankan konteks yang dibutuhkan oleh tugas. URL saja mungkin tidak dapat mereproduksi halaman yang sebelumnya dicapai melalui interaksi sebelumnya.

Jika automasi browser yang ada mengontrol halaman hidup, putuskan apakah Anda memerlukan token untuk alur kerja itu atau integrasi SDK dengan halaman tersebut. Jangan berasumsi bahwa menambah dua server MCP akan menggabungkan sesi, cookie, tab, atau state JavaScript mereka.

Panduan integrasi Core SDK menjelaskan integrasi browser langsung. Itu mungkin jalur yang tepat ketika aplikasi perlu mempertahankan objek halaman yang ada. Penjelasan token versus cookie juga membantu membedakan artefak yang dikembalikan solver dari state yang lebih luas dari sesi browser.

Sebelum menyatakan alur kerja selesai, periksa hasil aplikasi. Apakah form yang diharapkan diterima? Apakah halaman yang diizinkan berlanjut ke state yang dimaksud? Server yang terhubung, widget yang terdeteksi, dan permintaan aplikasi yang diterima adalah tonggak yang berbeda.

Bangun Alur Kerja Automasi yang Andal dengan CapSolver

Hubungkan layanan resmi, periksa tool yang tersedia, dan mulailah dengan satu operasi terbatas yang sesuai dengan CAPTCHA di alur kerja Anda. CapSolver dapat menyediakan langkah solving yang terdokumentasi sementara Qwen Code tetap bertanggung jawab untuk memilih dan memanggil tool dalam tugas yang Anda setujui.

FAQ

T: Apakah Qwen Code menyertakan solver CAPTCHA secara default?

Tidak. Panduan ini menambahkan layanan MCP CapSolver resmi sebagai penyedia tool terpisah. Model Qwen Code dan akun solver adalah komponen yang terpisah.

T: Mengapa server ditampilkan sebagai pending approval?

Entri MCP proyek mungkin memerlukan persetujuan sebelum Qwen Code terhubung. Tinjau konfigurasi command dan environment‑nya, lalu gunakan perintah persetujuan yang didukung oleh versi klien yang Anda pasang.

T: Bisakah saya menguji koneksi tanpa membayar CAPTCHA?

Bisa. Koneksi server dapat diperiksa terpisah dari solving berbayar. Status connected tidak memverifikasi saldo akun Anda, eksekusi tugas berbayar, atau penerimaan solusi oleh situs web.

T: Apakah layanan menggunakan tab browser MCP saya yang lain?

Jangan berasumsi demikian. Server yang terpisah memiliki alur kerja browser terpisah kecuali ada integrasi terdokumentasi yang secara eksplisit menghubungkannya. Pilih mode token atau integrasi SDK langsung ketika Anda perlu mempertahankan halaman yang ada.

T: Mengapa tool browser tidak tersedia setelah instalasi?

Periksa browser extra dan prasyarat Chromium di panduan MCP resmi. Juga periksa filter tool sisi klien dan apakah entri server yang diharapkan berstatus connected.

T: Apakah setup ini dapat menangani setiap CAPTCHA di setiap halaman?

Tidak. Gunakan daftar tipe yang didukung dan referensi tugas terkini, dan batasi operasi pada halaman dan alur kerja yang boleh Anda automasi. Tool yang diiklankan bukan jaminan keberhasilan pada halaman sembarang.