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 |
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 |
https:// |
Ghi đè origin của API. |
LITPORT |
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 |
Thông tin đăng nhập đầy đủ của một token. | không |
get |
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 |
Đọc vị trí đã lưu và vị trí đang áp dụng của token có thể di chuyển. | không |
list |
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 |
Đổ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 |
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 |
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 |
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 |
Đọc danh sách IP được phép của gói. | không |
set |
Đặt toàn bộ danh sách IP được phép của gói. | có |
add |
Thêm một IP vào danh sách IP được phép của gói. | có |
remove |
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 |
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 |
Lắp ráp URL proxy dùng được với tham số geo và phiên. | không |
explain |
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 |
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 |
Đọc các tin nhắn mới trong cuộc trò chuyện hỗ trợ. | không |
reply |
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.
Liên quan#
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.