Proxyman MCP

Полный указатель документации см. в llms.txt. Markdown-версии страниц документации доступны при добавлении .md к URL страниц; эта страница доступна как Markdown.

MCP

1. Что такое Proxyman MCP?

Proxyman MCP (Model Context Protocol) — это функция, позволяющая AI-ассистентам (Claude, Cursor и другим инструментам, совместимым с MCP) напрямую взаимодействовать с приложением Proxyman для macOS. Она даёт AI возможность проверять HTTP-трафик, создавать правила отладки и управлять Proxyman — и всё это через общение на естественном языке.

Архитектура состоит из двух компонентов:

• MCP HTTP Server — работает внутри приложения Proxyman на localhost с аутентификацией по токену
• MCP CLI Server — MCP-сервер на основе stdio, к которому подключаются AI-инструменты и который перенаправляет команды в Proxyman

{% hint style="info" %} Ознакомьтесь с Proxyman SKILL.md для ваших AI-агентов {% endhint %}

✅ Примеры запросов

• Покажи последние 10 API-запросов к api.example.com
• Создай точку останова для всех POST-запросов к /api/users
• Экспортируй неудачный запрос как команду cURL
• Включи SSL-проксирование для *.stripe.com
• Создай новый скрипт для изменения кода состояния, заголовков, тела.
• Создай инструменты Map Local, Breakpoint с указанным URL

2. Преимущества

Преимущество	Описание
Отладка с помощью AI	Попросите AI проанализировать захваченный трафик, найти конкретные запросы или объяснить ответы API
Создание правил без ручного ввода	Создавайте точки останова, правила map local/remote через диалог
Ускорение рабочего процесса	Экспортируйте команды cURL, фильтруйте потоки и управляйте сессиями без переключения контекста
Безопасность по дизайну	Сервер только на localhost с аутентификацией по токену для каждой сессии
Интеграция с IDE	Бесшовная работа с Cursor и другими инструментами, совместимыми с MCP

3. Как добавить Proxyman MCP

1. Включите MCP в Proxyman
   • Откройте Proxyman → Настройки → Вкладка MCP
   • Переключите Enable MCP Server, чтобы запустить MCP-сервер
2. Настройте ваш MCP-клиент (например, Cursor, Claude Desktop)
3. Добавьте Proxyman MCP к вашим агентам:

Codex

• Production-версия:

codex mcp add proxyman -- "/Applications/Proxyman.app/Contents/MacOS/mcp-server"

• Setapp-версия:

codex mcp add proxyman -- "/Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server"

Claude Code

• Production-версия:

{% code overflow="wrap" %}

claude mcp add proxyman --transport stdio -- "/Applications/Proxyman.app/Contents/MacOS/mcp-server"

{% endcode %}

• Setapp-версия:

{% code overflow="wrap" %}

claude mcp add proxyman --transport stdio -- "/Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server"

{% endcode %}

Вручную

В зависимости от того, какие у вас AI-агенты, вам нужно отредактировать настройки агента, чтобы использовать Proxyman MCP. Вот пример settings.json:

• Production-версия:

{
  "mcpServers": {
    "proxyman": {
      "command": "/Applications/Proxyman.app/Contents/MacOS/mcp-server"
    }
  }
}

• Setapp-версия

{
  "mcpServers": {
    "proxyman": {
      "command": "/Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server"
    }
  }
}

4. Начните использовать Proxyman MCP

• Убедитесь, что Proxyman запущен
• Попросите вашего AI-ассистента взаимодействовать с Proxyman.

4. Доступные инструменты

Инструменты только для чтения

Инструмент	Описание
get_version	Возвращает версию Proxyman и номер сборки
get_proxy_status	Возвращает состояние записи, прокси-порт и статус SSL-проксирования
get_flows	Выводит список захваченных потоков HTTP/HTTPS с опциональными фильтрами (limit, host_filter, method_filter, status_filter)
get_flow_detail	Возвращает полную информацию о конкретном потоке, включая заголовки, предпросмотр тела, параметры запроса и cookies
list_rules	Выводит список всех правил отладки (точки останова, map local, map remote, чёрный список)
get_ssl_proxying_list	Возвращает списки доменов, включённых/исключённых для SSL-проксирования
get_certificate_status	Возвращает статус установки корневого сертификата

Инструменты записи

Инструмент	Описание	Обязательные параметры
create_breakpoint	Создаёт точку останова для приостановки/проверки подходящих запросов	url (шаблон)
create_map_local	Возвращает пользовательские ответы для подходящих URL	url (шаблон)
create_map_remote	Перенаправляет запросы с одного URL на другой	from_url, to_url
create_blacklist	Блокирует запросы, соответствующие шаблону URL	url (шаблон)
enable_scripting_tool	Создать скрипт
enable_ssl_proxying	Включает расшифровку HTTPS для домена	domain

Управление сессией

Инструмент	Описание
clear_session	Очищает все захваченные потоки из текущей сессии
toggle_recording	Запускает или останавливает запись трафика

Операции с потоками

Инструмент	Описание
export_flow_curl	Экспортирует захваченный запрос как исполняемую команду cURL
filter_flows	Расширенная фильтрация с множеством критериев (url, host, method, status, headers, body) с поддержкой комбинаций AND/OR

Управление приложением

Инструмент	Описание
open_proxyman	Запускает Proxyman, если он не запущен
quit_proxyman	Завершает работу приложения Proxyman

---

Журнал изменений

MCP v3 (Proxyman macOS ≥ 6.8.0)

Название	Описание
get_version	Получить текущую версию и номер сборки приложения Proxyman для macOS
get_proxy_status	Получить текущий статус прокси, включая состояние записи, номер порта и статус SSL-проксирования
get_flows	Получить последние HTTP/HTTPS потоки из источника данных активной сессии Proxyman
get_flow_detail	Получить подробную информацию о конкретном потоке, включая заголовки, тело, параметры запроса и куки
list_rules	Список всех активных правил отладки (точки останова, map local, map remote, черный список, скриптинг, подмена DNS, состояние сети, белый список)
get_ssl_proxying_list	Получить текущую конфигурацию SSL-проксирования, включая статус включения и списки доменов
create_breakpoint	Создать новое правило точки останова для приостановки и проверки/изменения запросов или ответов, соответствующих шаблону URL
create_map_local	Создать правило Map Local для возврата пользовательского ответа на соответствующие запросы
create_map_remote	Создать правило Map Remote для перенаправления запросов с одного URL на другой
create_blacklist	Создать правило черного списка для блокировки запросов, соответствующих шаблону URL
create_scripting_rule	Создать правило скриптинга с пользовательским JavaScript для изменения запросов/ответов
enable_ssl_proxying	Включить SSL-проксирование для определенного домена, чтобы расшифровывать HTTPS-трафик
clear_session	Очистить все захваченные потоки из текущей сессии
toggle_recording	Запустить или остановить запись HTTP-трафика
export_flow_curl	Экспортировать захваченный HTTP-запрос в виде команды cURL
filter_flows	Фильтровать захваченные HTTP/HTTPS потоки, используя расширенные критерии фильтрации
get_certificate_status	Получить текущий статус корневого сертификата Proxyman
install_certificate	Установить и доверять корневому сертификату ЦС Proxyman
uninstall_certificate	Удалить корневой сертификат ЦС Proxyman из Связки ключей
inject_terminal	Запустить приложение терминала с внедренными переменными окружения прокси Proxyman
get_terminal_manual_command	Получить команду bash source для ручной установки переменных окружения прокси
answer_setup_question	Ответить на вопросы по настройке захвата HTTPS с iOS, Android, браузеров и т.д.
search_docs	Поиск по встроенному индексу документации по настройке и устранению неполадок Proxyman
list_setup_workflows	Список поддерживаемых сценариев настройки, по которым Proxyman MCP может провести пользователей
list_popular_workflows	Список популярных сценариев настройки с использованием курируемого резервного ранжирования Proxyman
open_proxyman_screen	Открыть определенное руководство или экран настройки Proxyman в приложении macOS
run_guided_setup	Запустить автоматизацию в один клик в Proxyman для браузеров или эмуляторов Android
list_reverse_proxies	Список настроенных записей обратного прокси
create_reverse_proxy	Создать запись обратного прокси для localhost или пользовательской маршрутизации локального порта
generate_code	Сгенерировать код из захваченного HTTP-потока на 18+ языках/фреймворках
create_dns_spoofing	Создать правило подмены DNS для перенаправления имени хоста на другой IP-адрес
list_dns_spoofing	Список всех правил подмены DNS и их статус включения
update_dns_spoofing	Обновить существующее правило подмены DNS
get_external_proxy	Получить текущую конфигурацию внешнего прокси (вышестоящего прокси)
set_external_proxy	Настроить параметр внешнего прокси для определенного типа протокола
toggle_no_caching	Переключить функцию «Без кэширования» (удаляет заголовки, связанные с кэшем)
inject_electron	Запустить приложение Electron с внедренной конфигурацией прокси Proxyman
open_proxyman	Запустить приложение Proxyman для macOS
quit_proxyman	Завершить работу приложения Proxyman для macOS

MCP v2 (Proxyman ≥ v6.7.0)

• Встроенная база знаний, охватывающая iOS, Android, браузеры, терминал, VPN, localhost и сторонние библиотеки
• Новые команды: answer_setup_question, search_docs, list_setup_workflows, open_proxyman_screen, run_guided_setup, create_reverse_proxy
• Ресурсы MCP и шаблоны подсказок для чат-клиентов
• Поддержка создания/списка обратного прокси

Безопасность

• Сервер привязывается только к 127.0.0.1 (без сетевого доступа)
• Криптографический токен сессии хранится в ~/Library/Application Support/com.proxyman.NSProxy/mcp-handshake.json
• Файл рукопожатия имеет права 0600 (доступ только владельца)
• Конфиденциальные данные (токены аутентификации, пароли, ключи API) автоматически скрываются в ответах