Proxyman MCP

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

MCP

Подключите Codex, Claude Code или Cursor к Proxyman MCP, чтобы просматривать перехваченный HTTP/HTTPS трафик и создавать правила отладки с помощью вашего ИИ-ассистента.

Proxyman MCP подключает ваш ИИ-ассистент к приложению Proxyman для macOS, запущенному на вашем компьютере. Используйте его для просмотра перехваченных запросов и ответов, анализа сбоев и создания правил отладки. Держите Proxyman открытым и захватите трафик, который хотите исследовать, прежде чем просить ассистента проанализировать его.

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

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

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

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

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

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

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

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

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

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

1. Включите MCP в Proxyman
   • Откройте Proxyman → Настройки → Вкладка MCP
   • Переключите Enable MCP Server to start the MCP Server
2. Выберите ваш MCP-клиент: В настройках Proxyman → MCP выберите Codex или Claude Code, затем используйте Copy Command. Для Cursor выберите Manual и добавьте отображаемую конфигурацию в настройки MCP в Cursor.
3. Используйте настройку ниже для вашего клиента и установки. Команда, сгенерированная Proxyman, использует путь установленного приложения, который может отличаться от этих примеров. Держите редактирование чувствительных данных включённым для обычной отладки.

Codex

• Производственная версия:

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

• Производственная версия:

{% 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 %}

Вручную

Для Cursor и других MCP-клиентов добавьте конфигурацию из вкладки Manual в Proxyman в настройки MCP клиента. Выберите конфигурацию для установленного приложения Proxyman. Эти примеры показывают запись mcpServers:

• Производственная версия:

{
  "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 запущен
• Попросите вашего ИИ-ассистента взаимодействовать с Proxyman, например: «Покажи последние запросы к api.example.com».
• Если клиент не может найти Proxyman, проверьте, что MCP включён и путь к приложению настроен правильно, затем переподключите клиента. Если он подключается, но не находит потоки, сделайте новый запрос и воспользуйтесь чек-листом для отсутствующего трафика.

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

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

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

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

Инструмент	Описание	Обязательные параметры
create_breakpoint	Создаёт точку останова для паузы/просмотра соответствующих запросов	url (pattern)
create_map_local	Возвращает пользовательские ответы для соответствующих URL	url (pattern)
create_map_remote	Перенаправляет запросы с одного URL на другой	from_url, to_url
create_blacklist	Блокирует запросы, соответствующие шаблону URL	url (pattern)
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	Получить подробную информацию о конкретном потоке, включая заголовки, тело, параметры запроса и cookie
list_rules	Перечислить все активные правила отладки (точки останова, локальное сопоставление, удалённое сопоставление, чёрный список, скрипты, подмена DNS, сетевые условия, белый список)
get_ssl_proxying_list	Получить текущую конфигурацию SSL-проксирования, включая статус включения и списки доменов
create_breakpoint	Создать новое правило точки останова для приостановки и проверки/изменения запросов или ответов, соответствующих шаблону URL
create_map_local	Создать правило локального сопоставления для возврата пользовательского ответа на соответствующие запросы
create_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	Установить и довериться корневому CA-сертификату Proxyman
uninstall_certificate	Удалить корневой CA-сертификат Proxyman из связки ключей
inject_terminal	Запустить терминальное приложение с внедрёнными переменными окружения прокси Proxyman
get_terminal_manual_command	Получить команду bash source для ручной установки переменных окружения прокси
answer_setup_question	Ответить на вопросы настройки о захвате HTTPS с iOS, Android, браузеров и т.д.
search_docs	Поиск по встроенному индексу документации Proxyman по настройке и устранению неполадок
list_setup_workflows	Перечислить поддерживаемые рабочие процессы настройки, через которые MCP Proxyman может провести пользователей
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) автоматически редактируются в ответах