Menu tài liệu

Máy chủ MCP cho trợ lý AI

Kết nối trợ lý AI lập trình với tài khoản Litport của bạn bằng máy chủ Model Context Protocol (MCP). Trợ lý liệt kê token proxy của bạn, đọc mức sử dụng và các khoản phí, tìm các quốc gia mà một pool có thể nhắm tới, và lắp ráp chuỗi kết nối proxy dùng được, mà bạn không cần tự viết HTTP client trước.

Máy chủ có thể xem token, mức sử dụng, gói, pool và chọn theo vị trí; tạo, thay đổi, cấp lại thông tin đăng nhập và xóa proxy trả theo GB (nhãn, bật/tắt, pool, ngày hết hạn, giới hạn lưu lượng); đọc mức sử dụng của nhiều proxy cùng lúc; đổi vị trí, chu kỳ xoay hoặc IP của token có thể di chuyển; quản lý IP được phép của gói; dựng URL proxy; và liên hệ hỗ trợ. Nó không thể mua, gia hạn hay hủy gói, nạp tiền hoặc chuyển số dư. Proxy trả theo GB mà nó tạo chỉ trừ số dư khi lưu lượng của chúng được tính phí; việc thanh toán gói từ số dư vẫn nằm trong bảng điều khiển. Hồ sơ VPN cũng được tạo trong bảng điều khiển; máy chủ không thể tạo hay thay đổi chúng. Yêu cầu IPv6 không được hỗ trợ; hãy liên hệ hỗ trợ.

Cài đặt#

Máy chủ chạy trên máy của bạn và giao tiếp với trang này qua HTTPS. Tạo API key trong Cài đặt, rồi thêm máy chủ vào MCP host của bạn. Gói là @litportnet/litport-mcp trên npm, mã nguồn nằm trên GitHub, và nó được liệt kê trong MCP Registry chính thức với tên io.github.litportnet/litport-mcp.

Claude Code:

claude mcp add litport --env LITPORT_API_KEY=lit_your_key_here -- npx -y @litportnet/litport-mcp

Codex:

codex mcp add litport --env LITPORT_API_KEY=lit_your_key_here -- npx -y @litportnet/litport-mcp

Lệnh đó ghi máy chủ vào ~/.codex/config.toml. Bạn cũng có thể thêm khối này bằng tay:

[mcp_servers.litport]
command = "npx"
args = ["-y", "@litportnet/litport-mcp"]

[mcp_servers.litport.env]
LITPORT_API_KEY = "lit_your_key_here"

Kiểm tra bằng codex mcp list, xem một mục bằng codex mcp get litport, và gỡ bằng codex mcp remove litport.

Claude Desktop, Cursor, Windsurf và các host khác chạy một tiến trình cục bộ dùng một khối cấu hình:

{
  "mcpServers": {
    "litport": {
      "command": "npx",
      "args": ["-y", "@litportnet/litport-mcp"],
      "env": { "LITPORT_API_KEY": "lit_your_key_here" }
    }
  }
}

Biến môi trường#

Biến Mặc định Tác dụng
LITPORT_API_KEY chưa đặt API key từ Cài đặt. Không phải tên người dùng hay mật khẩu proxy. Khi không có, chỉ các công cụ hỗ trợ và tài liệu được tải, và câu hỏi hỗ trợ đi vào một cuộc trò chuyện khách.
LITPORT_API_URL https://litport.net Ghi đè origin của API.
LITPORT_MCP_REVEAL_CREDENTIALS chưa đặt Đặt thành 1 để đưa mật khẩu proxy trực tiếp vào kết quả của list_tokens.

Công cụ#

Công cụ Chức năng Ghi
list_tokens Liệt kê token của bạn với loại, trạng thái và thông tin đầu vào. không
get_token_credentials Thông tin đăng nhập đầy đủ của một token. không
get_token_usage Lưu lượng và các thành phần phí của một token. không
get_usage Mức sử dụng hằng ngày của nhiều proxy cùng lúc trong một khoảng ngày, gồm cả proxy đã xóa, kèm khoản phí hằng ngày của proxy trả theo GB. không
get_token_location Đọc vị trí đã lưu và vị trí đang áp dụng của token có thể di chuyển. không
list_location_options Liệt kê các giá trị hiện dùng được cho trường vị trí tiếp theo của token. không
set_token_location Đổi vị trí của token có thể di chuyển, hoặc gửi random: true để lấy vị trí khác mà token dùng được ngay lúc này. có
set_rotation Đổi chu kỳ xoay của token xoay. có
get_new_ip Lấy IP mới trong cùng vị trí (datacenter/ISP). có
create_token Tạo proxy trả theo GB đang hoạt động, tùy chọn gắn với một pool, kèm nhãn, externalRef của riêng bạn, ngày hết hạn và giới hạn lưu lượng. Trả về thông tin đăng nhập của nó. có
update_token Đổi nhãn, công tắc bật/tắt, pool, ngày hết hạn hoặc giới hạn lưu lượng của proxy trả theo GB. Proxy của gói chỉ nhận nhãn. Không trả về thông tin đăng nhập. có
reissue_credentials Cấp tên người dùng, mật khẩu và khóa đổi IP mới cho proxy. Mật khẩu cũ ngừng hoạt động và các kết nối đang mở của nó bị đóng. có
delete_token Xóa proxy trả theo GB. Lịch sử và mức sử dụng của nó vẫn được giữ. có
list_packages Liệt kê các gói bạn sở hữu kèm trạng thái, sản phẩm, tiện ích bổ sung và ID token. không
get_package Đọc một gói. không
get_allowed_ips Đọc danh sách IP được phép của gói. không
set_allowed_ips Đặt toàn bộ danh sách IP được phép của gói. có
add_allowed_ip Thêm một IP vào danh sách IP được phép của gói. có
remove_allowed_ip Gỡ một IP khỏi danh sách IP được phép của gói. có
list_pools Các pool trả theo GB có thể chọn, kèm giá mỗi GB hiệu lực, cổng, hỗ trợ UDP (udp), hub đủ điều kiện và cấp độ geo. không
list_targeting_options Các quốc gia, vùng và thành phố mà một pool có thể nhắm tới. không
get_balance Số dư, đơn vị được giữ chỗ và gói cước. không
build_proxy_url Lắp ráp URL proxy dùng được với tham số geo và phiên. không
explain_proxy_error Chuyển mã lỗi proxy thành quyết định thử lại. không
search_docs Tìm trang tài liệu nói về một chủ đề. không
get_doc Đọc một trang tài liệu dưới dạng Markdown. không
contact_support Hỏi hỗ trợ Litport một câu hỏi. Có API key thì nó đi vào cuộc trò chuyện của tài khoản bạn; không có thì mở một cuộc trò chuyện khách và cần email của bạn. có
get_support_replies Đọc các tin nhắn mới trong cuộc trò chuyện hỗ trợ. không
reply_to_support Thêm một tin nhắn vào cuộc trò chuyện hỗ trợ. có

Mọi công cụ tài khoản có ghi đều cần cùng API key với mọi thao tác đọc; không có phạm vi ghi riêng. Các công cụ hỗ trợ chạy được với hoặc không có key: xem Liên hệ hỗ trợ. Việc mua, gia hạn hoặc hủy gói, và nạp tiền, vẫn nằm trong bảng điều khiển.

Khi API từ chối một lệnh gọi, văn bản lỗi của công cụ mang thông điệp và code của API, cùng retryable khi API có gửi. retryable: true nghĩa là chính lệnh gọi đó, gửi lại không đổi sau khi chờ, có thể thành công; false nghĩa là phải thay đổi điều gì đó trước.

explain_proxy_error trả lời dựa trên một bản sao của tài liệu tham chiếu lỗi proxy đi kèm trong gói, nên chẩn đoán lỗi không tốn gì và không tiêu hao giới hạn tần suất.

Cách xử lý mật khẩu proxy#

list_tokens là thao tác duyệt, nên mặc định nó che mật khẩu: mỗi token báo password: null với passwordSet: true. Nhờ vậy danh sách nhiều token không đưa mọi mật khẩu vào ngữ cảnh của trợ lý và, qua đó, vào lịch sử trò chuyện của bạn.

Không có gì bị giấu. get_token_credentials và build_proxy_url đều trả mật khẩu thật của đúng token bạn hỏi. Đặt LITPORT_MCP_REVEAL_CREDENTIALS=1 nếu bạn muốn thông tin đăng nhập hiện ngay trong danh sách.

build_proxy_url cũng nhận credentialStyle: "env", trả về URL với $LITPORT_PROXY_PASSWORD thay cho mật khẩu và đưa giá trị đó riêng ra. Hãy dùng khi trợ lý đang viết một script bạn định giữ lại, để mật khẩu không nằm trong mã nguồn của bạn.

Dựng chuỗi kết nối#

build_proxy_url áp dụng các quy tắc trên trang tham số proxy PPG trước khi trả về bất cứ thứ gì, nên slug quốc gia sai định dạng hoặc thời lượng phiên ngoài phạm vi được báo ngay thay vì sau khi yêu cầu bị từ chối.

Với token trả theo GB, nó nối các phân đoạn pool, geo và phiên vào tên người dùng và chọn cổng khớp với giao thức đã chọn. Token đã có pool được lưu không nhận đối số pool, và đối số xung đột sẽ bị từ chối. Token chưa có pool được lưu bắt buộc phải có đối số pool, vì pool quyết định giá.

Token không giới hạn kết nối tới đúng một endpoint được gán cho nó, nên không nhận pool, cũng không nhận tham số geo hay phiên.

Câu hỏi#

Nó có thể tạo proxy hay tiêu số dư của tôi không? Nó có thể tạo proxy trả theo GB, vốn trừ số dư khi lưu lượng của chúng được tính phí, và thay đổi hoặc xóa chúng. Nó không thể mua, gia hạn hay hủy gói, nạp tiền hoặc chuyển số dư.

Có cần mật khẩu proxy của tôi để bắt đầu không? Không. Nó xác thực bằng API key, tách biệt với thông tin đăng nhập proxy. Tên người dùng và mật khẩu proxy sẽ bị từ chối khi dùng làm API key.

Những trợ lý nào dùng được? Mọi MCP host có thể chạy một tiến trình cục bộ, gồm Claude Code, Codex, Claude Desktop, Cursor, Windsurf và Zed.

Key của tôi có bị gửi cho mô hình không? Không. Key nằm trong tiến trình máy chủ trên máy của bạn và chỉ được dùng trong header Authorization gửi tới trang này.

Điều gì xảy ra khi tôi chạm giới hạn tần suất? API cho phép một số yêu cầu cố định mỗi phút trên mỗi key và trả 429 khi vượt. Ba công cụ không cần API key (explain_proxy_error, search_docs và get_doc), nên chúng vẫn chạy khi chạm giới hạn tần suất. Hai công cụ cuối vẫn tải các trang tài liệu từ trang này.

Vì sao token không hiện host? Token không giới hạn báo ingress.status: "hub-unavailable" khi nó trỏ tới một hub không còn hoạt động. status của chính token chỉ báo active, expired hoặc disabled. Hãy liên hệ hỗ trợ để chuyển token hub-unavailable sang hub hiện tại.

API mà các công cụ này gọi được ghi tại API Litport, cùng mã lỗi tại Lỗi API. Hợp đồng đọc được bằng máy nằm tại /docs/openapi.json.