# Server MCP untuk Agen AI | ProxyJam Hubungkan Claude, Cursor, dan klien MCP lain ke akun ProxyJam: cari penawaran, pesan dan perpanjang proxy, pantau trafik. Pembelian menunggu izin Anda. - Canonical: https://proxyjam.com/id/mcp/ - Updated: 2026-10-14 - Language: id Server MCP ProxyJam memberi Claude, Cursor, dan klien AI lainnya 16 tool untuk akun Anda: cari penawaran, pesan dan perpanjang proxy, cek trafik dan saldo. Anda masuk dan menentukan sendiri apa yang boleh dilakukan agen, dan setiap tindakan yang memakan biaya menampilkan pratinjau lebih dulu lalu menunggu persetujuan Anda. Anda memerlukan akun ProxyJam. Sebagian besar klien masuk dengan akun tersebut; sisanya memakai kunci API. Servernya sendiri gratis; Anda hanya membayar proxy yang dipesan agen Anda. ProxyJam menjalankan server MCP jarak jauh di `https://proxyjam.com/mcp` melalui Streamable HTTP. Klien AI Anda masuk dengan akun ProxyJam Anda (OAuth) atau mengirim kunci API, lalu mendapatkan 16 tool: sembilan untuk membaca data, empat untuk mengubah pengaturan, dan tiga yang membelanjakan uang — dan ketiganya hanya menampilkan pratinjau sampai Anda mengonfirmasi. ## Enam belas tool, enam pekerjaan ### Jelajahi katalog list_offers mencari penawaran aktif berdasarkan jenis, negara, wilayah, dan kota, lalu mengembalikan setiap tarif beserta harganya. Hanya tool inilah sumber ID penawaran, jadi setiap pembelian berawal dari sini. ### Pesan proxy create_proxy_order membeli 1 hingga 50 proxy dari satu penawaran. Panggilan pertama hanya menampilkan harga dan saldo Anda; pesanan baru dibuat setelah Anda mengonfirmasi. ### Perpanjang dan tambah trafik extend_proxy_period memperpanjang proxy untuk satu periode lagi, dan buy_proxy_bandwidth menambah trafik ke proxy statis. Keduanya menampilkan pratinjau lebih dulu dan baru menagih setelah Anda mengonfirmasi. ### Cek pesanan dan trafik Pesanan Anda beserta detail koneksinya, dan trafik yang sudah terpakai per proxy atau untuk semuanya sekaligus. Hanya membaca, jadi aman dipanggil sesering apa pun oleh agen. ### Pantau keuangan Saldo dompet di setiap mata uang dan riwayat transaksi lengkap, satu per satu atau per halaman. Ini juga hanya membaca. ### Ubah pengaturan Ganti protokol proxy antara HTTP dan SOCKS5, ganti whitelist IP-nya, nyalakan atau matikan perpanjangan otomatis, atau segarkan statusnya. Tidak satu pun dikenai biaya, tetapi klien yang masuk lewat akun tetap memerlukan izin belanja untuk melakukannya. ## Uang hanya keluar atas perintah Anda 1. **Bawaannya hanya membaca.** Saat klien masuk, ProxyJam menunjukkan apa saja yang dimintanya. Akses baca ke pesanan, dompet, dan katalog diberikan sekaligus — dan pesanan memuat login serta kata sandi proxy Anda. Izin belanja adalah kotak terpisah, *Izinkan pembelanjaan dari dompet saya*, yang awalnya tidak dicentang, dan kotak itu juga mencakup perubahan pengaturan yang gratis. 2. **Pratinjau lebih dulu.** `create_proxy_order`, `extend_proxy_period`, dan `buy_proxy_bandwidth` selalu dimulai dengan `confirm=false`: tool ini mengembalikan penawaran, harga, dan saldo Anda, tanpa menagih apa pun. 3. **Persetujuan Anda dulu, baru tagihan.** Agen memanggil ulang dengan `confirm=true` hanya setelah Anda menyetujui pratinjaunya. Aturan agen di prompt di bawah menyatakannya dengan gamblang. 4. **Tidak ada tagihan ganda.** Panggilan konfirmasi memakai ulang `idempotency_key` dari pratinjau, sehingga permintaan yang diulang mengembalikan hasil pertama alih-alih membeli dua kali. Pembelian baru mendapat kunci baru. 5. **Kunci API membuka seluruh akun.** Kunci dari dasbor tidak bisa dibatasi ke izin yang lebih sempit — akses baca dan belanja sudah termasuk di dalamnya. Masuklah dengan akun jika klien Anda mendukungnya, dan beri tanggal kedaluwarsa pada setiap kunci yang Anda pakai. 6. **Akses berakhir saat Anda mencabutnya.** Klien yang masuk lewat akun tercantum di *Aplikasi terhubung* pada [pengaturan dasbor](https://app.proxyjam.com/settings); cabut di sana dan aksesnya berhenti dalam lima menit. Mengganti kata sandi atau keluar dari semua perangkat mencabut setiap koneksi. Kunci berhenti berfungsi begitu Anda menghapusnya di [halaman Kunci API](https://app.proxyjam.com/apikey). ## Terhubung dalam tiga langkah 1. **Tambahkan server ke klien Anda** Pilih klien Anda di atas dan salin konfigurasinya. Alamatnya `https://proxyjam.com/mcp`. 2. **Masuk dan tentukan apa yang boleh dilakukannya** Klien membuka ProxyJam di browser Anda. Masuk, baca apa saja yang dimintanya, dan centang *Izinkan pembelanjaan dari dompet saya* hanya jika agen perlu memesan, memperpanjang, atau mengubah pengaturan. Setiap persetujuan menggantikan yang sebelumnya, jadi Anda bisa menghubungkan ulang nanti untuk mengubahnya. Klien yang tidak bisa masuk memakai [kunci API](https://app.proxyjam.com/apikey) sebagai gantinya: kunci ini diawali `pj_` dan hanya ditampilkan sekali. 3. **Mulai dengan prompt yang hanya membaca** Minta daftar penawaran lebih dulu — katalog aktif yang sama dengan halaman [proxy residensial statis (ISP)](/id/isp-proxies/). Ini membuktikan koneksinya berjalan dan memberi agen ID penawaran yang dibutuhkannya untuk langkah lain. Setelah itu, coba prompt di bawah. ## Pilih klien Anda Pilih salah satu untuk melihat cara menghubungkannya. Sebagian besar klien masuk dengan akun ProxyJam Anda; VS Code dan OpenAI Agents SDK memakai kunci API, jadi ganti pj_... dengan kunci Anda. ### Claude (Anthropic) claude.ai, Claude Desktop, dan aplikasi seluler berbagi satu daftar konektor. 1. Di Claude, buka pengaturan konektor dan tambahkan konektor kustom. 2. Beri nama ProxyJam dan tempel https://proxyjam.com/mcp sebagai alamat server. 3. Hubungkan, masuk ke ProxyJam, lalu setujui. Panduan lengkap di dokumentasi: https://docs.proxyjam.com/mcp-server#claude-ai-and-claude-desktop ### Claude Code (Anthropic) Jalankan di terminal, lalu ketik /mcp di Claude Code, pilih proxyjam, dan masuk. Tambahkan --scope user agar bisa dipakai di setiap proyek. ``` claude mcp add --transport http proxyjam https://proxyjam.com/mcp ``` Panduan lengkap di dokumentasi: https://docs.proxyjam.com/mcp-server#claude-code ### Cursor (Anysphere) ~/.cursor/mcp.json, atau .cursor/mcp.json di dalam proyek. Cursor meminta Anda masuk saat pertama kali terhubung. ``` { "mcpServers": { "proxyjam": { "url": "https://proxyjam.com/mcp" } } } ``` Panduan lengkap di dokumentasi: https://docs.proxyjam.com/mcp-server#cursor ### ChatGPT (OpenAI) ChatGPT mengidentifikasi dirinya lalu membuka halaman masuk ProxyJam. 1. Di pengaturan ChatGPT, aktifkan mode developer dan buat konektor kustom. 2. Masukkan https://proxyjam.com/mcp sebagai URL-nya dan pilih OAuth. 3. Masuk ke ProxyJam, lalu setujui. Panduan lengkap di dokumentasi: https://docs.proxyjam.com/mcp-server#chatgpt ### Codex CLI (OpenAI) Jalankan keduanya di terminal; perintah kedua membuka browser Anda untuk masuk. ``` codex mcp add proxyjam --url https://proxyjam.com/mcp codex mcp login proxyjam ``` Panduan lengkap di dokumentasi: https://docs.proxyjam.com/mcp-server#codex-cli ### VS Code (Microsoft) .vscode/mcp.json, dengan kunci API. VS Code meminta kunci sekali dan menyimpannya dengan aman. ``` { "inputs": [ { "type": "promptString", "id": "proxyjam-api-key", "description": "ProxyJam API key", "password": true } ], "servers": { "proxyjam": { "type": "http", "url": "https://proxyjam.com/mcp", "headers": { "X-API-Key": "${input:proxyjam-api-key}" } } } } ``` Panduan lengkap di dokumentasi: https://docs.proxyjam.com/mcp-server#vs-code ### Gemini CLI (Google) Jalankan di terminal, lalu ketik /mcp auth proxyjam di Gemini CLI untuk masuk. ``` gemini mcp add --transport http proxyjam https://proxyjam.com/mcp ``` Panduan lengkap di dokumentasi: https://docs.proxyjam.com/mcp-server#gemini-cli ### OpenAI Agents SDK (OpenAI) Python, dengan kunci API. pip install openai-agents. ``` import asyncio from agents import Agent, Runner from agents.mcp import MCPServerStreamableHttp async def main(): async with MCPServerStreamableHttp( name="ProxyJam", params={ "url": "https://proxyjam.com/mcp", "headers": {"X-API-Key": "pj_..."}, }, ) as proxyjam: agent = Agent( name="Assistant", instructions="Use the ProxyJam tools. Never confirm " "a purchase without the user's yes.", mcp_servers=[proxyjam], ) result = await Runner.run( agent, "List ISP proxy offers in the United States.") print(result.final_output) asyncio.run(main()) ``` Panduan lengkap di dokumentasi: https://docs.proxyjam.com/mcp-server#openai-agents-sdk ### FastMCP (Prefect) Python. pip install fastmcp. Masuk lewat browser Anda dan menampilkan daftar tool. ``` import asyncio from fastmcp import Client async def main(): # auth="oauth" opens your browser to sign in to ProxyJam. async with Client("https://proxyjam.com/mcp", auth="oauth") as client: for tool in await client.list_tools(): print(tool.name) asyncio.run(main()) ``` Panduan lengkap di dokumentasi: https://docs.proxyjam.com/mcp-server#generic-fastmcp-client-python ## Prompt untuk dicoba Tempel salah satunya ke chat agen Anda setelah server terhubung. Ganti ORDER_ID dengan nomor pesanan dari dasbor Anda. Tab terakhir berisi aturan yang sebaiknya disimpan di instruksi agen Anda. ### Cari proxy Hanya membaca. Aman untuk panggilan pertama. Lewat server MCP ProxyJam, tampilkan daftar penawaran proxy residensial statis (ISP) di Amerika Serikat beserta harga bulanannya. Jangan memesan apa pun. ### Beli dengan pratinjau Baru menagih setelah Anda setuju. Pesan satu proxy residensial statis (ISP) di Amerika Serikat untuk satu bulan di ProxyJam. Tunjukkan pratinjaunya dulu — penawaran, harga, dan saldo dompet saya — dan tunggu persetujuan tegas dari saya sebelum mengonfirmasi. Saat mengonfirmasi, pakai ulang idempotency key yang sama. ### Perpanjang Perpanjang pesanan, pratinjau dulu. Perpanjang pesanan ProxyJam saya ORDER_ID selama satu bulan. Tunjukkan pratinjau berisi harga dan saldo saya, lalu tunggu persetujuan saya sebelum mengonfirmasi. ### Pemakaian dan saldo Pesanan, trafik, dan uang dalam satu jawaban. Tampilkan proxy ProxyJam saya yang aktif beserta tanggal kedaluwarsanya dan trafik yang sudah dipakai masing-masing, lalu saldo dompet USD saya dan 10 transaksi terakhir saya. ### Pengaturan Perubahan yang tidak dikenai biaya. Untuk pesanan ProxyJam saya ORDER_ID: ganti protokolnya ke SOCKS5, atur whitelist IP menjadi 203.0.113.7, dan nyalakan perpanjangan otomatis. Setelah itu, beri tahu saya pengaturan barunya. ### Aturan agen Untuk CLAUDE.md, AGENTS.md, atau Cursor rules. Saat memakai server MCP ProxyJam: - Panggil list_offers lebih dulu. Hanya tool itu yang menjadi sumber ID penawaran. - create_proxy_order, extend_proxy_period, dan buy_proxy_bandwidth hanya berupa pratinjau sampai confirm=true. Tunjukkan pratinjaunya kepada saya dan jangan pernah mengonfirmasi tanpa persetujuan tegas dari saya. - Konfirmasi dengan idempotency_key yang sama seperti pada pratinjau. Gunakan kunci baru untuk setiap pembelian baru. - Jika pratinjau menunjukkan saldo lebih kecil daripada harganya, berhenti dan beri tahu saya alih-alih mengonfirmasi. - Jika sebuah tool ditolak karena izin belanja tidak diberikan, beri tahu saya alih-alih mencoba lagi; saya yang memutuskan apakah akan menghubungkan ulang dengan izin belanja. - Perlakukan kunci API saya sebagai rahasia: jangan pernah menampilkannya, mencatatnya ke log, atau menuliskannya ke file yang mungkin saya bagikan. ## Semua 16 tool | Tool | Fungsinya | Efek | |---|---|---| | list_offers | Mencari katalog berdasarkan jenis, negara, wilayah, dan kota; mengembalikan ID penawaran dan tarif | Membaca | | list_my_orders | Menampilkan pesanan proxy Anda, per halaman | Membaca | | get_order | Satu pesanan secara lengkap, termasuk detail koneksi proxy | Membaca | | get_my_traffic_summary | Trafik yang terpakai di semua proxy aktif Anda | Membaca | | get_order_traffic | Trafik yang terpakai oleh satu pesanan | Membaca | | list_my_wallets | Dompet Anda, satu per mata uang | Membaca | | get_wallet_balance | Saldo satu dompet | Membaca | | list_wallet_transactions | Riwayat transaksi sebuah dompet, per halaman | Membaca | | get_transaction | Satu transaksi | Membaca | | create_proxy_order | Membeli 1 hingga 50 proxy dari satu penawaran | Membelanjakan uang, pratinjau dulu | | extend_proxy_period | Memperpanjang proxy aktif untuk satu periode lagi | Membelanjakan uang, pratinjau dulu | | buy_proxy_bandwidth | Menambah trafik 1 hingga 5.000 GB ke proxy statis | Membelanjakan uang, pratinjau dulu | | set_auto_renew | Menyalakan atau mematikan perpanjangan otomatis | Mengubah pengaturan, gratis | | set_proxy_whitelist | Mengganti daftar IP yang boleh memakai proxy | Mengubah pengaturan, gratis | | change_proxy_protocol | Beralih antara HTTP dan SOCKS5 | Mengubah pengaturan, gratis | | sync_proxy_state | Membaca ulang status terkini proxy | Mengubah pengaturan, gratis | Tool yang saat ini disediakan server. Tiga tool yang membelanjakan uang mengembalikan pratinjau sampai dipanggil lagi dengan confirm=true. Klien yang masuk lewat akun hanya bisa memanggil tujuh tool terakhir jika Anda mengizinkan pembelanjaan. ## Detail koneksi - **Endpoint:** https://proxyjam.com/mcp - **Transport:** Streamable HTTP - **Autentikasi:** Masuk dengan akun ProxyJam Anda (OAuth 2.1), atau kunci API di header X-API-Key - **Akses:** Bawaannya hanya membaca; pembelanjaan dan perubahan pengaturan hanya jika Anda mengizinkannya - **Daftar referensi:** Status pesanan, mata uang, protokol proxy, jenis penawaran, dan metode pembayaran, sebagai resource MCP - **Harga:** Gratis. Anda hanya membayar proxy yang Anda pesan ## Pertanyaan tentang server MCP ### Klien AI apa saja yang bisa terhubung? Klien MCP mana pun yang terhubung ke server jarak jauh melalui Streamable HTTP dan bisa masuk dengan OAuth atau mengizinkan Anda menambahkan header permintaan. Konfigurasi di atas mencakup Claude (claude.ai, Claude Desktop, dan aplikasi seluler), Claude Code, Cursor, ChatGPT, VS Code, Codex CLI, Gemini CLI, OpenAI Agents SDK, dan FastMCP. ### Apakah bisa dihubungkan ke claude.ai atau ChatGPT? Bisa. Di Claude, tambahkan konektor kustom dengan alamat https://proxyjam.com/mcp, lalu masuk ke ProxyJam; konektor itu juga muncul di Claude Desktop dan aplikasi seluler. Di ChatGPT, konektor MCP kustom memerlukan mode developer, yang ditawarkan OpenAI sebagai beta di sebagian paket; tambahkan alamat yang sama dan pilih OAuth. ### Apakah server MCP ini berbayar? Tidak. Menghubungkan dan memanggil tool tidak dikenai biaya. Anda hanya membayar apa yang dipesan agen Anda, dengan harga yang sama seperti di dasbor, dari dompet ProxyJam Anda. ### Bisakah agen saya membelanjakan uang tanpa bertanya kepada saya? Tidak secara tidak sengaja. Klien yang masuk lewat akun sama sekali tidak bisa membelanjakan uang kecuali Anda mencentang *Izinkan pembelanjaan dari dompet saya* saat menyetujuinya. Itu pun, tiga tool yang menagih — memesan, memperpanjang, dan membeli trafik — mengembalikan pratinjau pada panggilan pertama dan baru menagih saat dipanggil lagi dengan confirm=true; agen yang cermat menunjukkan pratinjau itu kepada Anda dan menunggu, dan aturan agen di atas memang memintanya begitu. Kunci API tidak punya batas pembelanjaan, jadi berikan agen kunci yang bisa Anda hapus. ### Apa yang tidak bisa dilakukan agen lewat MCP? Mengisi saldo dompet, mengelola kunci API, mengubah pengaturan akun, mengecek alamat IP, atau menjalankan aksi proxy seluler seperti reset IP. Semua itu tetap di dasbor dan REST API. ### Apakah saya memerlukan kunci API? Tidak, jika klien Anda bisa masuk dengan akun. Permintaan yang tidak membawa login maupun kunci akan ditolak dengan petunjuk ke halaman masuk ProxyJam — begitulah claude.ai, Claude Code, Cursor, dan klien lainnya memulai proses masuk dengan sendirinya. Klien yang tidak bisa masuk mengirim kunci API sebagai gantinya. ### Bagaimana cara mengizinkan pembelanjaan belakangan, atau mencabutnya lagi? Hubungkan ulang dan setujui dengan kotak tersebut dicentang atau tidak dicentang: setiap persetujuan menggantikan yang sebelumnya. Di Claude Code, misalnya, caranya dengan /mcp, lalu masuk lagi ke proxyjam. ### Bagaimana cara mencabut akses agen? Untuk klien yang masuk lewat akun, cabut di Aplikasi terhubung pada pengaturan dasbor; aksesnya berhenti dalam lima menit, dan koneksi Anda yang lain tetap berjalan. Mengganti kata sandi atau keluar dari semua perangkat mencabut semuanya sekaligus. Untuk kunci API, hapus kuncinya di halaman Kunci API; kunci yang dibuat dengan tanggal kedaluwarsa juga akan berhenti berfungsi dengan sendirinya. ### Bisakah agen mendaftar sendiri? Bisa, dengan batasan. Agen tanpa akun di belakangnya bisa mendaftar dan mendapatkan kunci yang hanya bisa membaca katalog publik. Jika Anda mengklaim kunci itu dengan kode yang dikirim ProxyJam lewat email, kunci itu bergabung ke akun Anda dan bisa membaca pesanan serta dompet Anda, tetapi tidak akan pernah bisa membelanjakan uang. Langkah-langkah untuk agen ada di auth.md. ## Mulai dari yang kecil Hubungkan, minta daftar penawaran, dan baca hasilnya sebelum Anda membiarkan agen memesan apa pun. Saat tiba waktunya membeli, pratinjau menampilkan penawaran, harga, dan saldo Anda, dan tidak ada yang ditagih sampai Anda bilang setuju. ## Sumber - [Model Context Protocol — Transports](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports) — transport Streamable HTTP yang digunakan server ini - [Kartu server MCP](/.well-known/mcp/server-card.json) — endpoint, transport, dan autentikasi, untuk agen yang menemukan ProxyJam dengan sendirinya - [auth.md](/auth.md) — cara agen masuk, mendaftar, atau memakai kunci API - [Metadata server otorisasi OAuth](/.well-known/oauth-authorization-server) — endpoint dan scope yang ditemukan klien saat masuk - [Skill agen ProxyJam](/.well-known/agent-skills/proxyjam/SKILL.md) — panduan penggunaan yang bisa dimuat agen sebelum panggilan pertamanya MCP, atau [Model Context Protocol](https://modelcontextprotocol.io/), adalah standar terbuka yang dipakai asisten AI untuk memanggil tool eksternal. Arahkan klien MCP ke server ProxyJam, dan agen Anda bisa melakukan di akun Anda sebagian besar hal yang bisa dilakukan kunci API lewat REST API. Ada dua hal yang perlu Anda ketahui sebelum mulai. **Anda yang menentukan apa yang boleh dilakukannya.** Klien yang masuk lewat akun meminta persetujuan Anda lebih dulu. Akses baca diberikan sebagai satu paket, dan paket itu mencakup login serta kata sandi proxy Anda; pembelanjaan dari dompet, beserta perubahan pengaturan yang gratis, adalah kotak terpisah yang hanya Anda centang jika ingin agen bertindak. Kunci API berbeda: kunci membuka seluruh akun, jadi utamakan masuk dengan akun jika klien Anda mendukungnya. **Uang baru keluar setelah pratinjau.** Tiga tool yang memakan biaya tidak pernah menagih pada panggilan pertama. Tool ini mengembalikan pratinjau bertanda `dry_run`, dan baru menagih saat dipanggil lagi dengan `confirm=true` — yang hanya dilakukan agen yang cermat setelah Anda bilang setuju.