# Máy chủ MCP cho AI agent | ProxyJam Kết nối Claude, Cursor và các client MCP khác với tài khoản ProxyJam: tìm gói, đặt mua, gia hạn proxy, theo dõi lưu lượng. Mua gì cũng chờ bạn đồng ý. - Canonical: https://proxyjam.com/vi/mcp/ - Updated: 2026-10-14 - Language: vi 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. ProxyJam vận hành một máy chủ MCP từ xa tại `https://proxyjam.com/mcp` qua 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. ## Mười sáu công cụ, sáu việc ### 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. ### Đặt mua proxy 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. ### Gia hạn và mua thêm lưu lượng 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. ### Xem đơn hàng và lưu lượng 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. ### Theo dõi dòng tiề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. ### Thay đổi cài đặt 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. ## Chỉ trừ tiền khi bạn đồng ý 1. **Mặc định chỉ đọc.** Khi một client đăng nhập, ProxyJam cho bạn thấy nó xin những quyền gì. Quyền đọc đơn hàng, ví và danh mục được cấp chung một lần — và đơn hàng có chứa tên đăng nhập và mật khẩu proxy của bạn. Quyền chi tiêu là một ô riêng, *Cho phép chi tiêu từ ví của tôi*, mặc định để trống, và ô này cũng bao gồm các thay đổi cài đặt miễn phí. 2. **Xem trướ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. 3. **Bạn đồng ý rồi mới trừ tiền.** Agent chỉ gọi lại với `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. 4. **Không trừ tiền hai lần.** Lần gọi xác nhận dùng lại `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. 5. **Khóa API mở toàn bộ tài khoản.** Khóa tạo từ bảng điều khiển không thể giới hạn quyền: khóa nào cũng vừa đọc vừa chi tiêu được. Hãy đăng nhập nếu client của bạn hỗ trợ, và đặt ngày hết hạn cho mọi khóa bạn dùng. 6. **Thu hồi là mất quyền truy cập.** Client đã đăng nhập được liệt kê trong mục *Ứng dụng đã kết nối* ở [phần cài đặt của bảng điều khiển](https://app.proxyjam.com/settings); thu hồi ở đó và client sẽ ngừng hoạt động trong vòng năm phút. Đổi mật khẩu hoặc đăng xuất khỏi mọi thiết bị sẽ thu hồi tất cả kết nối. Khóa API ngừng hoạt động khi bạn xóa nó trên [trang Khóa API](https://app.proxyjam.com/apikey). ## Kết nối trong ba bước 1. **Thêm máy chủ vào client** Chọn client của bạn ở trên và sao chép cấu hình. Địa chỉ là `https://proxyjam.com/mcp`. 2. **Đăng nhập và chọn quyền** 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](https://app.proxyjam.com/apikey): khóa bắt đầu bằng `pj_` và chỉ hiển thị một lần. 3. **Bắt đầu bằng một prompt chỉ đọc** 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)](/vi/isp-proxies/). 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. ## Chọn client của bạn 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 (Anthropic) claude.ai, Claude Desktop và ứng dụng di động dùng chung một danh sách connector. 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. Hướng dẫn đầy đủ trong tài liệu: https://docs.proxyjam.com/mcp-server#claude-ai-and-claude-desktop ### Claude Code (Anthropic) Chạ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. ``` claude mcp add --transport http proxyjam https://proxyjam.com/mcp ``` Hướng dẫn đầy đủ trong tài liệu: https://docs.proxyjam.com/mcp-server#claude-code ### Cursor (Anysphere) ~/.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. ``` { "mcpServers": { "proxyjam": { "url": "https://proxyjam.com/mcp" } } } ``` Hướng dẫn đầy đủ trong tài liệu: https://docs.proxyjam.com/mcp-server#cursor ### ChatGPT (OpenAI) ChatGPT tự đăng ký với máy chủ và mở trang đăng nhập ProxyJam. 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. Hướng dẫn đầy đủ trong tài liệu: https://docs.proxyjam.com/mcp-server#chatgpt ### Codex CLI (OpenAI) Chạy cả hai lệnh trong terminal; lệnh thứ hai mở trình duyệt để bạn đăng nhập. ``` codex mcp add proxyjam --url https://proxyjam.com/mcp codex mcp login proxyjam ``` Hướng dẫn đầy đủ trong tài liệu: https://docs.proxyjam.com/mcp-server#codex-cli ### VS Code (Microsoft) .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. ``` { "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}" } } } } ``` Hướng dẫn đầy đủ trong tài liệu: https://docs.proxyjam.com/mcp-server#vs-code ### Gemini CLI (Google) Chạy lệnh trong terminal, rồi gõ /mcp auth proxyjam trong Gemini CLI để đăng nhập. ``` gemini mcp add --transport http proxyjam https://proxyjam.com/mcp ``` Hướng dẫn đầy đủ trong tài liệu: https://docs.proxyjam.com/mcp-server#gemini-cli ### OpenAI Agents SDK (OpenAI) Python, dùng khóa 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()) ``` Hướng dẫn đầy đủ trong tài liệu: https://docs.proxyjam.com/mcp-server#openai-agents-sdk ### FastMCP (Prefect) Python. pip install fastmcp. Đă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()) ``` Hướng dẫn đầy đủ trong tài liệu: https://docs.proxyjam.com/mcp-server#generic-fastmcp-client-python ## Prompt để thử ngay 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. ### Tìm proxy Chỉ đọc, an toàn để thử đầu tiên. 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ả. ### Mua có xem trước Chỉ trừ tiền khi bạn đồng ý. Đặ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 Gia hạn đơn hàng, xem trước đã. 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. ### Lưu lượng và số dư Đơn hàng, lưu lượng và tiền trong một câu trả lời. 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. ### Cài đặt Những thay đổi không tốn tiền. 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. ### Quy tắc cho agent Dành cho CLAUDE.md, AGENTS.md hoặc Cursor rules. 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ẻ. ## Toàn bộ 16 công cụ | 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í | Các công cụ máy chủ đang cung cấp hiện nay. Ba công cụ tiêu tiền chỉ trả về bản xem trước cho đến khi được gọi lại với confirm=true. Client đăng nhập bằng tài khoản chỉ gọi được bảy công cụ cuối nếu bạn đã cho phép chi tiêu. ## Thông số kết nối - **Endpoint:** https://proxyjam.com/mcp - **Giao thức truyền tải:** Streamable HTTP - **Xác thực:** Đăng nhập bằng tài khoản ProxyJam (OAuth 2.1), hoặc khóa API trong header X-API-Key - **Quyền truy cập:** Mặc định chỉ đọc; chi tiêu và thay đổi cài đặt chỉ khi bạn cho phép - **Danh sách tham chiếu:** Trạng thái đơn hàng, loại tiền, giao thức proxy, loại gói và phương thức thanh toán, dưới dạng MCP resource - **Giá:** Miễn phí. Bạn chỉ trả tiền cho proxy bạn đặt mua ## Câu hỏi về máy chủ MCP ### Những AI client nào kết nối được? 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. ### Tôi có kết nối được với claude.ai hoặc ChatGPT không? 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. ### Máy chủ MCP có mất phí không? 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. ### Agent có thể tiêu tiền mà không hỏi tôi không? 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. ### Agent không làm được gì qua MCP? 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. ### Tôi có cần khóa API không? 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ế. ### Làm sao để cho phép chi tiêu sau này, hoặc rút lại quyền đó? 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. ### Làm sao để thu hồi quyền truy cập của agent? 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. ### Agent có thể tự đăng ký khô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. ## Bắt đầu từ việc nhỏ Hãy kết nối, hỏi danh sách gói và đọc kỹ kết quả trả về trước khi để agent đặt mua bất cứ thứ gì. Đến lúc mua, bản xem trước sẽ hiển thị gói, giá và số dư của bạn, và không khoản nào bị trừ cho đến khi bạn đồng ý. ## Nguồn - [Model Context Protocol — Transports](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports) — giao thức truyền tải Streamable HTTP mà máy chủ này sử dụng - [Thẻ máy chủ MCP](/.well-known/mcp/server-card.json) — endpoint, giao thức truyền tải và phương thức xác thực, dành cho agent tự tìm đến ProxyJam - [auth.md](/auth.md) — cách agent đăng nhập, đăng ký hoặc dùng khóa API - [Siêu dữ liệu máy chủ ủy quyền OAuth](/.well-known/oauth-authorization-server) — các endpoint và scope mà client tìm thấy khi đăng nhập - [Skill agent của ProxyJam](/.well-known/agent-skills/proxyjam/SKILL.md) — hướng dẫn sử dụng mà agent có thể nạp trước lần gọi đầu tiên MCP, tức [Model Context Protocol](https://modelcontextprotocol.io/), 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 ý.