Hubungkan agen AI Anda ke ProxyJam

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.

Pilih klien 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.

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.

Anthropic

Claude

claude.ai, Claude Desktop, dan aplikasi seluler. Tambahkan ProxyJam sekali sebagai konektor kustom, dan konektor itu muncul di ketiganya.

Tampilkan penyiapanSembunyikan penyiapanMasuk akun

Claude

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.

claude.ai, Claude Desktop, dan aplikasi seluler berbagi satu daftar konektor.

Panduan lengkap di dokumentasi

Anthropic

Claude Code

Agen coding Anthropic untuk terminal. Satu perintah untuk menambahkan server, lalu /mcp untuk masuk.

Tampilkan penyiapanSembunyikan penyiapanMasuk akun

Claude Code

claude mcp add --transport http proxyjam https://proxyjam.com/mcp

Jalankan di terminal, lalu ketik /mcp di Claude Code, pilih proxyjam, dan masuk. Tambahkan --scope user agar bisa dipakai di setiap proyek.

Panduan lengkap di dokumentasi

Anysphere

Cursor

Editor kode berbasis AI. Tambahkan server ke mcp.json, dan Cursor meminta Anda masuk saat pertama kali terhubung.

Tampilkan penyiapanSembunyikan penyiapanMasuk akun

Cursor

{
  "mcpServers": {
    "proxyjam": {
      "url": "https://proxyjam.com/mcp"
    }
  }
}

~/.cursor/mcp.json, atau .cursor/mcp.json di dalam proyek. Cursor meminta Anda masuk saat pertama kali terhubung.

Panduan lengkap di dokumentasi

OpenAI

ChatGPT

Konektor kustom memerlukan mode developer, yang ditawarkan OpenAI sebagai beta di sebagian paket.

Tampilkan penyiapanSembunyikan penyiapanMasuk akun

ChatGPT

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.

ChatGPT mengidentifikasi dirinya lalu membuka halaman masuk ProxyJam.

Panduan lengkap di dokumentasi

OpenAI

Codex CLI

Agen coding OpenAI untuk terminal. Dua perintah: tambahkan server, lalu masuk.

Tampilkan penyiapanSembunyikan penyiapanMasuk akun

Codex CLI

codex mcp add proxyjam --url https://proxyjam.com/mcp
codex mcp login proxyjam

Jalankan keduanya di terminal; perintah kedua membuka browser Anda untuk masuk.

Panduan lengkap di dokumentasi

Microsoft

VS Code

Mode agen di Copilot Chat. Terhubung dengan kunci API, yang diminta VS Code sekali lalu disimpan dengan aman.

Tampilkan penyiapanSembunyikan penyiapanKunci API

VS Code

{
  "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}" }
    }
  }
}

.vscode/mcp.json, dengan kunci API. VS Code meminta kunci sekali dan menyimpannya dengan aman.

Panduan lengkap di dokumentasi

Google

Gemini CLI

Agen Google untuk terminal. Tambahkan server, lalu jalankan /mcp auth proxyjam untuk masuk.

Tampilkan penyiapanSembunyikan penyiapanMasuk akun

Gemini CLI

gemini mcp add --transport http proxyjam https://proxyjam.com/mcp

Jalankan di terminal, lalu ketik /mcp auth proxyjam di Gemini CLI untuk masuk.

Panduan lengkap di dokumentasi

OpenAI

OpenAI Agents SDK

Framework Python untuk membangun agen Anda sendiri. Terhubung dengan kunci API di header permintaan.

Tampilkan penyiapanSembunyikan penyiapanKunci API

OpenAI Agents SDK

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())

Python, dengan kunci API. pip install openai-agents.

Panduan lengkap di dokumentasi

Prefect

FastMCP

Library Python untuk klien dan server MCP. Masuk lewat browser Anda dan menampilkan daftar tool.

Tampilkan penyiapanSembunyikan penyiapanMasuk akun

FastMCP

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())

Python. pip install fastmcp. Masuk lewat browser Anda dan menampilkan daftar tool.

Panduan lengkap di dokumentasi

Singkatnya: 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.

MCP, atau Model Context Protocol, 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.

YANG BISA DILAKUKAN AGEN ANDA

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.

KEAMANAN

Uang hanya keluar atas perintah Anda

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.
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.
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.
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.
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.
Akses berakhir saat Anda mencabutnya. Klien yang masuk lewat akun tercantum di Aplikasi terhubung pada pengaturan dasbor; 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.

PENYIAPAN

Terhubung dalam tiga langkah

Tambahkan server ke klien Anda
Pilih klien Anda di atas dan salin konfigurasinya. Alamatnya https://proxyjam.com/mcp.
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 sebagai gantinya: kunci ini diawali pj_ dan hanya ditampilkan sekali.
Mulai dengan prompt yang hanya membaca
Minta daftar penawaran lebih dulu — katalog aktif yang sama dengan halaman proxy residensial statis (ISP). Ini membuktikan koneksinya berjalan dan memberi agen ID penawaran yang dibutuhkannya untuk langkah lain. Setelah itu, coba prompt di bawah.

Lewat server MCP ProxyJam, tampilkan daftar penawaran proxy residensial statis (ISP) di Amerika Serikat beserta harga bulanannya. Jangan memesan apa pun.

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 pesanan ProxyJam saya ORDER_ID selama satu bulan. Tunjukkan pratinjau berisi harga dan saldo saya, lalu tunggu persetujuan saya sebelum mengonfirmasi.

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.

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.

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.

PROMPT

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. Beli dengan pratinjau Baru menagih setelah Anda setuju. Perpanjang Perpanjang pesanan, pratinjau dulu. Pemakaian dan saldo Pesanan, trafik, dan uang dalam satu jawaban. Pengaturan Perubahan yang tidak dikenai biaya. Aturan agen Untuk CLAUDE.md, AGENTS.md, atau Cursor rules.

REFERENSI

Semua 16 tool

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.
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

SERVER

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

DOKUMENTASI

Baca lebih lanjut

Panduan server MCP Argumen setiap tool dan contoh pemesanan lengkap

Mulai cepat Dari pendaftaran hingga panggilan API pertama

Autentikasi Membuat, memberi masa berlaku, dan mencabut kunci

Idempotensi Cara percobaan ulang terhindar dari tagihan ganda

Referensi API Setiap endpoint REST, bisa dijalankan langsung di browser

Spesifikasi OpenAPI Deskripsi API untuk generator kode

FAQ

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 — transport Streamable HTTP yang digunakan server ini
Kartu server MCP — endpoint, transport, dan autentikasi, untuk agen yang menemukan ProxyJam dengan sendirinya
auth.md — cara agen masuk, mendaftar, atau memakai kunci API
Metadata server otorisasi OAuth — endpoint dan scope yang ditemukan klien saat masuk
Skill agen ProxyJam — panduan penggunaan yang bisa dimuat agen sebelum panggilan pertamanya

Hubungkan agen AI Anda ke ProxyJam

Pilih klien Anda

Claude

Claude Code

Cursor

ChatGPT

Codex CLI

VS Code

Gemini CLI

OpenAI Agents SDK

FastMCP

Enam belas tool, enam pekerjaan

Jelajahi katalog

Pesan proxy

Perpanjang dan tambah trafik

Cek pesanan dan trafik

Pantau keuangan

Ubah pengaturan

Uang hanya keluar atas perintah Anda

Terhubung dalam tiga langkah

Tambahkan server ke klien Anda

Masuk dan tentukan apa yang boleh dilakukannya

Mulai dengan prompt yang hanya membaca

Prompt untuk dicoba

Semua 16 tool

Detail koneksi

Baca lebih lanjut

Pertanyaan tentang server MCP

Mulai dari yang kecil

Sumber