Cara menginstal CapSolver MCP dari Registri MCP Resmi

TL;DR

• CapSolver MCP terdaftar di Daftar MCP Resmi sebagai io.github.capsolver-ai/capsolver-mcp. Versi terbaru yang aktif adalah 0.1.3, didistribusikan melalui PyPI dan dijalankan secara lokal melalui stdio.
• Jalur instalasi terpendek adalah uvx capsolver-mcp. uvx menciptakan lingkungan terisolasi dan menjalankan perintah yang dipublikasikan tanpa memerlukan instalasi paket global secara permanen.
• Setiap konfigurasi klien membutuhkan CAPSOLVER_API_KEY. Simpan kunci asli di lingkungan klien atau penyimpanan rahasia yang disetujui, jangan pernah menyimpannya di repositori publik.
• Koneksi yang berjalan harus menampilkan lima alat. Mereka mencakup penyelesaian berbasis token, deteksi halaman, penyelesaian tingkat halaman, pengecekan saldo, dan jenis tantangan yang didukung.
• Alat berbasis browser memerlukan ekstra browser opsional dan Playwright Chromium. Alat dasar berbasis token tidak memerlukan instalasi browser tambahan.
• Gunakan CapSolver hanya dalam alur kerja yang Anda miliki atau diizinkan untuk diuji atau otomatisasi. Ketersediaan daftar tidak memberikan izin untuk mengakses sistem pribadi atau terbatas.

Instal CapSolver MCP dari Daftar MCP Resmi

Daftar MCP Resmi memberikan catatan kanonik bagi klien MCP dan pengembang untuk menemukan CapSolver MCP, paketnya, transportasi, variabel lingkungan yang diperlukan, repositori, dan versi saat ini. Daftar ini tidak menyimpan paket Python; ia mengarahkan klien ke rilis capsolver-mcp yang diverifikasi di PyPI.

Tutorial ini menjelajahi pencarian, instalasi, konfigurasi, dan pemeriksaan koneksi pertama. Ia hanya menggunakan CapSolver untuk alur kerja AI, QA, RPA, dan otomatisasi browser yang sah dan diizinkan.

Apa yang Diberikan Masuk Daftar MCP Resmi

Masuk Daftar MCP CapSolver mempublikasikan metadata tepat yang dibutuhkan klien kompatibel untuk membuat konfigurasi lokal stdio.

Anda dapat memeriksa masuk saat ini di antarmuka pencarian Daftar MCP Resmi. Daftar ini adalah katalog upstream: standarisasi metadata pencarian sementara paket sebenarnya tetap di PyPI. Dokumentasi peluncuran Daftar MCP menjelaskan model katalog dan distribusi ini.

Prasyarat

CapSolver MCP membutuhkan Python 3.10 atau yang lebih baru, klien MCP yang kompatibel, dan kunci API CapSolver.

Persiapkan hal berikut sebelum mengedit konfigurasi klien:

1. Instal Python 3.10 atau yang lebih baru.
2. Instal uv jika Anda ingin alur kerja yang direkomendasikan uvx.
3. Buat akun CapSolver dan dapatkan kunci API dari dashboard.
4. Pastikan klien MCP Anda mendukung server stdio lokal.
5. Putuskan apakah Anda hanya membutuhkan alat berbasis token atau alat browser opsional.

Dokumentasi layanan CapSolver MCP menjelaskan jalur integrasi yang didukung, sementara ulasan CapSolver AI agent membantu Anda memilih antara MCP, alat agen, dan Core SDK.

Langkah 1: Temukan Catatan Daftar yang Benar

Cari capsolver di Daftar MCP Resmi dan pilih nama persis ini:

io.github.capsolver-ai/capsolver-mcp

Pastikan versi yang ditampilkan adalah 0.1.3 atau yang lebih baru dan statusnya aktif. Hindari paket komunitas yang serupa kecuali Anda secara terpisah meninjau penerbit, repositori, izin, dan kode sumbernya.

Untuk pemeriksaan tingkat API, minta versi server persis:

curl "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.capsolver-ai%2Fcapsolver-mcp/versions/0.1.3"

Slash dalam nama daftar dienkripsi sebagai %2F. Respons harus mengidentifikasi capsolver-mcp sebagai paket PyPI, uvx sebagai petunjuk runtime, dan stdio sebagai transportasi.

Langkah 2: Instal dan Verifikasi CLI

Jalur yang direkomendasikan menjalankan CapSolver MCP dalam lingkungan terisolasi:

uvx capsolver-mcp --help

Jika Anda lebih suka lingkungan virtual yang dikelola, instal paket secara eksplisit:

python -m pip install "capsolver-mcp==0.1.3"
capsolver-mcp --help

CLI saat ini mendukung mode runtime stdio, sse, dan streamable-http. Masuk Daftar MCP Resmi menggunakan stdio karena klien menjalankan paket lokal sebagai proses anak. Paket ini juga dapat memulai proses yang mendukung HTTP di infrastruktur Anda sendiri, tetapi CapSolver saat ini tidak menerbitkan titik akhir MCP jarak jauh yang dihosting di daftar.

Pendekatan uvx mengikuti model eksekusi alat terisolasi yang didokumentasikan dalam panduan alat resmi uv.

Klaim Kode Bonus CapSolver Anda

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

Langkah 3: Konfigurasi Klien MCP Lokal

Klien lokal harus menjalankan uvx capsolver-mcp dan meneruskan CAPSOLVER_API_KEY ke proses anak.

Gunakan bentuk konfigurasi ini di klien yang menerima objek mcpServers, termasuk Claude Desktop dan klien dengan konfigurasi server lokal yang kompatibel:

{
  "mcpServers": {
    "capsolver": {
      "command": "uvx",
      "args": ["capsolver-mcp"],
      "env": {
        "CAPSOLVER_API_KEY": "YOUR_CAPSOLVER_API_KEY"
      }
    }
  }
}

Ganti placeholder secara lokal. Jangan menyimpan kunci API nyata ke Git, tempelkan ke laporan masalah, atau sertakan dalam tangkapan layar.

Jika aplikasi desktop tidak dapat menemukan uvx, gunakan jalur absolut yang dikembalikan oleh perintah berikut:

which uvx

Di PowerShell Windows, gunakan:

Get-Command uvx

Setelah menyimpan konfigurasi, restart sepenuhnya klien MCP. Menutup jendela mungkin meninggalkan aplikasi berjalan di latar belakang, jadi keluarkan proses jika server tidak muncul setelah mengedit konfigurasi.

Langkah 4: Verifikasi Handshake MCP dan Alat

Koneksi yang berhasil harus menampilkan lima alat CapSolver MCP kepada klien.

Mulai dengan pemeriksaan tanpa browser seperti:

Gunakan server MCP CapSolver untuk mendaftar jenis CAPTCHA yang didukung.

Kemudian verifikasi otorisasi akun dengan:

Gunakan server MCP CapSolver untuk memeriksa saldo akun saya.

Pemeriksaan ini memastikan bahwa klien dapat menjalankan proses stdio, menemukan alatnya, dan meneruskan variabel lingkungan. Permintaan penyelesaian nyata memerlukan parameter target yang diizinkan dan saldo akun yang cukup.

Langkah 5: Aktifkan Alat Berbasis Browser Jika Diperlukan

Deteksi dan interaksi berbasis browser memerlukan ekstra paket opsional ditambah Chromium Playwright.

Untuk lingkungan khusus, jalankan:

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

Jika klien MCP menjalankan uvx, tambahkan ekstra browser ke argumen paket:

{
  "mcpServers": {
    "capsolver-browser": {
      "command": "uvx",
      "args": ["--from", "capsolver-mcp[browser]==0.1.3", "capsolver-mcp"],
      "env": {
        "CAPSOLVER_API_KEY": "YOUR_CAPSOLVER_API_KEY"
      }
    }
  }
}

Playwright masih memerlukan biner Chromium yang kompatibel di mesin yang sama. Untuk alur kerja produksi, tetapkan versi, uji pembaruan di staging, dan pisahkan instalasi browser dari rahasia aplikasi.

Masalah Instalasi Umum

Kebanyakan kegagalan koneksi CapSolver MCP berasal dari jalur runtime, versi Python, kredensial yang hilang, atau dependensi browser opsional.

Klien melaporkan spawn uvx ENOENT

Aplikasi desktop tidak dapat melihat uvx di jalur prosesnya. Gunakan jalur absolut uvx di bidang command, lalu restart aplikasi sepenuhnya.

Server berjalan tetapi alat gagal otorisasi

Nilai CAPSOLVER_API_KEY hilang, rusak, atau tidak sampai ke proses anak. Pastikan nama variabel persis, ganti placeholder, dan hindari menambahkan tanda kutip tambahan di nilai JSON.

detect_captchas atau solve_on_page tidak tersedia

Paket dasar tidak menginstal Playwright. Instal capsolver-mcp[browser], instal Chromium, dan restart klien agar menjalankan lingkungan yang diperbarui.

Daftar menunjukkan lebih dari satu hasil CapSolver

API pencarian daftar dapat mengembalikan beberapa versi yang diterbitkan dari server yang sama. Pilih catatan di mana isLatest adalah true, atau minta titik akhir versi persis alih-alih menganggap jumlah hasil sebagai pemeriksaan unik.

Klien terhubung tetapi permintaan penyelesaian gagal

Pisahkan masalah koneksi dari masalah tugas. Pertama, periksa penemuan alat dan get_balance; kemudian periksa jenis tugas, URL situs, kunci situs, bidang opsional, dan saldo akun terhadap dokumentasi CapSolver.

Batasan Operasional dan Penggunaan Bertanggung Jawab

CapSolver MCP adalah antarmuka alat lokal, bukan izin untuk mengotomasi target. Gunakan hanya pada situs dan sistem yang Anda miliki atau diizinkan untuk diuji atau diotomatisasi. Ikuti ketentuan yang berlaku, persyaratan privasi, batas laju, dan aturan penyimpanan data.

Daftar Resmi memastikan metadata yang dikendalikan penerbit dan lokasi paket; itu tidak menggantikan tinjauan keamanan Anda sendiri. Periksa repositori sumber CapSolver MCP, tetapkan versi di mana proses perubahan Anda memerlukannya, lindungi kunci API, dan uji pembaruan sebelum penyebaran luas.

Untuk keputusan arsitektur di luar klien tunggal, lihat bagaimana tim AI-agent perusahaan mengatur penanganan tantangan yang diizinkan dan tinjau definisi titik akhir API saat merancang batas layanan.

Kesimpulan

Daftar MCP Resmi sekarang menyediakan catatan kanonik, dapat dicari untuk CapSolver MCP, sementara PyPI menyediakan paket Python yang dapat dieksekusi. Setup yang andal mengikuti urutan singkat: konfirmasi identitas daftar, jalankan CLI, tambahkan CAPSOLVER_API_KEY ke lingkungan klien, restart klien, dan verifikasi penemuan alat sebelum mencoba tugas yang diizinkan.

Gunakan CapSolver untuk menambahkan alat penyelesaian CAPTCHA yang terdokumentasi ke alur kerja AI-agent dan otomatisasi browser yang didukung.

Bangun Alur Kerja Otomatisasi yang Handal dengan CapSolver

Buat akun, simpan kunci API secara aman, dan mulai dengan uji coba terbatas pada situs atau sistem yang Anda izinkan untuk diotomatisasi. FAQ CapSolver mencakup pertanyaan umum tentang produk dan akun sebelum Anda memindahkan integrasi ke produksi.

FAQ

P: Apakah CapSolver MCP tersedia di Daftar MCP Resmi?

Ya. Nama daftarnya adalah io.github.capsolver-ai/capsolver-mcp, dan versi 0.1.3 saat ini aktif dan ditandai sebagai rilis terbaru.

P: Apakah instalasi dari Daftar menciptakan koneksi jarak jauh yang dihosting?

Tidak. Catatan daftar saat ini menggambarkan paket PyPI yang dijalankan secara lokal dengan uvx melalui stdio; ia tidak mengiklankan titik akhir MCP jarak jauh yang dihosting oleh CapSolver.

P: Apakah saya perlu menginstal capsolver-mcp secara global?

Tidak. uvx capsolver-mcp menjalankan alat dalam lingkungan terisolasi, sementara instalasi pip install tetap tersedia untuk tim yang mengelola lingkungan virtual mereka sendiri.

P: Mengapa klien saya terhubung tetapi tidak menampilkan alat browser?

Alat browser memerlukan ekstra capsolver-mcp[browser] dan instalasi Chromium Playwright. Restart klien setelah menginstal kedua komponen.

P: Variabel lingkungan apa yang dibutuhkan CapSolver MCP?

CapSolver MCP membutuhkan CAPSOLVER_API_KEY. Teruskan melalui lingkungan klien dan jaga nilai asli di luar kontrol sumber dan tangkapan layar dukungan.

P: Bisakah saya menggunakan CapSolver MCP di situs mana pun?

Tidak. Gunakan CapSolver MCP hanya pada situs dan sistem yang Anda miliki atau diizinkan untuk diuji atau diotomatisasi, dan ikuti ketentuan, aturan privasi, dan persyaratan hukum yang berlaku.