MCP-сервер для ИИ-ассистентов
Подключите ИИ-ассистента для программирования к вашему аккаунту Litport с помощью MCP-сервера (Model Context Protocol). Ассистент перечисляет ваши токены прокси, читает данные об использовании и списаниях, определяет страны, на которые может нацеливаться пул, и собирает рабочие строки подключения к прокси — вам не нужно сначала писать HTTP-клиент.
Сервер может просматривать токены, использование, пакеты, пулы и геотаргетинг; создавать, изменять, перевыпускать данные для подключения и удалять прокси с оплатой за ГБ (метка, включение и выключение, пул, срок действия, лимит трафика); читать использование сразу многих прокси; менять локацию, ротацию или IP перемещаемого токена; управлять разрешёнными IP пакета; собирать URL прокси и обращаться в поддержку. Он не может покупать, продлевать или отменять пакет, пополнять баланс и переводить баланс. Создаваемые им прокси с оплатой за ГБ тратят баланс только по мере списаний за их трафик; оплата пакетов с баланса остаётся в личном кабинете. VPN-профили тоже создаются в личном кабинете; сервер не может создавать или изменять их. Запросы по IPv6 не поддерживаются; обратитесь в поддержку.
Установка#
Сервер работает на вашем компьютере и обращается к этому сайту по HTTPS. Создайте API-ключ в Настройках, затем добавьте сервер в свой MCP-хост. Пакет опубликован в npm как @litportnet/litport-mcp, его исходный код находится на GitHub, а в официальном MCP Registry он значится как 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
Эта команда записывает сервер в ~/.codex/config.toml. Блок можно добавить и вручную:
[mcp_servers.litport]
command = "npx"
args = ["-y", "@litportnet/litport-mcp"]
[mcp_servers.litport.env]
LITPORT_API_KEY = "lit_your_key_here"
Проверьте результат командой codex mcp list, посмотрите одну запись командой codex mcp get litport и удалите её командой codex mcp remove litport.
Claude Desktop, Cursor, Windsurf и другие хосты, которые запускают локальный процесс, используют блок конфигурации:
{
"mcpServers": {
"litport": {
"command": "npx",
"args": ["-y", "@litportnet/litport-mcp"],
"env": { "LITPORT_API_KEY": "lit_your_key_here" }
}
}
}
Переменные окружения#
| Переменная | По умолчанию | Действие |
|---|---|---|
LITPORT |
не задана | API-ключ из Настроек. Это не логин и не пароль прокси. Без него загружаются только инструменты поддержки и документации |
LITPORT |
https:// |
Переопределяет базовый адрес API. |
LITPORT |
не задана | Установите 1, чтобы включать пароли прокси прямо в вывод list_tokens. |
Инструменты#
| Инструмент | Что делает | Запись |
|---|---|---|
list_tokens |
Показывает ваши токены с типом, статусом и сведениями о входе. | нет |
get |
Полные данные для подключения одного токена. | нет |
get |
Трафик и составляющие списаний одного токена. | нет |
get_usage |
Суточное использование сразу многих прокси за период, включая удалённые, с суточным списанием для прокси с оплатой за ГБ. | нет |
get |
Читает сохранённую и фактическую локацию перемещаемого токена. | нет |
list |
Показывает значения, которые сейчас можно использовать в следующем поле локации токена. | нет |
set |
Меняет локацию перемещаемого токена или, если отправить random: true, переводит токен в другую локацию, которую он может использовать сейчас. |
да |
set_rotation |
Меняет интервал ротации токена с ротацией. | да |
get_new_ip |
Получает новый IP в той же локации (серверные |
да |
create_token |
Создаёт действующий прокси с оплатой за ГБ, при желании привязанный к пулу, с меткой, вашим собственным externalRef, сроком действия и лимитом трафика. Возвращает его данные для подключения. |
да |
update_token |
Меняет метку, переключатель включения, пул, срок действия или лимит трафика прокси с оплатой за ГБ. У прокси пакета меняется только метка. Данные для подключения не возвращает. | да |
reissue |
Выдаёт прокси новые логин, пароль и ключ смены IP. Старый пароль перестаёт работать, а его открытые соединения закрываются. | да |
delete_token |
Удаляет прокси с оплатой за ГБ. Его история и данные об использовании остаются. | да |
list |
Показывает ваши пакеты со статусом, продуктом, дополнениями и ID токенов. | нет |
get_package |
Читает один пакет. | нет |
get |
Читает список разрешённых IP пакета. | нет |
set |
Задаёт весь список разрешённых IP пакета. | да |
add |
Добавляет один IP в список разрешённых IP пакета. | да |
remove |
Удаляет один IP из списка разрешённых IP пакета. | да |
list_pools |
Доступные для выбора пулы с оплатой за ГБ: фактическая цена за ГБ, порты, поддержка UDP (udp), подходящие хабы и уровни геотаргетинга |
нет |
list |
Страны, регионы и города, на которые может нацеливаться пул. | нет |
get_balance |
Баланс, зарезервированны |
нет |
build |
Собирает рабочий URL прокси с параметрами гео и сессии. | нет |
explain |
Переводит код ошибки прокси в решение о повторе. | нет |
search_docs |
Находит страницу документации по теме. | нет |
get_doc |
Читает страницу документации в виде Markdown. | нет |
contact |
Задаёт вопрос поддержке Litport. С API-ключом он попадает в обращение вашего аккаунта; без ключа начинается гостевое обращение, и нужен ваш email. | да |
get |
Читает новые сообщения в обращении в поддержку. | нет |
reply |
Добавляет сообщение в обращение в поддержку. | да |
Каждому инструменту аккаунта, который выполняет запись, нужен тот же API-ключ, что и для любого чтения; отдельного права на запись нет. Инструменты поддержки работают с ключом и без него: см. Связь с поддержкой. Покупка, продление и отмена пакета, а также пополнение баланса остаются в личном кабинете.
Если API отклоняет вызов, текст ошибки инструмента содержит сообщение и code API, а также retryable, если API его прислал. retryable: true означает, что тот же вызов, отправленный снова без изменений после ожидания, может пройти; false означает, что сначала нужно что-то изменить.
explain_proxy_error отвечает по копии справочника ошибок прокси, поставляемой внутри npm-пакета, поэтому диагностика сбоя ничего не стоит и не учитывается в ограничении частоты запросов.
Как обрабатываются пароли прокси#
list_tokens — операция просмотра, поэтому по умолчанию она скрывает пароли: для каждого токена возвращается password: null и passwordSet: true. Так список из многих токенов не помещает каждый пароль в контекст ассистента и, через него, в историю вашего чата.
Ничего не утаивается. get_token_credentials и build_proxy_url возвращают настоящий пароль для того единственного токена, о котором вы спросили. Установите LITPORT_MCP_REVEAL_CREDENTIALS=1, если предпочитаете видеть данные для подключения прямо в списках.
build_proxy_url также принимает credentialStyle: "env", который возвращает URL с $LITPORT_PROXY_PASSWORD вместо пароля, а само значение отдаёт отдельно. Используйте его, когда ассистент пишет скрипт, который вы собираетесь сохранить, чтобы пароль не попал в ваш исходный код.
Сборка строки подключения#
build_proxy_url применяет правила со страницы Параметры PPG-прокси до того, как что-либо вернуть, поэтому некорректный слаг страны или время жизни сессии вне допустимого диапазона сообщаются сразу, а не после отклонённого запроса.
Для токена с оплатой за ГБ он добавляет сегменты пула, гео и сессии к логину и выбирает порт, соответствующий выбранному протоколу. Токен с сохранённым пулом не принимает аргумент пула, а конфликтующий аргумент отклоняется. Токену без сохранённого пула нужен аргумент пула, потому что пул определяет цену.
Безлимитный токен подключается к единственному назначенному ему эндпоинту, поэтому не принимает ни пул, ни параметры гео или сессии.
Вопросы#
Может ли он создавать прокси или тратить мой баланс? Он может создавать прокси с оплатой за ГБ, которые тратят баланс по мере списаний за их трафик, а также изменять и удалять их. Он не может покупать, продлевать или отменять пакет, пополнять баланс и переводить баланс.
Нужен ли ему пароль прокси для запуска? Нет. Он аутентифицируется по API-ключу, который не связан с данными для подключения к прокси. Логин и пароль прокси будут отклонены как API-ключ.
С какими ассистентами он работает? С любым MCP-хостом, который может запустить локальный процесс, включая Claude Code, Codex, Claude Desktop, Cursor, Windsurf и Zed.
Отправляется ли мой ключ модели? Нет. Ключ остаётся в процессе сервера на вашем компьютере и используется только в заголовке Authorization запросов к этому сайту.
Что происходит, когда я достигаю ограничения частоты запросов? API разрешает фиксированное число запросов в минуту на ключ и сверх него отвечает 429. Трём инструментам API-ключ не нужен вовсе (explain_proxy_error, search_docs и get_doc), поэтому они продолжают работать при достижении ограничения. Последние два всё же загружают страницы документации с этого сайта.
Почему у токена не указан хост? Безлимитный токен сообщает ingress.status: "hub-unavailable", когда указывает на хаб, который больше не работает. Собственный status токена принимает только значения active, expired или disabled. Обратитесь в поддержку, чтобы перенести токен с недоступным хабом на актуальный хаб.
Связанные материалы#
API, который вызывают эти инструменты, описан в Litport API, коды его ошибок — в Ошибки API. Машиночитаемый контракт находится по адресу /docs/openapi.json.