Máy chủ MCP của WeProxy: cài đặt cho Claude, Cursor và VS Code

Máy chủ MCP của WeProxy là một endpoint Model Context Protocol công khai, chỉ đọc, cho phép các trợ lý AI như Claude, Cursor và VS Code đọc sản phẩm, giá gói, phạm vi quốc gia và mã lỗi proxy của WeProxy trực tiếp từ dữ liệu trên website. Địa chỉ là https://weproxy.io/api/mcp, phương thức truyền tải là Streamable HTTP; không cần API key hay tài khoản.

Khi trợ lý nhận câu hỏi như “Nên dùng proxy nào để quản lý tài khoản Instagram ở Thổ Nhĩ Kỳ?” hoặc “Tôi gặp lỗi 407, phải làm gì?”, nó sẽ gọi máy chủ này thay vì phỏng đoán. Giá và vị trí trong câu trả lời lấy từ cùng nguồn với trang bảng giá.

MCP là gì?

Model Context Protocol (MCP) là một giao thức mở giúp các ứng dụng AI kết nối với công cụ và nguồn dữ liệu bên ngoài theo một cách chuẩn hóa. Máy chủ MCP công bố danh sách công cụ (tool); dựa trên câu hỏi của người dùng, trợ lý chọn một công cụ, điền tham số và đưa dữ liệu có cấu trúc trả về vào câu trả lời. Chi tiết về giao thức có trong tài liệu chính thức tại modelcontextprotocol.io.

Máy chủ MCP của WeProxy triển khai tiêu chuẩn này. Trợ lý bạn kết nối có thể đọc danh mục WeProxy mới nhất ở mỗi câu hỏi, không phải dựa vào dữ liệu huấn luyện cũ hay danh sách của bên thứ ba.

Có những công cụ nào?

Máy chủ công bố bảy công cụ. Tất cả đều chỉ đọc: không đặt hàng, không truy cập tài khoản của bạn và không nhận thanh toán.

Hầu hết công cụ nhận tham số locale (tr, en, ru, de, vi). Trợ lý điền giá trị này theo ngôn ngữ cuộc trò chuyện; tên sản phẩm và liên kết sẽ được trả về bằng ngôn ngữ đó.

Thêm vào Claude như thế nào?

Trong ứng dụng Claude trên web và máy tính, máy chủ MCP từ xa được thêm dưới dạng trình kết nối tùy chỉnh (custom connector):

1. Trong Claude, mở mục Cài đặt → Trình kết nối (Settings → Connectors).
2. Nhấp Thêm trình kết nối tùy chỉnh (Add custom connector).
3. Nhập tên WeProxy, URL https://weproxy.io/api/mcp rồi lưu. Không cần xác thực.
4. Trong một cuộc trò chuyện mới, kiểm tra trình kết nối đã được bật và đặt một câu hỏi liên quan đến WeProxy.

Giao diện và khả năng sử dụng tùy chọn thêm trình kết nối có thể khác nhau tùy gói Claude và cài đặt tổ chức của bạn. Xem các bước mới nhất tại trung tâm trợ giúp Claude.

Thêm vào Claude Code như thế nào?

Chỉ cần một lệnh trong terminal:

claude mcp add --transport http weproxy https://weproxy.io/api/mcp

Sau khi thêm, chạy claude mcp list để xác nhận máy chủ đã kết nối. Trong phiên Claude Code, yêu cầu như “Lấy giá residential proxy của WeProxy cho Thổ Nhĩ Kỳ” sẽ gọi công cụ get_pricing.

Thêm vào Cursor và VS Code như thế nào?

Cursor: Thêm mục sau vào tệp .cursor/mcp.json ở thư mục gốc dự án (chỉ cho dự án đó) hoặc ~/.cursor/mcp.json trong thư mục người dùng (cho mọi dự án):

{
  "mcpServers": {
    "weproxy": {
      "url": "https://weproxy.io/api/mcp"
    }
  }
}

Kiểm tra máy chủ hiển thị màu xanh (đã kết nối) trong mục MCP của phần cài đặt Cursor.

VS Code: Tạo tệp .vscode/mcp.json trong workspace:

{
  "servers": {
    "weproxy": {
      "type": "http",
      "url": "https://weproxy.io/api/mcp"
    }
  }
}

Với các MCP client khác, quy tắc cũng vậy: truyền tải Streamable HTTP, địa chỉ https://weproxy.io/api/mcp. Để kiểm tra kết nối độc lập với client, bạn có thể dùng công cụ chính thức MCP Inspector (npx @modelcontextprotocol/inspector).

Các tình huống sử dụng mẫu

• Chọn sản phẩm: Với câu hỏi “Tôi cần quản lý vài tài khoản mạng xã hội ở Thổ Nhĩ Kỳ, nên dùng proxy nào?”, trợ lý gọi recommend_proxy với purpose: social, country: TR và trả về kèm liên kết các sản phẩm được liệt kê cho mục đích mạng xã hội và bao phủ Thổ Nhĩ Kỳ.
• So sánh giá: Với yêu cầu “So sánh gói 10 GB của rotating residential và rotating datacenter”, get_pricing được gọi cho cả hai sản phẩm; giá trả về theo cùng định dạng như trên website.
• Chẩn đoán lỗi: Với tin nhắn “Tôi bị lỗi 407 trên proxy”, diagnose_proxy_error cho biết lỗi nằm ở tầng proxy, nguyên nhân có thể (sai thông tin đăng nhập, mật khẩu chưa được mã hóa, IP không nằm trong whitelist) và bước kiểm tra đầu tiên, đồng thời dẫn liên kết tới hướng dẫn mã lỗi proxy để xem chi tiết.
• Câu hỏi về phạm vi: Với câu hỏi “Có proxy di động ở Ba Lan không?”, check_location liệt kê các sản phẩm bao phủ quốc gia đó. Vì tồn kho theo thành phố không được lưu trong dữ liệu, công cụ không khẳng định gì về pool thành phố; với các sản phẩm hỗ trợ, thành phố được chọn trong bảng điều khiển khách hàng.

Bảo mật và giới hạn

• Chỉ đọc: Máy chủ không tạo đơn hàng, không đọc thông tin tài khoản và không nhận thanh toán. Việc mua luôn được thực hiện qua trang đặt hàng và bảng điều khiển khách hàng.
• Không yêu cầu thông tin đăng nhập: diagnose_proxy_error chỉ nhận mã lỗi. Đừng cung cấp URL proxy, tên người dùng hay mật khẩu cho trợ lý; máy chủ vốn không yêu cầu chúng.
• Không có dữ liệu bịa đặt: Thông tin giá, tồn kho và quốc gia lấy từ dữ liệu sản phẩm trên website. Khi được hỏi về thông tin không có trong dữ liệu (ví dụ pool thành phố), công cụ sẽ nói rõ điều đó.
• Giới hạn yêu cầu: Endpoint giới hạn 30 yêu cầu mỗi phút cho mỗi IP. Khi vượt giới hạn, máy chủ trả về 429 kèm Retry-After.
• Quy tắc sử dụng: Việc dùng proxy tuân theo chính sách sử dụng chấp nhận được; máy chủ MCP không thay đổi các quy tắc này.

Nếu muốn so sánh sản phẩm mà không dùng MCP, hướng dẫn mua proxy và bài so sánh các loại proxy là điểm khởi đầu tốt. Bạn có thể xác minh proxy đang kết nối hoạt động bằng proxy checker.

Câu hỏi thường gặp

Địa chỉ máy chủ MCP của WeProxy là gì?

Địa chỉ là https://weproxy.io/api/mcp, phương thức truyền tải là Streamable HTTP. Bạn thêm địa chỉ này vào Claude, Claude Code, Cursor, VS Code và các client hỗ trợ MCP khác. Không cần API key, tài khoản hay xác thực bổ sung; máy chủ công khai và chỉ đọc.

Máy chủ MCP của WeProxy có mất phí không?

Không. Máy chủ miễn phí và bạn không cần tài khoản WeProxy để dùng. Nó chỉ trả về thông tin danh mục, giá, phạm vi và hướng dẫn. Để thực sự dùng proxy, bạn vẫn cần mua một gói hoặc bắt đầu bản dùng thử Premium Rotating Residential 1 GB.

Máy chủ MCP có thể mua proxy hoặc truy cập tài khoản của tôi không?

Không. Mọi công cụ đều chỉ đọc; chúng không tạo đơn hàng, không nhận thanh toán và không truy cập bảng điều khiển khách hàng. Việc mua và thông tin proxy chỉ được quản lý trong bảng điều khiển khách hàng của WeProxy. Trợ lý có thể đưa liên kết sản phẩm hoặc đặt hàng, còn bạn tự hoàn tất giao dịch.

Giá mà trợ lý đưa ra có cập nhật không?

Có. Công cụ list_products và get_pricing đọc từ cùng dữ liệu sản phẩm mà trang bảng giá sử dụng và trả về giá theo định dạng của website. Không có bảng giá riêng. Khi thấy giá trong câu trả lời, bạn nên kiểm tra xem nó có đến từ lệnh gọi công cụ này không.

Tôi có cần đưa mật khẩu proxy cho trợ lý không?

Không, và bạn không nên làm vậy. Công cụ diagnose_proxy_error chỉ nhận mã lỗi; nó không yêu cầu URL proxy, tên người dùng hay mật khẩu. Vì thông tin đăng nhập có thể được lưu trong lịch sử trò chuyện, hãy chỉ gửi mã lỗi bạn nhận được.

Phải làm gì nếu kết nối không hoạt động?

Trước tiên, kiểm tra địa chỉ được nhập chính xác là https://weproxy.io/api/mcp và client hỗ trợ truyền tải Streamable HTTP. Nếu gửi nhiều yêu cầu trong thời gian ngắn, bạn có thể nhận 429 do giới hạn theo phút; hãy chờ một phút. Nếu vẫn lỗi, hãy kiểm tra bằng MCP Inspector hoặc liên hệ hỗ trợ.