Pemecah CAPTCHA Claude Code: CapSolver MCP Panduan Pengaturan

TL;DR

• Hubungkan Claude Code dengan paket resmi capsolver-mcp untuk mengekspos alat penyelesaian CAPTCHA yang didukung.
• Mulai dengan mendaftar jenis CAPTCHA yang didukung; koneksi alat yang berhasil tidak menjamin keberhasilan permintaan penyelesaian berbayar.
• Gunakan solve_captcha ketika Anda sudah memiliki jenis tantangan CAPTCHA yang didukung, URL halaman, dan sitekey.
• Alat halaman membuka sesi browser sendiri; mereka tidak secara otomatis melanjutkan tab browser Claude yang sudah ada.
• Token yang dikembalikan atau widget yang terisi tetap memerlukan pemeriksaan akhir dari aplikasi target.

Claude Code dapat membantu menulis atau memperbaiki tugas browser, tetapi memerlukan alat penyelesaian nyata ketika CAPTCHA yang didukung mengganggu operasi yang disetujui. Meminta model untuk "berusaha lebih keras" tidak menyediakan parameter situs, koneksi API, atau penanganan hasil yang dibutuhkan tantangan tersebut.

CapSolver mengekspos kemampuan ini melalui layanan MCP-nya. Panduan ini mencakup instalasi paket, koneksi ke Claude Code, pemeriksaan alat yang tersedia, dan pemilihan panggilan penyelesaian. Contoh-contoh ini berkaitan dengan halaman Anda sendiri atau tugas otomasi yang diizinkan. Mereka tidak mengotomasi pembuatan akun, pembelian, atau akses ke data terbatas.

Apa yang Bisa Dilakukan Claude Code dengan CapSolver MCP?

Claude Code dapat menemukan dan memanggil alat CapSolver MCP setelah Anda mengonfigurasi dan menyetujui server.

Layanan MCP resmi ini mengekspos lima alat:

Nama alat menggambarkan operasi yang berbeda. Query saldo tidak mengenali halaman, dan mendeteksi widget tidak menyelesaikan tantangan. Mulailah dengan operasi yang benar-benar Anda butuhkan.

Versi yang terpasang untuk panduan ini, capsolver-mcp 0.1.3, mendaftarkan reCaptchaV2, reCaptchaV3, dan cloudflare melalui alat jenis yang didukung. Dalam antarmuka ini, handler Cloudflare berkaitan dengan Turnstile. Jangan menginterpretasikan nama sebagai dukungan universal untuk setiap respons Cloudflare atau tantangan halaman penuh.

API REST menawarkan keluarga tugas lain, tetapi mereka tidak secara otomatis ditambahkan ke kumpulan alat MCP ini. Secara khusus, jangan mengirim tugas ImageToText ke solve_captcha hanya karena API CapSolver terpisah mendukung pengenalan gambar.

Instal Paket Resmi

Instal inti CapSolver, server MCP, dan dependensi browser di lingkungan Python yang akan dijalankan Claude Code.

Perintah berikut menetapkan versi inti dan MCP yang digunakan di sini:

python -m pip install capsolver-core==0.1.1 "capsolver-mcp[browser]==0.1.3"
python -m playwright install chromium

Instalasi mengikuti instruksi resmi CapSolver. Ekstra browser dan Chromium diperlukan untuk alat halaman. Panduan instalasi browser Playwright menjelaskan bahwa biner browser adalah dependensi terpisah dari paket Python.

Gunakan eksekusi Python dari lingkungan ini di langkah berikutnya. Jika Anda menginstal ke lingkungan virtual dan mengonfigurasi Python berbeda, klien mungkin melaporkan bahwa tidak dapat mengimpor capsolver_mcp meskipun instalasi berhasil di tempat lain.

Anda juga memerlukan Claude Code dan kunci akun CapSolver untuk penyelesaian nyata. Simpan kunci ini sebagai CAPSOLVER_API_KEY di lingkungan yang digunakan untuk memulai Claude Code. Jangan tempelkan ke prompt obrolan atau komit ke file proyek yang dibagikan.

Koneksi paket dan jalur deteksi lokal dapat diperiksa secara terpisah dari pengenalan berbayar. Panduan ini tidak menunjukkan penyelesaian berbayar langsung; langkah ini memerlukan akun Anda dan parameter saat ini dari target yang disetujui.

Tambahkan CapSolver ke Konfigurasi Proyek MCP

Tambahkan entri capsolver ke .mcp.json proyek, mengarah ke lingkungan Python di mana Anda menginstal paket.

Konfigurasi di bawah ini menggunakan pola peluncuran modul Python yang didokumentasikan CapSolver dan ekspansi variabel lingkungan Claude Code. Ganti jalur Python dengan jalur absolut nyata untuk lingkungan Anda:

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

Jika .mcp.json sudah berisi server lain, tambahkan entri ini di dalam objek mcpServers yang ada, bukan mengganti file. Referensi menjaga nilai kunci di luar file JSON, tetapi variabel tetap perlu tersedia saat Claude Code dimulai.

Dokumentasi konfigurasi MCP Claude Code menutupi cakupan proyek, ekspansi variabel lingkungan, dan persetujuan server. Mulai Claude Code dari proyek yang dimaksud, tinjau prompt persetujuan server proyek, dan setujui server ini hanya setelah memverifikasi perintah dan paket yang Anda instal.

Periksa konfigurasi dari direktori proyek tersebut:

claude mcp list

Di sesi Claude Code interaktif, gunakan /mcp untuk meninjau status server dan kontrol yang tersedia. Status yang menunggu persetujuan berarti server proyek masih memerlukan tinjauan Anda. Ini berbeda dari eksekusi yang hilang atau koneksi yang gagal.

Periksa Alat Sebelum Meminta Penyelesaian

Minta Claude Code untuk mendaftar jenis CAPTCHA yang didukung sebelum meminta penggunaan kredit akun.

Permintaan pertama yang sesuai adalah:

Gunakan alat CapSolver get_supported_captchas dan beri tahu saya jenis CAPTCHA apa yang saat ini didukung oleh server ini. Jangan ajukan tugas penyelesaian.

Ini memastikan klien dapat mengakses alat nyata dan memberi tahu cakupan sebenarnya dari server yang terinstal. Siklus hidup koneksi MCP ini memisahkan inisialisasi dari operasi selanjutnya; membangun koneksi hanya merupakan awal dari integrasi yang dapat digunakan.

Untuk pemeriksaan akun, Anda dapat meminta get_balance. Jaga respons tetap rahasia jika mengandung informasi akun. Kegagalan di sini menunjukkan akses akun atau komunikasi layanan dan harus diselesaikan sebelum mencoba penyelesaian berbayar.

Jangan menilai kesiapan dari pernyataan model bahwa "ia tahu CapSolver." Periksa hasil alat sebenarnya. Alat yang ditemukan, query akun yang berhasil, dan penyelesaian CAPTCHA yang selesai menetapkan fakta yang berbeda.

Klaim Kode Bonus CapSolver

Tingkatkan anggaran otomatisasi Anda secara instan!
Gunakan kode bonus CAP26 saat menambahkan dana ke akun CapSolver untuk mendapatkan bonus 5% tambahan pada setiap penyetoran — tanpa batas.
Klaim sekarang di Dashboard CapSolver Anda

Gunakan Mode Token untuk Parameter Tantangan yang Diketahui

Gunakan solve_captcha ketika alur browser atau aplikasi yang disetujui Anda sudah menyediakan jenis yang diperlukan, URL halaman, dan sitekey.

Misalnya, beri Claude Code instruksi terbatas seperti:

Gunakan solve_captcha CapSolver sekali untuk reCAPTCHA v2 di halaman uji saya yang disetujui. Gunakan URL halaman dan sitekey yang tepat yang saya berikan. Jika salah satu dari keduanya hilang, laporkan input yang hilang daripada menebak. Kembalikan status alat tanpa mencetak token penuh dalam ringkasan Anda.

Schema alat menggunakan captcha_type, website_url, dan website_key. Periksa schema yang ditemukan untuk parameter tambahan yang diperlukan oleh tantangan yang Anda tangani. Jangan menyalin nama tugas REST ke bidang tipe MCP: reCaptchaV2 adalah nilai MCP, sementara API REST memiliki nama tugas yang didokumentasikan sendiri.

Aplikasi Anda kemudian perlu mengonsumsi token yang dikembalikan melalui alur yang dimaksudkan target. Panggilan MCP sendiri tidak mengirim setiap formulir atau memverifikasi hasil bisnis. Untuk input reCAPTCHA spesifik halaman, konsultasikan dokumentasi tugas reCAPTCHA v2.

Jika parameter tidak diketahui, periksa halaman yang disetujui saat ini dengan alat browser yang sesuai. Sitekey yang diingat dari halaman lain bukan bukti untuk widget saat ini. Pertahankan penyelesaian terkait dengan operasi yang sedang diperbaiki.

Gunakan Alat Halaman dengan Batas Browser yang Sesuai

Alat halaman menerima URL dan beroperasi dalam sesi browser yang dibuat oleh layanan MCP.

Permintaan yang berguna untuk deteksi adalah:

Panggil detect_captchas CapSolver pada URL halaman yang disetujui ini dan laporkan jenis yang terdeteksi. Jangan selesaikan itu sekarang.

Ketika menyelesaikan halaman tersebut adalah operasi yang dimaksudkan, solve_on_page dapat melakukan urutan deteksi, penyelesaian, dan pengisian yang telah didokumentasikan. Tinjau tantangan yang teramati dan cakupan yang didukung sebelum meminta panggilan ini.

Batasan penting terlihat dalam implementasi MCP resmi: alat ini membuka browser untuk panggilan dan menutupnya setelahnya. Mereka tidak terhubung ke tab yang dimiliki oleh browser MCP lain atau secara otomatis mewarisi status loginnya.

Ini membuat halaman uji yang langsung dapat diakses menjadi titik awal yang lebih jelas daripada halaman yang hanya tersedia setelah beberapa langkah sesi pribadi. Jika tugas Anda perlu tetap pada halaman browser yang sudah Anda kendalikan, gunakan integrasi yang didukung yang beroperasi pada halaman yang ada. SDK Core CapSolver mendokumentasikan kemampuan adapter browser untuk kebutuhan integrasi yang berbeda.

Guia Penggunaan Komputer Claude membahas permukaan agen browser yang berdekatan. Penggunaan Komputer Claude dan pengaturan MCP Claude Code ini tidak boleh dianggap sebagai konfigurasi yang dapat dipertukarkan.

Perbaiki Kesalahan Pengaturan Sebelum Mengulang Panggilan CAPTCHA

Kebanyakan kegagalan pengaturan dapat dikurangi menjadi jalur eksekusi, lingkungan, instalasi browser, atau input tugas.

Jika perintah server tidak ditemukan, gunakan jalur Python absolut yang ditunjukkan di atas. Jika paket tidak dapat diimpor, pastikan lingkungan Python yang sama mengandung capsolver-mcp dan capsolver-core.

Jika deteksi halaman melaporkan eksekusi browser yang hilang, jalankan perintah instalasi Chromium di lingkungan yang menjalankan server MCP. Mode token tidak memerlukan browser hanya untuk memanggil layanan penyelesaian, jadi bedakan kegagalan startup browser dari kegagalan API solver.

Jika server terhubung tetapi panggilan API gagal, simpan kode kesalahan yang dikembalikan dan ringkasan yang telah dihapus. Periksa kunci akun, jenis yang didukung, input yang diperlukan, dan status halaman saat ini sebelum mencoba lagi.

Jika penyelesaian mengembalikan token tetapi aplikasi asli tetap tidak berubah, periksa konsumsi hasil. Pastikan hasil digunakan oleh alur kerja yang dimaksud dan bahwa Anda tidak mengasumsikan dua sesi browser terpisah berbagi state.

Jaga batas kecil pada upaya berulang. Ketika kesalahan yang sama tetap tidak terselesaikan, kembalikan bukti untuk tinjauan daripada memerintahkan agen untuk mencoba berulang kali tanpa batas.

Bangun Alur Kerja Otomasi yang Handal dengan CapSolver

Mulai dengan koneksi MCP yang nyata, periksa set alat yang terinstal, dan minta operasi yang sesuai dengan tantangan dalam tugas yang disetujui Anda.

CapSolver memberi Claude Code kemampuan penyelesaian CAPTCHA yang terdokumentasi. Input yang benar dan batasan browser yang jelas membuat kemampuan ini berguna; respons aplikasi akhir memberi tahu Anda apakah tugas yang dimaksud sebenarnya selesai.

FAQ

Q: Apakah saya memerlukan dependensi browser untuk setiap alat MCP?

Tidak. Alat halaman memerlukan ekstra browser dan Chromium. Penyelesaian token dan query akun atau cakupan tidak perlu membuka browser hanya untuk memanggil layanan atau kemampuan lokal yang sesuai.

Q: Apakah CapSolver MCP dapat melanjutkan tab browser saya yang sudah ada?

Alat halaman dalam versi yang diperiksa membuka dan menutup sesi browser sendiri. Jangan mengasumsikan bahwa mereka mengontrol tab yang dimiliki alat browser lain.

Q: Apakah server MCP mendukung setiap tugas REST CapSolver?

Tidak. Periksa get_supported_captchas dan skema alat yang ditemukan. Kemampuan REST terpisah tidak secara otomatis diekspos melalui paket MCP ini.

Q: Mengapa Claude Code menunjukkan persetujuan yang tertunda?

Server MCP proyek mungkin memerlukan persetujuan sebelum digunakan. Tinjau di Claude Code dan konfirmasikan perintah yang dikonfigurasi daripada menganggap status persetujuan sebagai kesalahan kunci API.

Q: Apakah penyelesaian yang berhasil berarti agen menyelesaikan tugasnya?

Tidak. Pastikan hasil dikonsumsi oleh aplikasi yang dimaksud dan bahwa operasi halaman yang diminta selesai. Token atau widget yang terisi adalah hasil sementara.