Cara menghubungkan CapSolver MCP ke Agen Browser rtrvr

TL;DR

• rtrvr dapat memanggil alat CAPTCHA eksternal melalui MCP. Sistem alatnya menerima server HTTP atau SSE yang dapat di-stream dan mengekspos alat yang diimpor dengan nama yang berkualifikasi.
• Gunakan alat mode token untuk pekerjaan browser yang terikat sesi. Alat ini mengembalikan token tanpa membuka browser kedua, meninggalkan rtrvr bertanggung jawab atas tab asli dan langkah pengiriman aplikasi spesifik.
• Jangan bingung dua alat yang bernama solve_captcha. Dokumen rtrvr memiliki tindakan browser bawaan dengan nama tersebut, sementara server MCP eksternal mengimpor alat berkualifikasi terpisah seperti capsolver.solve_captcha.
• Token yang dikembalikan bukan bukti bahwa tugas browser berhasil. Verifikasi tab yang sama, respons aplikasi yang diinginkan, batas ulang, dan status alur kerja akhir.

Pengenalan: Sambungkan alat tantangan yang diketik ke rtrvr

rtrvr menggabungkan ekstensi Chrome, browser cloud, API, MCP, CLI, dan SDK untuk pekerjaan browser yang didorong agen. Lapisan pemanggilan alatnya juga dapat menyambungkan server MCP eksternal dan memanggil alat mereka dari obrolan atau subrutin JavaScript yang dapat digunakan kembali. CapSolver cocok dengan arsitektur ini sebagai layanan penanganan tantangan terpisah untuk situs web dan lingkungan pengujian yang Anda miliki atau diizinkan untuk otomasi.

Panduan ini menunjukkan integrasi yang sempit yang sebenarnya didokumentasikan oleh dua antarmuka tersebut. rtrvr mempertahankan kendali atas tab browser aktif. CapSolver MCP menyediakan alat mode token yang diketik. Subrutin rtrvr yang kecil memvalidasi permintaan, memanggil alat MCP yang berkualifikasi, dan mengembalikan hasil yang terstruktur ke alur kerja. Pembaruan halaman akhir tetap menjadi langkah spesifik aplikasi karena token CAPTCHA terikat pada konteks tantangan dan bukan hasil klik umum.

Panduan ini tidak mengasumsikan kemitraan resmi antara produk-produk tersebut. Juga tidak menyatakan bahwa CapSolver MCP dapat terhubung ke objek browser internal rtrvr. Sebaliknya, ia menggunakan kontrak alat eksternal yang dipublikasikan rtrvr dan skema alat MCP yang dipublikasikan CapSolver.

Apa yang didukung oleh integrasi rtrvr dan CapSolver

Dokumentasi Pemanggilan Alat rtrvr menyatakan bahwa pengguna dapat menyambungkan server MCP melalui URL, mengaktifkan alat yang diimpor, memanggilnya langsung dengan @toolname, dan menggabungkannya di dalam alat kustom dengan rtrvr.callTool(name, params). Alat MCP yang diimpor disimpan dengan prefiks server, yang penting ketika dua sistem menerbitkan nama alat yang sama.

Dokumentasi Layanan MCP CapSolver mengekspos lima alat:

Untuk tab rtrvr yang masuk, solve_captcha adalah titik awal yang praktis. Alat MCP berbasis browser mulai sesi Playwright mereka sendiri. Mereka tidak menerima tab, cookie, penyimpanan lokal, atau status halaman saat ini dari rtrvr. Hal ini membuat solve_on_page berguna untuk pemeriksaan halaman independen dan diizinkan, tetapi bukan kelanjutan transparan dari sesi rtrvr yang ada.

Ada juga tabrakan nama yang sengaja dikelola. rtrvr mendokumentasikan solve_captcha sebagai salah satu alat pageAction bawaannya. CapSolver MCP menerbitkan alat dengan nama pendek yang sama. Setelah menyambungkan server eksternal, periksa daftar alat dan panggil namanya yang lengkap, biasanya capsolver.solve_captcha. Jangan biarkan perencana menebak alat mana yang Anda maksud.

Arsitektur dan batas tanggung jawab

Jaga integrasi dalam empat lapisan:

Pemisahan ini mencegah tiga kesalahan umum. Pertama, model tidak menciptakan bidang tugas. Kedua, respons token tidak dicatat sebagai tindakan bisnis yang selesai. Ketiga, penolakan akses, dinding login, prompt MFA, atau tantangan yang tidak didukung tidak dikirim ulang ke solver.

Gunakan pola ini hanya pada sistem yang Anda miliki atau memiliki izin untuk diuji atau otomasi. Pertahankan alur kerja sensitif seperti pembayaran, verifikasi identitas, pembuatan akun, akses data pribadi, dan lainnya di balik persetujuan manusia eksplisit dan aturan layanan yang berlaku.

Langkah 1: Mulai CapSolver MCP melalui HTTP Streamable

rtrvr menyambungkan server MCP eksternal melalui URL, sementara CapSolver MCP defaultnya menggunakan stdio lokal. Mulai server yang sama dengan HTTP Streamable sehingga ekstensi rtrvr dapat mengaksesnya.

python -m venv .venv
source .venv/bin/activate
pip install capsolver-core
pip install capsolver-mcp

export CAPSOLVER_API_KEY="YOUR_CAPSOLVER_API_KEY"
capsolver-mcp --transport streamable-http --host 127.0.0.1 --port 8000

SDK Python MCP resmi menggunakan /mcp sebagai jalur HTTP Streamable default, jadi endpoint lokal adalah:

http://127.0.0.1:8000/mcp

Mengikat ke 127.0.0.1 menjaga layanan tetap lokal. Opsi --api-key atau variabel lingkungan CAPSOLVER_API_KEY mengautentikasi server ke CapSolver; ini bukan lapisan otentikasi klien untuk siapa pun yang dapat mengakses port MCP. Jangan mengikat perintah ini langsung ke antarmuka publik. Jika lingkungan rtrvr jarak jauh harus mengaksesnya, deploy di balik HTTPS yang terautentikasi, batasi jaringan yang diizinkan, lindungi kunci API di penyimpanan rahasia, dan tinjau pengaturan asal dan transportasi server MCP.

Alat mode token tidak memerlukan Playwright. Pasang ekstra browser hanya ketika Anda memiliki penggunaan terpisah yang diizinkan untuk detect_captchas atau solve_on_page:

pip install "capsolver-mcp[browser]"
playwright install chromium

Langkah 2: Sambungkan dan verifikasi server MCP di rtrvr

Buka bagian Alat rtrvr, tambahkan URL MCP lokal, dan aktifkan hanya alat yang dibutuhkan oleh alur kerja. Dokumentasi rtrvr mendukung server MCP HTTP Streamable, SSE, dan yang dilindungi OAuth. Untuk pengaturan lokal ini, gunakan URL HTTP Streamable dari langkah sebelumnya.

Mulai dengan dua panggilan tanpa browser:

@capsolver.get_supported_captchas
@capsolver.get_balance

Prefiks yang tepat ditetapkan oleh rtrvr ketika server terhubung. Jika berbeda, gunakan nama yang ditampilkan di panel Alat. Subrutin kustom juga dapat memanggil await rtrvr.listTools() dan memeriksa setiap nama alat yang tersedia, deskripsi, skema parameter, dan sumber.

Pengecekan ini menjawab pertanyaan yang berbeda. get_supported_captchas membuktikan bahwa rtrvr menemukan alat eksternal. get_balance membuktikan bahwa proses MCP menerima kredensial akun yang berfungsi. Kedua pengecekan ini tidak membuktikan bahwa tantangan nyata dapat diselesaikan, tetapi keduanya memisahkan kegagalan konfigurasi dari kegagalan tugas sebelum Anda menghabiskan waktu untuk memperbaiki alur browser.

Jangan masukkan kunci API nyata di prompt rtrvr, rekaman halaman, screenshot, atau repositori. Simpan di lingkungan proses MCP. Jika proses mencatat argumen alat, redaksi token, kunci, URL yang mengandung parameter sensitif, dan semua identifikasi spesifik target sebelum menyimpan log.

Klaim Kode Bonus CapSolver Anda

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

Langkah 3: Tambahkan subrutin rtrvr yang deterministik

Alat JavaScript kustom rtrvr dapat memanggil alat MCP yang terhubung melalui rtrvr.callTool. Subrutin berikut melakukan empat hal sebelum mengembalikan token: memvalidasi URL, memperbolehkan jenis tantangan yang didukung, menemukan alat eksternal yang berkualifikasi, dan menyederhanakan status kegagalan.

const allowedTypes = new Set(["reCaptchaV2", "reCaptchaV3", "cloudflare"]);

function fail(state, message, details = {}) {
  return { ok: false, state, message, ...details };
}

if (!allowedTypes.has(captchaType)) {
  return fail("unsupported_challenge", `Tipe tidak didukung: ${captchaType}`);
}

const parsed = new URL(websiteUrl);
if (parsed.protocol !== "https:") {
  return fail("policy_block", "Hanya target HTTPS yang disetujui yang diizinkan");
}

const tools = await rtrvr.listTools();
const solver = tools.find((tool) =>
  tool.source === "mcp" &&
  (tool.name === "capsolver.solve_captcha" || tool.name.endsWith(".solve_captcha"))
);

if (!solver) {
  return fail("configuration_error", "CapSolver MCP solve_captcha tidak ditemukan");
}

const result = await rtrvr.callTool(solver.name, {
  captcha_type: captchaType,
  website_url: websiteUrl,
  website_key: websiteKey,
  version: version || null,
  page_action: pageAction || null,
  min_score: minScore || null,
  invisible: invisible ?? null,
  enterprise: enterprise ?? null,
  cdata: cdata || null,
  timeout: 90,
  polling_interval: 5,
});

if (!result?.success || !result?.solution?.token) {
  return fail("solve_failed", result?.error || "Tidak ada token yang dikembalikan", {
    errorCode: result?.error_code || null,
    httpStatus: result?.http_status || null,
  });
}

return {
  ok: true,
  state: "token_ready",
  captchaType: result.solution.captcha_type,
  token: result.solution.token,
  expiresAt: result.solution.expire_time || null,
};

Tentukan captchaType, websiteUrl, websiteKey, dan bidang opsional sebagai parameter alat di rtrvr. Contoh ini sengaja tidak mengambil kunci situs dari halaman sembarangan atau menyisipkan token ke aplikasi yang tidak diketahui. Untuk aplikasi pengujian yang Anda kendalikan, tambahkan adapter terpisah yang membaca parameter tantangan tepat dari kontrak aplikasi Anda dan kirimkan hasilnya melalui formulir atau endpoint server yang didukung.

Uji lokal yang disertakan menutupi logika cabang orkestrasi dengan runtime alat rtrvr yang diimpor. Handshake hidup masih memerlukan akun rtrvr, perangkat browser aktif atau konteks cloud, kunci API CapSolver, dan halaman pengujian yang diizinkan.

Langkah 4: Pertahankan token yang terikat pada state browser asli

Solusi CAPTCHA bersifat konteks. Jenis tantangan, kunci situs publik, URL halaman, nama tindakan, status sesi, dan terkadang data proxy atau user-agent dapat memengaruhi apakah aplikasi tujuan menerima hasilnya. Oleh karena itu, alur kerja browser harus mempertahankan tab asli dan mengirimkan token yang dikembalikan dengan cara yang diharapkan oleh aplikasi.

Gunakan alur kerja yang terstruktur alih-alih loop ulang umum:

1. page_ready: halaman yang diinginkan dimuat dan identitasnya diverifikasi.
2. challenge_detected: tantangan yang didukung hadir dan parameter berasal dari bukti halaman tepercaya.
3. solve_requested: satu panggilan MCP yang terikat dibuat untuk instance tantangan tersebut.
4. token_ready: layanan mengembalikan token, tetapi belum ada klaim keberhasilan aplikasi.
5. submitted: adapter aplikasi spesifik mengirimkan token dalam sesi yang diizinkan yang sama.
6. accepted: rute, respons API, atau status halaman yang diinginkan mengonfirmasi keberhasilan.
7. review atau stopped: status ambigu, tidak didukung, sensitif, atau melebihi anggaran.

Jangan panggil solve_on_page sebagai jalan pintas untuk alur kerja yang terikat sesi. Implementasi MCP CapSolver saat ini membuka halaman Chromium headless baru untuk alat ini, melakukan deteksi dan pengisian di sana, lalu menutup browser setelahnya. Itu adalah operasi mandiri yang valid, tetapi merupakan sesi berbeda dari ekstensi atau browser cloud rtrvr. Gunakan hanya ketika sesi terpisah diterima dan secara eksplisit diizinkan.

Langkah 5: Verifikasi hasil aplikasi

Respons MCP yang berhasil berarti alat mengembalikan objek solusi. Itu tidak berarti login, pengiriman formulir, pekerjaan ekstraksi, atau tugas browser selesai. Verifikasi harus terjadi di rtrvr pada tab asli.

Gunakan setidaknya tiga pengecekan:

• Kontinuitas tab: ID tab, host, dan langkah alur kerja yang diinginkan masih sesuai dengan permintaan yang menghasilkan tantangan.
• Penerimaan aplikasi: rute yang terdokumentasi, status DOM, atau respons server memastikan aplikasi menerima hasilnya.
• Hasil bisnis: tugas yang diinginkan selesai tanpa secara diam-diam beralih halaman, akun, atau catatan.

Jika halaman menunjukkan tantangan yang sama lagi, hentikan setelah anggaran percobaan yang dikonfigurasi. Loop tantangan yang berulang dapat menunjukkan token kedaluwarsa, parameter tidak sesuai, inkonsistensi proxy atau user-agent, variasi tantangan yang tidak didukung, atau keputusan kebijakan akses yang lebih luas. Lebih banyak panggilan tidak membuktikan kemajuan.

Catat status dan kode kesalahan, bukan rahasia. Acara yang berguna mencakup ID korelasi, timestamp, nama alat, jenis tantangan, host target, jumlah percobaan, transisi status, latensi, dan hasil akhir aplikasi. Jangan menyimpan solusi token atau kunci API di log biasa.

Masalah Umum pada Integrasi MCP rtrvr

Daftar Periksa Produksi

Sebelum melangkah melewati halaman uji, pastikan semua berikut ini:

• target dan alur kerja browser diizinkan;
• alat CapSolver dipilih dengan nama MCP yang sah;
• parameter tantangan berasal dari bukti runtime yang tepercaya, bukan tebakan model;
• kunci API disimpan di lingkungan atau penyimpanan rahasia;
• titik akhir MCP lokal atau dilindungi oleh HTTPS terotentikasi dan kontrol jaringan;
• penanganan token dipisahkan dari pengiriman aplikasi spesifik;
• ulangannya dibatasi per instance tantangan dan per alur kerja;
• log menghilangkan kunci API, token solusi, URL sensitif, dan data halaman pribadi;
• rtrvr memverifikasi keadaan akhir di tab asli;
• tindakan akun, pembayaran, identitas, dan data pribadi yang sensitif memerlukan tinjauan eksplisit;
• keadaan yang tidak didukung atau ambigu berhenti secara aman.

Daftar periksa ini lebih penting daripada menambahkan prompt perencana lain. Kebanyakan kegagalan integrasi terjadi di batas antara keadaan browser, input alat, output layanan, dan penerimaan aplikasi. Itu adalah kontrak runtime, bukan masalah penalaran model bahasa.

Kesimpulan

rtrvr menyediakan permukaan alat eksternal yang diperlukan untuk memanggil CapSolver MCP, tetapi integrasi yang dapat diandalkan lebih sempit daripada hanya mengaktifkan alat. Mulai CapSolver MCP melalui HTTP Streamable, sambungkan titik akhir di panel Alat rtrvr, verifikasi penemuan dengan alat non-browser, dan panggil solver eksternal dengan namanya yang sah. Untuk sesi rtrvr aktif, gunakan mode token dan pertahankan pengiriman halaman dan verifikasi hasil di dalam alur kerja browser asli. Anggap alat browser terpisah sebagai sesi terpisah, pertahankan bukti yang diketik, dan berhenti pada keadaan yang tidak didukung atau ambigu. Dalam alur kerja agen browser yang diizinkan, CapSolver menyediakan alat tantangan yang terdokumentasi sementara rtrvr tetap bertanggung jawab atas konteks browser dan keberhasilan aplikasi akhir.

Tambahkan Penanganan CAPTCHA ke alur kerja rtrvr yang diizinkan

Tinjau lima alat yang dipublikasikan dalam dokumentasi CapSolver MCP, lalu sambungkan titik akhir lokal atau yang dilindungi dengan baik dari panel Alat rtrvr. Gunakan Dashboard CapSolver untuk menguji satu alur kerja yang disetujui sebelum memperluas integrasi.

FAQ

P: Apakah rtrvr memiliki integrasi CapSolver bawaan?

Dokumentasi yang ditinjau tidak menyatakan kemitraan bawaan atau penyedia CapSolver yang terintegrasi. Integrasi dalam panduan ini menggunakan koneksi alat MCP umum rtrvr dan server MCP publik CapSolver.

P: Mengapa tidak memanggil nama pendek solve_captcha?

rtrvr mendokumentasikan tindakan browser bawaan dengan nama itu, dan CapSolver MCP menerbitkan nama pendek yang sama. Gunakan nama yang sah yang ditampilkan di panel Alat, seperti capsolver.solve_captcha, untuk menghindari ambiguitas.

P: Dapatkah CapSolver MCP menggunakan tab browser yang sudah terbuka di rtrvr?

Tidak melalui alat MCP yang terdokumentasi. Mode token membutuhkan parameter tantangan eksplisit dan mengembalikan token, sementara alat mode browser memulai browser Playwright terpisah.

P: Haruskah saya mengekspose port MCP lokal ke internet?

Tidak. Pertahankan di localhost untuk penggunaan lokal. Deployment yang berbagi membutuhkan HTTPS terotentikasi, pembatasan jaringan, manajemen rahasia, kontrol asal, dan tinjauan keamanan eksplisit.

P: Bagaimana saya tahu tugas browser berhasil?

Verifikasi hasil di tab rtrvr asli menggunakan rute yang diharapkan, keadaan DOM, respons API, dan hasil bisnis. Hanya token yang dikembalikan bukan bukti keberhasilan.