Cara Menyelesaikan CAPTCHA dengan MCP: Model Konteks Protokol Layanan CapSolver

Protokol Konteks Model (MCP) memungkinkan klien AI menemukan dan memanggil alat eksternal tanpa kode integrasi apa pun. Paket capsolver-mcp dari CapSolver mengekspos penyelesaian CAPTCHA sebagai layanan MCP standar — setelah terhubung, setiap klien yang kompatibel dengan MCP (Claude Desktop, Claude Code, Cursor, Cline, Windsurf) secara otomatis mendapatkan lima alat penyelesaian. Panduan ini menunjukkan cara mengatur dan menggunakan layanan MCP CapSolver untuk penyelesaian CAPTCHA dalam alur kerja AI Anda.

TL;DR

• capsolver-mcp mengekspos penyelesaian CAPTCHA sebagai alat MCP standar — tidak diperlukan kode adapter per-klien
• Setiap klien yang kompatibel dengan MCP secara otomatis menemukan alat setelah terhubung
• Lima alat tersedia: solve_captcha, detect_captchas, solve_on_page, get_balance, get_supported_captchas
• Mendukung transport stdio, SSE, dan streamable-http
• Pemanggilan berbasis bahasa alami: cukup tanyakan "selesaikan reCAPTCHA di halaman ini" dan klien akan memanggil alat tersebut

Apa Itu MCP dan Mengapa Penting untuk Penyelesaian CAPTCHA

Protokol Konteks Model adalah standar terbuka yang memungkinkan aplikasi AI menemukan dan menggunakan alat eksternal melalui antarmuka yang seragam. Alih-alih menulis kode integrasi khusus untuk setiap klien AI, Anda memaketkan kemampuan sebagai layanan MCP sekali, dan setiap klien yang kompatibel dapat menggunakannya secara langsung.

Untuk penyelesaian CAPTCHA, ini berarti Anda menginstal capsolver-mcp, mengkonfigurasinya dengan kunci API Anda, dan setiap klien MCP dalam alur kerja Anda — Claude Desktop untuk penelitian, Cursor untuk pengembangan, Cline untuk otomasi — secara instan mendapatkan kemampuan untuk menyelesaikan reCAPTCHAs, Cloudflare Turnstile, dan tantangan verifikasi lainnya. Tidak ada kode per-klien, tidak ada adapter khusus kerangka kerja.

Spesifikasi MCP mendefinisikan cara klien menemukan alat, memanggilnya dengan parameter terstruktur, dan menerima hasilnya. Implementasi CapSolver mengikuti spesifikasi ini secara tepat, membuatnya kompatibel dengan ekosistem yang berkembang dari klien MCP.

Apa yang Perlu Anda Siapkan Sebelum Memulai

# Instal mesin inti terlebih dahulu (mcp bergantung padanya)
pip install git+https://github.com/capsolver-ai/capsolver-core.git

# Instal layanan MCP
pip install git+https://github.com/capsolver-ai/capsolver-mcp.git

# Opsional: alat browser (detect/solve_on_page)
pip install "capsolver-mcp[browser] @ git+https://github.com/capsolver-ai/capsolver-mcp.git"
playwright install chromium

export CAPSOLVER_API_KEY="kunci-api-capsolver-anda"

Langkah 1 — Mulai Layanan MCP

Baris Perintah

# stdio (default — untuk klien MCP lokal seperti Claude Desktop)
capsolver-mcp

# SSE (untuk akses jarak jauh/HTTP)
capsolver-mcp --transport sse --host 0.0.0.0 --port 8000

# Streamable HTTP (spesifikasi MCP 2025-03-26)
capsolver-mcp --transport streamable-http --host 0.0.0.0 --port 8000

Opsi baris perintah:

capsolver-mcp [OPSI]
  --transport {stdio,sse,streamable-http}   Protokol transport (default: stdio)
  --host HOST              Host untuk SSE/HTTP (default: 127.0.0.1)
  --port PORT              Port untuk SSE/HTTP (default: 8000)
  --api-key KEY            Kunci API (akan kembali ke variabel lingkungan CAPSOLVER_API_KEY)
  --name NAME              Nama layanan (default: capsolver)

Langkah 2 — Konfigurasi Klien MCP Anda

Claude Desktop / Claude Code

Tambahkan ke file konfigurasi MCP Anda:

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

Jika klien tidak dapat menemukan capsolver-mcp di PATH (umum dengan venv/conda):

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

Cursor / VS Code

Blok konfigurasi yang sama di mcp.json proyek Anda. Setelah reload, lima alat CapSolver muncul di daftar alat secara otomatis.

Langkah 3 — Alat yang Tersedia

Setelah terhubung, layanan mengekspos lima alat:

Langkah 4 — Gunakan Bahasa Alami untuk Menyelesaikan CAPTCHA

Dengan layanan MCP terhubung, cukup gunakan bahasa alami di klien AI Anda:

Periksa saldo:

"Gunakan capsolver untuk memeriksa saldo akun saya."

Klien memanggil get_balance dan mengembalikan saldo Anda.

Penyelesaian mode token:

"Selesaikan reCAPTCHA v2 ini untuk saya. URL-nya adalah https://example.com/login dan kunci situsnya adalah 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI."

Klien memanggil solve_captcha dengan parameter dan mengembalikan token.

Penyelesaian halaman penuh:

"Deteksi dan selesaikan semua CAPTCHA di https://example.com/protected-page."

Klien memanggil solve_on_page, yang mendeteksi, menyelesaikan, dan mengisi kembali semua CAPTCHA di halaman.

Langkah 5 — Pembuatan Server MCP Programatis

Untuk menyisipkan layanan MCP dalam aplikasi Anda sendiri:

from capsolver_mcp import create_server

# Buat dan jalankan server MCP secara programatis
server = create_server(
    api_key="KUNCI_API_CAPSOLVER_ANDA",
    name="capsolver",
    transport="stdio"
)

Ini berguna ketika Anda ingin menyisipkan kemampuan penyelesaian CAPTCHA ke dalam layanan MCP yang lebih besar yang mengekspos berbagai set alat.

Dapatkan Kode Bonus Anda: Gunakan kode WEBS di Dasbor CapSolver untuk mendapatkan bonus tambahan 5% pada setiap pengisian ulang.

Dokumentasi MCP CapSolver menyediakan contoh konfigurasi tambahan. Untuk memahami mesin penyelesaian yang mendasarinya, lihat panduan SDK inti CapSolver. Ekstensi CapSolver membantu mengidentifikasi parameter CAPTCHA selama pengembangan.

Kesimpulan

Layanan MCP CapSolver (capsolver-mcp) memberikan jalur tercepat untuk penyelesaian CAPTCHA di setiap klien AI yang kompatibel dengan MCP. Instal, konfigurasikan kunci API Anda, dan setiap klien dalam alur kerja Anda akan mendapatkan kemampuan penyelesaian tanpa kode integrasi apa pun. CapSolver menangani penyelesaian berbasis AI di awan sementara layanan MCP mengelola penemuan alat, penyerahan parameter, dan pengiriman hasil melalui protokol standar.

FAQ

Klien AI mana yang mendukung layanan MCP CapSolver?

Setiap klien yang kompatibel dengan MCP: Claude Desktop, Claude Code, Cursor, Windsurf, Cline, VS Code dengan plugin Claude, dan setiap klien kustom yang mengimplementasikan spesifikasi MCP. Transport stdio berjalan dengan klien lokal; SSE dan streamable-http berjalan dengan klien jarak jauh/jaringan.

Apakah saya memerlukan browser untuk penyelesaian CAPTCHA MCP?

Hanya untuk alat detect_captchas dan solve_on_page. Alat utama solve_captcha berjalan dalam mode Token — tidak diperlukan browser. Instal ekstra [browser] hanya jika Anda memerlukan deteksi halaman otomatis dan pengisian kembali.

Dapatkah beberapa klien berbagi satu instance layanan MCP?

Dengan transport SSE atau streamable-http, ya. Mulai layanan di port jaringan dan beberapa klien dapat terhubung secara bersamaan. Setiap panggilan alat klien ditangani secara terpisah.

Apa yang terjadi jika layanan MCP kehilangan koneksi?

Klien MCP menangani koneksi ulang secara otomatis. Jika layanan restart, klien akan menemukan alat kembali saat terhubung kembali. Permintaan penyelesaian yang sedang berlangsung mungkin gagal dan perlu diulang dari sisi klien.