Cara Menggunakan CapSolver MCP Server: Panduan Pengaturan Agen AI

TL;DR

• Server MCP CapSolver mengekspos lima alat yang telah didokumentasikan: solve_captcha, detect_captchas, solve_on_page, get_balance, dan get_supported_captchas.
• Instal capsolver-core sebelum capsolver-mcp, lalu konfigurasi klien MCP untuk menjalankan perintah capsolver-mcp dengan kunci API di lingkungan.
• Alat browser memerlukan ekstra browser dan Chromium; mode token dapat berjalan tanpa browser ketika jenis CAPTCHA, URL halaman, dan kunci situs sudah diketahui.
• Agent produksi memerlukan aturan host yang disetujui, satu upaya pemulihan terbatas, log yang dirahasiakan, dan pemeriksaan keberhasilan tingkat aplikasi.

Pengantar

Jawaban paling aman tentang cara menggunakan server MCP CapSolver adalah dengan memperlakukan penanganan CAPTCHA sebagai alat infrastruktur yang sempit, bukan sebagai sumber otoritas baru untuk agen. CapSolver menyediakan layanan capsolver-mcp resmi, yang mengemas capsolver-core dan memungkinkan klien AI yang kompatibel menemukan alat CAPTCHA yang telah didokumentasikan. Agen kemudian dapat pulih dari gangguan reCAPTCHA v2, reCAPTCHA v3 termasuk Enterprise, atau Cloudflare Turnstile di dalam alur kerja browser yang diizinkan. Aplikasi Anda tetap memiliki cakupan, kredensial, batas ulang, dan penegasan bisnis akhir. Panduan ini menunjukkan instalasi dan konfigurasi JSON nyata, menjelaskan setiap alat dan batas output, serta mendefinisikan kondisi berhenti untuk penggunaan yang sah, wajar, dan bertanggung jawab. Ini tidak memberikan otorisasi akses ke data pribadi, terbatas, sensitif, atau tidak sah.

Pahami Tiga Lapisan CapSolver

Sebelum memutuskan cara menggunakan server MCP CapSolver, pisahkan lapisan produk. Pengantar CapSolver untuk Agen AI menjelaskan arsitektur lapisan pemulihan. capsolver-core melakukan deteksi dan penyelesaian, capsolver-agent menyesuaikan metode tersebut menjadi skema yang dapat dipanggil agen, dan capsolver-mcp mempublikasikan kemampuan yang sama melalui MCP.

API SDK inti mendokumentasikan create_capsolver, detect, get_captcha_info, solve, dan solve_on_page. Adapter alat agen mendokumentasikan get_all_tools dan create_executor. Panduan layanan MCP adalah sumber kebenaran untuk instalasi, transportasi, konfigurasi, dan lima alat MCP.

Pilih MCP ketika klien sudah berbicara MCP

Gunakan server MCP CapSolver untuk klien Claude Desktop, Cursor, Cline, VS Code, atau host kompatibel lainnya. Gunakan capsolver-agent ketika Anda menulis loop pemanggilan fungsi sendiri. Gunakan capsolver-core ketika Playwright atau layanan memiliki kontrol alur kerja penuh dan tidak ada model yang memerlukan skema alat. Perbedaan ini mencegah adapter yang tumpang tindih dan membuat cara menggunakan server MCP CapSolver lebih mudah dipelihara.

Instal Paket Resmi

Urutan resmi menginstal mesin inti terlebih dahulu, lalu wrapper MCP:

pip install git+https://github.com/capsolver-ai/capsolver-core.git
pip install git+https://github.com/capsolver-ai/capsolver-mcp.git

Untuk deteksi browser dan solve_on_page, instal ekstra browser dan Chromium:

pip install "capsolver-mcp[browser] @ git+https://github.com/capsolver-ai/capsolver-mcp.git"
playwright install chromium

Perintah ini adalah input yang diverifikasi untuk cara menggunakan server MCP CapSolver. Output yang berhasil adalah perintah capsolver-mcp yang dapat dijalankan. Berhenti jika instalasi merujuk ke nama paket tidak resmi, jika perintah hilang, atau jika Chromium tidak tersedia untuk penggunaan mode browser.

Konfigurasi Klien MCP

Konfigurasi stdio resmi ringkas dan bekerja di banyak klien MCP lokal:

{
  "mcpServers": {
    "capsolver": {
      "command": "capsolver-mcp",
      "env": {
        "CAPSOLVER_API_KEY": "KUNCI_API_ANDA"
      }
    }
  }
}

Simpan kunci sebenarnya di manajer rahasia atau lingkungan klien, bukan di kontrol sumber. Input adalah perintah dan lingkungan. Output adalah server yang terhubung yang daftar alatnya dapat diperiksa. Kondisi berhenti adalah peluncuran yang gagal, jalur eksekusi yang tidak terduga, atau registri yang tidak lengkap. Spesifikasi alat MCP menjelaskan mengapa klien harus menemukan dan memvalidasi skema alat sebelum pemanggilan.

Konfirmasi nama alat yang tepat

Setelah memuat ulang klien, pastikan semua lima nama: solve_captcha, detect_captchas, solve_on_page, get_balance, dan get_supported_captchas. Artikel tentang memperbaiki kesalahan CAPTCHA di server MCP memberikan jalur diagnostik yang berguna, sementara pemulihan titik kunci agen MCP menjelaskan mengapa pemulihan harus tetap terbatas.

Klaim Kode Bonus CapSolver Anda

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

Tetapkan Input, Output, dan Kondisi Berhenti

Untuk mode token, agen menyediakan jenis CAPTCHA yang didukung, URL halaman yang diizinkan, dan kunci situs publik; solve_captcha mengembalikan solusi melalui hasil alat MCP. Untuk mode browser, detect_captchas mendaftar jenis yang terdeteksi dan solve_on_page melakukan deteksi, penyelesaian, dan pengisian kembali yang telah didokumentasikan. get_balance melaporkan informasi saldo, dan get_supported_captchas melaporkan registri saat ini.

Jangan mengasumsikan keberhasilan dari respons alat tanpa kesalahan. Aplikasi harus memverifikasi bahwa rute, status formulir, atau asersi uji yang diharapkan berubah dalam sesi browser yang sama. Berhenti menggunakan server MCP CapSolver setelah satu upaya otonom, perubahan hostname, checkpoint kedua, otorisasi kedaluwarsa, jenis CAPTCHA yang tidak didukung, atau keadaan halaman yang ambigu.

Panduan langkah demi langkah MCP untuk pengaturan CAPTCHA membantu menghubungkan konfigurasi dengan penemuan alat nyata. Untuk perilaku MCP khusus reCAPTCHA, contoh reCAPTCHA v2 Cursor menunjukkan bagaimana integrasi klien sempit berbeda dari pengembangan server umum.

Tambahkan Pembatas Produksi

Implementasi produksi cara menggunakan server MCP CapSolver harus memungkinkan hanya host yang disetujui dan tindakan yang dinyatakan. Simpan kuki dan kredensial di luar pesan model. Catat identifikasi permintaan, nama alat, status terminal, dan kode kesalahan yang dirahasiakan daripada token mentah. Panduan logging OWASP mendukung desain peristiwa yang sadar privasi, dan Kerangka Manajemen Risiko AI NIST mendukung kontrol yang bertanggung jawab.

Uji kunci yang hilang, ketergantungan browser yang hilang, penemuan alat yang tidak lengkap, jenis yang tidak didukung, keadaan halaman yang tidak berubah, dan tantangan berulang. Setiap kasus negatif harus mengembalikan status ulasan terminal daripada pemanggilan otonom lainnya.

Kesimpulan

Metode praktis cara menggunakan server MCP CapSolver sederhana: instal capsolver-core dan capsolver-mcp, konfigurasi perintah resmi, verifikasi lima alat, dan tempatkan gerbang otorisasi ketat di depan setiap pemanggilan. Perlakukan keberhasilan aplikasi sebagai hasil dan penyelesaian alat sebagai bukti. Tim yang menjalankan alur kerja agen AI yang diizinkan dapat mengevaluasi CapSolver sebagai lapisan infrastruktur CAPTCHA.

FAQ

Apakah server MCP CapSolver mendukung semua jenis tugas CapSolver untuk agen?

Tidak. Dokumentasi agen AI saat ini membatasi lapisan ini hanya pada reCAPTCHA v2, reCAPTCHA v3 termasuk Enterprise, dan Cloudflare Turnstile. Periksa get_supported_captchas saat runtime.

Perintah apa yang harus dijalankan klien MCP?

Gunakan eksekusi capsolver-mcp resmi, atau jalankan modul yang diinstal dengan Python di lingkungan jika eksekusi tidak ada di PATH klien.

Kapan cara menggunakan server MCP CapSolver memerlukan Playwright?

Deteksi browser dan solve_on_page memerlukan ekstra browser dan Chromium. Mode token tidak memerlukan browser ketika parameter halaman sudah diketahui.

Apa yang harus menghentikan agen AI setelah pemanggilan CAPTCHA?

Berhenti pada perubahan cakupan, jenis yang tidak didukung, konteks browser yang hilang, tantangan berulang, otorisasi kedaluwarsa, atau keadaan aplikasi yang tidak berubah setelah satu upaya.