Duyệt danh mục
list_offers tìm các gói đang mở bán theo loại, quốc gia, vùng và thành phố, rồi trả về mọi biểu giá kèm giá tiền. Đây là nguồn duy nhất cung cấp mã gói (offer id), nên giao dịch mua nào cũng bắt đầu từ đây.
Máy chủ MCP của ProxyJam trao cho Claude, Cursor và các AI client khác 16 công cụ làm việc trên tài khoản của bạn: tìm gói, đặt mua và gia hạn proxy, xem lưu lượng và số dư. Bạn đăng nhập và tự chọn agent được phép làm gì, còn mọi thao tác tốn tiền đều cho bạn xem trước và chờ bạn đồng ý.
Bạn cần có tài khoản ProxyJam. Hầu hết client đăng nhập bằng tài khoản đó; số còn lại dùng khóa API. Bản thân máy chủ miễn phí; bạn chỉ trả tiền cho proxy mà agent đặt mua.
Chọn một client để xem cách kết nối. Phần lớn client đăng nhập bằng tài khoản ProxyJam của bạn; VS Code và OpenAI Agents SDK dùng khóa API, nên hãy thay pj_... bằng khóa của bạn.
claude.ai, Claude Desktop và ứng dụng di động. Chỉ cần thêm ProxyJam một lần dưới dạng connector tùy chỉnh là nó có mặt ở cả ba.
1. Trong Claude, mở phần cài đặt Connectors và thêm một connector tùy chỉnh.
2. Đặt tên là ProxyJam và dán https://proxyjam.com/mcp vào ô địa chỉ máy chủ.
3. Nhấn kết nối, đăng nhập ProxyJam và phê duyệt.claude.ai, Claude Desktop và ứng dụng di động dùng chung một danh sách connector.
Hướng dẫn đầy đủ trong tài liệuCoding agent của Anthropic chạy trong terminal. Một lệnh là thêm xong máy chủ, còn /mcp sẽ đưa bạn qua bước đăng nhập.
claude mcp add --transport http proxyjam https://proxyjam.com/mcpChạy lệnh trong terminal, rồi gõ /mcp trong Claude Code, chọn proxyjam và đăng nhập. Thêm --scope user để dùng trong mọi dự án.
Hướng dẫn đầy đủ trong tài liệuTrình soạn thảo code tích hợp AI. Thêm máy chủ vào mcp.json, và Cursor sẽ yêu cầu bạn đăng nhập ở lần kết nối đầu tiên.
{
"mcpServers": {
"proxyjam": {
"url": "https://proxyjam.com/mcp"
}
}
}
~/.cursor/mcp.json, hoặc .cursor/mcp.json trong một dự án. Cursor yêu cầu bạn đăng nhập khi kết nối lần đầu.
Hướng dẫn đầy đủ trong tài liệuConnector tùy chỉnh cần bật chế độ nhà phát triển (developer mode), tính năng OpenAI đang cung cấp dưới dạng beta cho một số gói.
1. Trong phần cài đặt của ChatGPT, bật chế độ nhà phát triển và tạo một connector tùy chỉnh.
2. Nhập https://proxyjam.com/mcp làm URL và chọn OAuth.
3. Đăng nhập ProxyJam và phê duyệt.ChatGPT tự đăng ký với máy chủ và mở trang đăng nhập ProxyJam.
Hướng dẫn đầy đủ trong tài liệuCoding agent của OpenAI chạy trong terminal. Chỉ hai lệnh: thêm máy chủ, rồi đăng nhập.
codex mcp add proxyjam --url https://proxyjam.com/mcp
codex mcp login proxyjamChạy cả hai lệnh trong terminal; lệnh thứ hai mở trình duyệt để bạn đăng nhập.
Hướng dẫn đầy đủ trong tài liệuChế độ agent trong Copilot Chat. Kết nối bằng khóa API — VS Code chỉ hỏi khóa một lần và lưu trữ an toàn.
{
"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, dùng khóa API. VS Code chỉ hỏi khóa một lần và lưu trữ an toàn.
Hướng dẫn đầy đủ trong tài liệuAgent của Google chạy trong terminal. Thêm máy chủ, rồi chạy /mcp auth proxyjam để đăng nhập.
gemini mcp add --transport http proxyjam https://proxyjam.com/mcpChạy lệnh trong terminal, rồi gõ /mcp auth proxyjam trong Gemini CLI để đăng nhập.
Hướng dẫn đầy đủ trong tài liệuFramework Python để tự xây dựng agent. Kết nối bằng khóa API đặt trong header của yêu cầu.
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, dùng khóa API. pip install openai-agents.
Hướng dẫn đầy đủ trong tài liệuThư viện Python để viết client và server MCP. Đăng nhập qua trình duyệt và liệt kê các công cụ.
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. Đăng nhập qua trình duyệt và liệt kê các công cụ.
Hướng dẫn đầy đủ trong tài liệuTóm lại: ProxyJam vận hành một máy chủ MCP từ xa tại
https://proxyjam.com/mcpqua Streamable HTTP. AI client của bạn hoặc đăng nhập bằng tài khoản ProxyJam (OAuth), hoặc gửi khóa API, và nhận 16 công cụ: chín công cụ chỉ đọc, bốn công cụ thay đổi cài đặt và ba công cụ tiêu tiền — ba công cụ này chỉ trả về bản xem trước cho đến khi bạn xác nhận.
MCP, tức Model Context Protocol, là tiêu chuẩn mở mà các trợ lý AI dùng để gọi công cụ bên ngoài. Chỉ cần trỏ một client MCP tới máy chủ của ProxyJam, agent của bạn đã có thể làm trên tài khoản hầu hết những gì một khóa API làm được qua REST API. Có hai điều nên biết trước khi bắt đầu.
Bạn quyết định agent được làm gì. Client đăng nhập bằng tài khoản sẽ xin bạn phê duyệt trước. Quyền đọc được cấp trọn gói, bao gồm cả tên đăng nhập và mật khẩu proxy của bạn; quyền chi tiêu từ ví, đi kèm là các thay đổi cài đặt miễn phí, nằm ở một ô riêng mà bạn chỉ đánh dấu nếu muốn agent hành động. Khóa API thì khác: nó mở toàn bộ tài khoản, nên hãy ưu tiên đăng nhập nếu client hỗ trợ.
Tiền chỉ bị trừ sau bản xem trước. Ba công cụ tốn tiền không bao giờ trừ tiền ở lần gọi đầu. Chúng trả về một bản xem trước được đánh dấu dry_run, và chỉ trừ tiền khi được gọi lại với confirm=true — việc mà một agent cẩn thận chỉ làm sau khi bạn đồng ý.
list_offers tìm các gói đang mở bán theo loại, quốc gia, vùng và thành phố, rồi trả về mọi biểu giá kèm giá tiền. Đây là nguồn duy nhất cung cấp mã gói (offer id), nên giao dịch mua nào cũng bắt đầu từ đây.
create_proxy_order mua từ 1 đến 50 proxy của một gói. Lần gọi đầu chỉ hiển thị giá và số dư của bạn; đơn hàng chỉ được đặt khi bạn xác nhận.
extend_proxy_period gia hạn proxy thêm một kỳ, còn buy_proxy_bandwidth mua thêm lưu lượng cho proxy tĩnh. Cả hai đều cho xem trước và chỉ trừ tiền khi bạn xác nhận.
Các đơn hàng của bạn kèm thông tin kết nối, cùng lưu lượng mà từng proxy hoặc tất cả proxy cộng lại đã dùng. Chỉ đọc, nên agent gọi bao nhiêu lần cũng an toàn.
Số dư ví theo từng loại tiền và toàn bộ lịch sử giao dịch, xem từng giao dịch một hoặc cả trang một lúc. Cũng chỉ đọc.
Chuyển proxy giữa HTTP và SOCKS5, thay danh sách IP cho phép, bật hoặc tắt tự động gia hạn, hoặc làm mới trạng thái proxy. Không thao tác nào tốn tiền, nhưng client đăng nhập bằng tài khoản phải được cho phép chi tiêu mới thực hiện được.
create_proxy_order, extend_proxy_period và buy_proxy_bandwidth bắt đầu với confirm=false: chúng trả về gói, giá và số dư của bạn, không trừ đồng nào.confirm=true sau khi bạn duyệt bản xem trước. Bộ quy tắc cho agent trong các prompt bên dưới nói rõ điều này.idempotency_key của bản xem trước, nên một yêu cầu bị gửi lại sẽ nhận kết quả của lần đầu thay vì mua thêm lần nữa. Mỗi giao dịch mua mới dùng một khóa mới.Chọn client của bạn ở trên và sao chép cấu hình. Địa chỉ là https://proxyjam.com/mcp.
Client mở ProxyJam trong trình duyệt. Hãy đăng nhập, đọc những quyền mà client xin, và chỉ đánh dấu Cho phép chi tiêu từ ví của tôi nếu agent cần đặt mua, gia hạn hoặc thay đổi cài đặt. Mỗi lần phê duyệt sẽ thay thế lần trước, nên sau này bạn có thể kết nối lại để đổi ý. Client không đăng nhập được thì dùng khóa API: khóa bắt đầu bằng pj_ và chỉ hiển thị một lần.
Hãy hỏi danh sách gói trước — đó cũng là danh mục đang mở bán trên trang proxy dân cư tĩnh (ISP). Bước này cho thấy kết nối đã hoạt động và cung cấp cho agent các mã gói cần cho mọi thao tác khác. Sau đó hãy thử các prompt bên dưới.
Dùng máy chủ MCP của ProxyJam, liệt kê các gói proxy dân cư tĩnh (ISP) tại Hoa Kỳ kèm giá theo tháng. Không đặt mua gì cả.Đặt mua một proxy dân cư tĩnh (ISP) tại Hoa Kỳ trong một tháng qua ProxyJam. Trước hết hãy cho tôi xem bản xem trước — gói, giá và số dư ví của tôi — và chờ tôi đồng ý rõ ràng rồi mới xác nhận. Khi xác nhận, hãy dùng lại đúng idempotency key đó.Gia hạn đơn hàng ProxyJam ORDER_ID của tôi thêm một tháng. Cho tôi xem bản xem trước với giá và số dư, và chờ tôi đồng ý rồi mới xác nhận.Liệt kê các proxy ProxyJam đang hoạt động của tôi kèm ngày hết hạn và lưu lượng từng proxy đã dùng, sau đó cho biết số dư ví USD và 10 giao dịch gần nhất của tôi.Với đơn hàng ProxyJam ORDER_ID của tôi: chuyển giao thức sang SOCKS5, đặt danh sách IP cho phép là 203.0.113.7 và bật tự động gia hạn. Sau đó cho tôi biết cài đặt mới.Khi dùng máy chủ MCP của ProxyJam:
- Luôn gọi list_offers trước tiên. Đây là nguồn duy nhất cung cấp offer id.
- create_proxy_order, extend_proxy_period và buy_proxy_bandwidth chỉ là bản xem trước cho đến khi có confirm=true. Hãy cho tôi xem bản xem trước và không bao giờ xác nhận khi tôi chưa đồng ý rõ ràng.
- Xác nhận bằng đúng idempotency_key của bản xem trước. Mỗi giao dịch mua mới dùng một key mới.
- Nếu bản xem trước cho thấy số dư thấp hơn giá, hãy dừng lại và báo cho tôi thay vì xác nhận.
- Nếu một công cụ bị từ chối vì chưa được phép chi tiêu, hãy báo cho tôi thay vì thử lại; tôi sẽ quyết định có kết nối lại với quyền chi tiêu hay không.
- Coi khóa API của tôi là bí mật: không bao giờ in ra, ghi vào log hay ghi vào tệp mà tôi có thể chia sẻ.Sau khi kết nối máy chủ, hãy dán một prompt vào khung chat của agent. Thay ORDER_ID bằng mã đơn hàng trong bảng điều khiển của bạn. Tab cuối là bộ quy tắc nên đặt sẵn trong phần chỉ dẫn của agent.
| Công cụ | Chức năng | Tác động |
|---|---|---|
| list_offers | Tìm trong danh mục theo loại, quốc gia, vùng và thành phố; trả về mã gói và biểu giá | Chỉ đọc |
| list_my_orders | Liệt kê các đơn proxy của bạn, theo từng trang | Chỉ đọc |
| get_order | Toàn bộ chi tiết một đơn hàng, kể cả thông tin kết nối proxy | Chỉ đọc |
| get_my_traffic_summary | Lưu lượng đã dùng trên tất cả proxy đang hoạt động | Chỉ đọc |
| get_order_traffic | Lưu lượng đã dùng của một đơn hàng | Chỉ đọc |
| list_my_wallets | Các ví của bạn, mỗi loại tiền một ví | Chỉ đọc |
| get_wallet_balance | Số dư của một ví | Chỉ đọc |
| list_wallet_transactions | Lịch sử giao dịch của một ví, theo từng trang | Chỉ đọc |
| get_transaction | Một giao dịch | Chỉ đọc |
| create_proxy_order | Mua từ 1 đến 50 proxy của một gói | Tốn tiền, có xem trước |
| extend_proxy_period | Gia hạn một proxy đang hoạt động thêm một kỳ | Tốn tiền, có xem trước |
| buy_proxy_bandwidth | Mua thêm từ 1 đến 5.000 GB lưu lượng cho proxy tĩnh | Tốn tiền, có xem trước |
| set_auto_renew | Bật hoặc tắt tự động gia hạn | Đổi cài đặt, miễn phí |
| set_proxy_whitelist | Thay danh sách IP được phép dùng proxy | Đổi cài đặt, miễn phí |
| change_proxy_protocol | Chuyển giữa HTTP và SOCKS5 | Đổi cài đặt, miễn phí |
| sync_proxy_state | Đọc lại trạng thái hiện tại của proxy | Đổi cài đặt, miễn phí |
Bất kỳ client MCP nào kết nối tới máy chủ từ xa qua Streamable HTTP và hỗ trợ đăng nhập OAuth hoặc cho phép bạn thêm header vào yêu cầu. Các cấu hình ở trên bao gồm Claude (claude.ai, Claude Desktop và ứng dụng di động), Claude Code, Cursor, ChatGPT, VS Code, Codex CLI, Gemini CLI, OpenAI Agents SDK và FastMCP.
Có. Trong Claude, hãy thêm một connector tùy chỉnh với địa chỉ https://proxyjam.com/mcp, rồi đăng nhập ProxyJam; connector này cũng xuất hiện trong Claude Desktop và ứng dụng di động. Trong ChatGPT, connector MCP tùy chỉnh cần bật chế độ nhà phát triển, tính năng OpenAI đang cung cấp dưới dạng beta cho một số gói; thêm cùng địa chỉ đó và chọn OAuth.
Không. Kết nối và gọi công cụ đều miễn phí. Bạn chỉ trả tiền cho những gì agent đặt mua, với cùng mức giá như trên bảng điều khiển, bằng tiền trong ví ProxyJam.
Không thể xảy ra ngoài ý muốn. Client đăng nhập bằng tài khoản hoàn toàn không chi tiêu được, trừ khi bạn đã đánh dấu *Cho phép chi tiêu từ ví của tôi* lúc phê duyệt. Ngay cả khi đó, ba công cụ tính tiền — đặt mua, gia hạn và mua lưu lượng — chỉ trả về bản xem trước ở lần gọi đầu và chỉ trừ tiền khi được gọi lại với confirm=true; một agent cẩn thận sẽ cho bạn xem bản xem trước rồi chờ, và bộ quy tắc cho agent ở trên yêu cầu đúng như vậy. Khóa API không có giới hạn chi tiêu, nên hãy giao cho agent một khóa mà bạn có thể xóa.
Nạp tiền vào ví, quản lý khóa API, thay đổi cài đặt tài khoản, kiểm tra địa chỉ IP, hay dùng các thao tác dành cho proxy di động như đặt lại IP. Những việc đó vẫn làm trong bảng điều khiển và qua REST API.
Không, nếu client của bạn đăng nhập được. Yêu cầu không kèm phiên đăng nhập lẫn khóa sẽ bị từ chối, kèm chỉ dẫn tới trang đăng nhập ProxyJam — nhờ đó claude.ai, Claude Code, Cursor và các client khác tự bắt đầu quy trình đăng nhập. Client nào không đăng nhập được thì gửi khóa API thay thế.
Kết nối lại và phê duyệt với ô được đánh dấu hoặc để trống: mỗi lần phê duyệt thay thế lần trước. Ví dụ trong Claude Code, bạn gõ /mcp rồi đăng nhập lại vào proxyjam.
Với client đã đăng nhập, hãy thu hồi trong mục Ứng dụng đã kết nối ở phần cài đặt của bảng điều khiển; client sẽ ngừng hoạt động trong vòng năm phút, còn các kết nối khác của bạn vẫn chạy bình thường. Đổi mật khẩu hoặc đăng xuất khỏi mọi thiết bị sẽ thu hồi tất cả cùng lúc. Với khóa API, hãy xóa khóa trên trang Khóa API; khóa được tạo kèm ngày hết hạn cũng sẽ tự ngừng hoạt động.
Có, nhưng có giới hạn. Một agent chưa gắn với tài khoản nào có thể tự đăng ký và nhận một khóa chỉ đọc được danh mục công khai. Nếu bạn xác nhận quyền sở hữu khóa đó bằng mã ProxyJam gửi qua email, khóa sẽ gắn vào tài khoản của bạn và đọc được đơn hàng cùng ví của bạn, nhưng không bao giờ chi tiêu được. Các bước dành cho agent có trong auth.md.