Меню документации

MCP-сервер для ИИ-ассистентов

Подключите ИИ-ассистента для программирования к вашему аккаунту Litport с помощью MCP-сервера (Model Context Protocol). Ассистент перечисляет ваши токены прокси, читает данные об использовании и списаниях, определяет страны, на которые может нацеливаться пул, и собирает рабочие строки подключения к прокси — вам не нужно сначала писать HTTP-клиент.

Сервер не может создавать токены, покупать или отменять пакеты и тратить баланс. Он может менять локацию, интервал ротации или IP перемещаемого токена, а также разрешённые IP пакета, как описано ниже. Запросы по IPv6 не поддерживаются; обратитесь в поддержку.

Установка#

Сервер работает на вашем компьютере и обращается к этому сайту по HTTPS. Создайте API-ключ в Настройках, затем добавьте сервер в свой 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_KEY не задана API-ключ из Настроек. Это не логин и не пароль прокси. Без него загружаются только инструменты поддержки и документации, а вопросы в поддержку попадают в гостевое обращение.
LITPORT_API_URL https://litport.net Переопределяет базовый адрес API.
LITPORT_MCP_REVEAL_CREDENTIALS не задана Установите 1, чтобы включать пароли прокси прямо в вывод list_tokens.

Инструменты#

Инструмент Что делает Запись
list_tokens Показывает ваши токены с типом, статусом и сведениями о входе. нет
get_token_credentials Полные данные для подключения одного токена. нет
get_token_usage Трафик и составляющие списаний одного токена. нет
get_token_location Читает сохранённую и фактическую локацию перемещаемого токена. нет
list_location_options Показывает значения, которые сейчас можно использовать в следующем поле локации токена. нет
set_token_location Меняет локацию перемещаемого токена. да
set_rotation Меняет интервал ротации токена с ротацией. да
get_new_ip Получает новый IP в той же локации (только статические серверные/ISP-прокси). да
list_packages Показывает ваши пакеты со статусом, продуктом, дополнениями и ID токенов. нет
get_package Читает один пакет. нет
get_allowed_ips Читает список разрешённых IP пакета. нет
set_allowed_ips Задаёт весь список разрешённых IP пакета. да
add_allowed_ip Добавляет один IP в список разрешённых IP пакета. да
remove_allowed_ip Удаляет один IP из списка разрешённых IP пакета. да
list_pools Доступные для выбора пулы с оплатой за ГБ: фактическая цена за ГБ, порты, поддержка UDP (udp), подходящие хабы и уровни геотаргетинга. нет
list_targeting_options Страны, регионы и города, на которые может нацеливаться пул. нет
get_balance Баланс, зарезервированные единицы и тариф. нет
build_proxy_url Собирает рабочий URL прокси с параметрами гео и сессии. нет
explain_proxy_error Переводит код ошибки прокси в решение о повторе. нет
search_docs Находит страницу документации по теме. нет
get_doc Читает страницу документации в виде Markdown. нет
contact_support Задаёт вопрос поддержке Litport. С API-ключом он попадает в обращение вашего аккаунта; без ключа начинается гостевое обращение, и нужен ваш email. да
get_support_replies Читает новые сообщения в обращении в поддержку. нет
reply_to_support Добавляет сообщение в обращение в поддержку. да

Каждому инструменту аккаунта, который выполняет запись, нужен тот же API-ключ, что и для любого чтения; отдельного права на запись нет. Инструменты поддержки работают с ключом и без него: см. Связь с поддержкой. Создание и удаление токенов, а также покупка, продление и отмена пакета остаются в личном кабинете.

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-прокси до того, как что-либо вернуть, поэтому некорректный слаг страны или время жизни сессии вне допустимого диапазона сообщаются сразу, а не после отклонённого запроса.

Для токена с оплатой за ГБ он добавляет сегменты пула, гео и сессии к логину и выбирает порт, соответствующий выбранному протоколу. Токен с сохранённым пулом не принимает аргумент пула, а конфликтующий аргумент отклоняется. Токену без сохранённого пула нужен аргумент пула, потому что пул определяет цену.

Безлимитный токен подключается к единственному назначенному ему эндпоинту, поэтому не принимает ни пул, ни параметры гео или сессии.

Вопросы#

Может ли он создавать прокси или тратить мой баланс? Нет. Некоторые инструменты выполняют запись (см. таблицу выше: локация, ротация или новый IP перемещаемого токена и разрешённые IP пакета), но ни один из них не может создать или удалить токен или переводить деньги. Создание токенов и покупка трафика остаются в личном кабинете.

Нужен ли ему пароль прокси для запуска? Нет. Он аутентифицируется по 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.