MCP (Model Context Protocol)

Интеграция StealthSurf VPN с AI-ассистентами через Model Context Protocol.

Что такое MCP?

Model Context Protocol (MCP) — открытый стандарт, который позволяет AI-ассистентам (Claude, Cursor и др.) напрямую управлять вашим VPN-аккаунтом через естественный язык. Вместо того чтобы вручную переключаться между консолью и чатом, вы просто описываете задачу — и ассистент выполняет её через API.

Как это работает: MCP Client → MCP Server → StealthSurf API

Архитектура

Stateless HTTP-прокси — каждый запрос создаёт новый McpServer, без сессий
Auth passthrough — API-ключ stlth_* передаётся из заголовка напрямую в StealthSurf API
Стек: Node.js 22+, TypeScript, @modelcontextprotocol/sdk

Подключение

Hosted-версия доступна по адресу: https://mcp.stealthsurf.app

Claude Code

Добавьте в файл ~/.claude/settings.json:

{
  "mcpServers": {
    "stealthsurf": {
      "type": "url",
      "url": "https://mcp.stealthsurf.app",
      "headers": {
        "Authorization": "Bearer stlth_XXXXXXXX_YYYYYYYYYYYYYYYYYYYYYYYY"
      }
    }
  }
}

Замените stlth_XXXXXXXX_YYYYYYYYYYYYYYYYYYYYYYYY на ваш API-ключ из консоли.

Cursor

Откройте Settings → MCP и добавьте сервер:

{
  "mcpServers": {
    "stealthsurf": {
      "type": "url",
      "url": "https://mcp.stealthsurf.app",
      "headers": {
        "Authorization": "Bearer stlth_XXXXXXXX_YYYYYYYYYYYYYYYYYYYYYYYY"
      }
    }
  }
}

Замените stlth_XXXXXXXX_YYYYYYYYYYYYYYYYYYYYYYYY на ваш API-ключ из консоли.

Возможности

Инструменты (92)

MCP-сервер предоставляет 92 инструмента в 15 категориях:

Категория	Описание
VPN-конфигурации	Создание, продление, настройка и удаление конфигов
Облачные серверы	Управление VPS — создание, перезагрузка, статистика
Платные опции	Подключение и управление премиум-функциями
Профиль	Работа с аккаунтом и настройками уведомлений
Баланс	Пополнение и калькулятор стоимости
Устройства	Управление подключёнными устройствами
Реферальная программа	Статистика и вывод реферальных средств
Кастомные подписки	Создание и управление индивидуальными тарифами
XRay	Генерация ключей и конфигурация XRay
Мосты	Создание двойного VPN между конфигами
Субконфиги	Управление HTTP/SOCKS5 прокси
Локации	Доступные серверы и география
Тарифы	Информация о ценах и методах оплаты
Промокоды	Проверка и активация промокодов
Утилиты	Автопродление и другое

Ресурсы (4)

Помимо инструментов, MCP-сервер предоставляет 4 встроенных ресурса:

Документация — полный текст документации сервиса
Журнал обновлений — история изменений платформы
Коды ошибок — справочник ошибок API
Матрица протоколов — совместимость протоколов и настроек

Промпт-сценарии (11)

Готовые workflow для типичных задач:

Сценарий	Описание
Создание VPN	Подбор оптимального протокола и локации
Диагностика	Анализ проблем с подключением
Оптимизация по региону	Выбор лучшего сервера для вашего региона
Обзор аккаунта	Полная сводка по аккаунту и подпискам
Массовое продление	Продление нескольких конфигов за раз
Семейная подписка	Настройка подписки для нескольких пользователей
Настройка VPS	Развёртывание приватного сервера
Смена протокола	Миграция конфига на другой протокол
Мост (Bridge)	Создание цепочки серверов для двойного VPN
Аудит устройств	Проверка и очистка подключённых устройств
Конфигурация XRay	Тонкая настройка параметров XRay

Поддерживаемые протоколы

Протокол	Идентификатор
VLESS	`vless`
VLESS 2410	`vless-2410`
Trojan	`trojan`
Trojan 2901	`trojan-2901`
Hysteria2	`hysteria2`
Shadowsocks 2022	`shadowsocks-2022`
WireGuard	`wg`
Outline	`outline`
MTProto	`mtproto`

Доступно 12 расширенных настроек: WARP, Reality, SNI, gRPC, XHTTP и другие. Подробнее — в документации API.

Содержание