UX Pilot MCP

Работайте непосредственно в UX Pilot через Claude, ChatGPT, Cursor, Codex и другие MCP-клиенты.

Переносите результаты работы ИИ в UX Pilot, упорядочивайте их, проверяйте и версионируйте, создавайте прототипы, а затем возвращайтесь к UX Pilot AI, чтобы генерировать материалы с учётом контекста продукта.

Сервер UX Pilot MCP подключает любой совместимый с MCP AI-клиент к вашему рабочему пространству UX Pilot. Ассистент может создавать рабочие потоки и страницы, импортировать HTML или действующие URL-адреса как дизайны, проводить проверки UX и доступности, управлять версиями и комментариями, а также генерировать прототипы React — всё это непосредственно в UX Pilot.

Сервер размещён на стороне UX Pilot. В этом репозитории описано, как к нему подключиться и какие функции он предоставляет. Здесь нет кода сервера, который нужно собирать или запускать.

URL сервера: https://mcp.uxpilot.net/mcp
Транспорт: Streamable HTTP (POST)
Протокол: MCP 2025-11-25 (JSON-RPC 2.0)
Авторизация: вход через встроенный OAuth (рекомендуется) или резервный вариант с API-ключом в заголовке Authorization: Bearer
Инструменты: 87

Авторизация

Вход через встроенный механизм (рекомендуется)

Если в вашем AI-инструменте отображается экран входа или авторизации UX Pilot, выберите этот способ. Войдите в аккаунт UX Pilot, проверьте запрашиваемые разрешения и подтвердите подключение. Не нужно копировать или вставлять API-ключ, а доступ будет привязан к вашему аккаунту и тарифному плану.

Резервный вариант с API-ключом

Если клиент поддерживает только статические заголовки, создайте ключ на вкладке API Keys в рабочем пространстве UX Pilot и передавайте его как токен Bearer:

Authorization: Bearer ep_your_api_key

В рабочих пространствах Enterprise MCP/API-ключами управляет администратор. Храните ключ в тайне и замените его, если изменится круг пользователей с доступом.

Настройка

По возможности используйте встроенный механизм входа. Настройку с API-ключом используйте как запасной вариант. Замените ep_your_api_key на свой действующий ключ.

Claude

Встроенное подключение (рекомендуется):

Откройте настройки Claude и добавьте пользовательское подключение или удалённый MCP-сервер.
Вставьте URL сервера: https://mcp.uxpilot.net/mcp
Когда Claude предложит выбрать способ входа, выберите UX Pilot и подтвердите доступ.
В диалоге попросите Claude перечислить инструменты UX Pilot.

Резервный вариант с API-ключом (Claude Desktop через mcp-remote): отредактируйте claude_desktop_config.json

(macOS: ~/Library/Application Support/Claude/claude_desktop_config.json,

Windows: %APPDATA%\Claude\claude_desktop_config.json)

{
  "mcpServers": {
    "uxpilot": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.uxpilot.net/mcp",
        "--transport",
        "http-only",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer ep_your_api_key"
      }
    }
  }
}

Требуется Node.js. mcp-remote обеспечивает взаимодействие между stdio и Streamable HTTP.

ChatGPT

Используйте поддержку пользовательских подключений или MCP в ChatGPT (режим разработчика; доступность зависит от вашего тарифного плана):

Откройте настройки ChatGPT и добавьте пользовательское подключение или MCP-сервер.
Вставьте URL сервера: https://mcp.uxpilot.net/mcp
При появлении запроса выполните вход в UX Pilot.
Включите подключение в чате и попросите ChatGPT перечислить инструменты UX Pilot.

Cursor

Добавьте настройки в ~/.cursor/mcp.json (глобальный файл) или .cursor/mcp.json (файл проекта). Если клиент поддерживает встроенный вход, достаточно добавить URL. Заголовок используется как резервный вариант с API-ключом.

{
  "mcpServers": {
    "uxpilot": {
      "url": "https://mcp.uxpilot.net/mcp",
      "headers": {
        "Authorization": "Bearer ep_your_api_key"
      }
    }
  }
}

VS Code + Copilot

Добавьте настройки в .vscode/mcp.json:

{
  "servers": {
    "uxpilot": {
      "type": "http",
      "url": "https://mcp.uxpilot.net/mcp",
      "headers": {
        "Authorization": "Bearer ep_your_api_key"
      }
    }
  }
}

Windsurf

Добавьте настройки в ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "uxpilot": {
      "serverUrl": "https://mcp.uxpilot.net/mcp",
      "headers": {
        "Authorization": "Bearer ep_your_api_key"
      }
    }
  }
}

Codex

Добавьте настройки в ~/.codex/config.toml:

[mcp_servers.uxpilot]
url = "https://mcp.uxpilot.net/mcp"
bearer_token_env_var = "UXPILOT_API_KEY"

Затем задайте переменную окружения с исходным ключом (без префикса Bearer — Codex добавит его самостоятельно):

export UXPILOT_API_KEY="ep_your_api_key"

Любой MCP-клиент

Клиенты, которые не поддерживают Streamable HTTP, могут использовать мост mcp-remote:

{
  "mcpServers": {
    "uxpilot": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.uxpilot.net/mcp",
        "--transport",
        "http-only",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer ep_your_api_key"
      }
    }
  }
}

Инструменты

87 инструментов, сгруппированных по назначению. Инструменты, отмеченные пометкой · расходуют кредиты, используют кредиты аккаунта; для выполнения действий, расходующих кредиты или приводящих к удалению данных, требуется явное подтверждение.

Поиск и просмотр (13)

Инструмент	Описание
`search_designs`	Найти существующие HTML-дизайны и React-проекты по ключевому слову, названию, запросу, имени страницы или pageId
`list_workstreams`	Показать рабочие области и папки со сводной информацией о страницах
`list_pages`	Показать страницы, их URL, количество элементов и миниатюры
`get_page_context`	Получить группы, дизайны, холст и комментарии страницы
`get_design`	Получить сведения об одном дизайне, URL предпросмотра и, при необходимости, HTML
`get_design_preview`	Получить URL предпросмотра или страницы дизайна и его статус (без HTML)
`get_design_versions`	Получить сведения о версиях дизайна и их родительской версии
`list_design_collections`	Показать пользовательские коллекции дизайн-систем
`get_design_collection`	Получить ресурсы, стили и документацию коллекции
`list_themes`	Показать доступные темы бренда и стилей
`get_theme`	Получить полные JSON-данные темы для создания материалов в фирменном стиле
`list_symbols`	Показать повторно используемые компоненты и символы редактора
`get_symbol`	Получить HTML- и CSS-содержимое символа

Организация рабочего пространства (19)

Инструмент	Описание
`create_workstream`	Создать рабочую область или папку
`update_workstream`	Переименовать рабочую область или изменить её описание
`delete_workstream`	Удалить рабочую область и отвязать от неё страницы
`create_page`	Создать пустую страницу
`create_page_from_template`	Создать страницу или группу на основе шаблона
`update_page`	Изменить название страницы, запрос или контекст для ИИ
`delete_page`	Удалить страницу
`move_page_to_workstream`	Переместить страницу в папку или из неё
`toggle_page_bookmark`	Добавить страницу в закладки или удалить её из закладок
`create_group`	Создать группу дизайнов на странице
`update_group`	Изменить название группы, шрифт или входящие в неё дизайны
`delete_group`	Удалить группу и её дизайны
`move_group_to_page`	Переместить группу и её дизайны на другую страницу
`set_group_saved`	Сохранить группу в библиотеку или удалить её оттуда
`duplicate_design`	Создать копию дизайна на странице или в группе
`move_design_to_page`	Переместить дизайн на другую страницу или в другую группу
`archive_design`	Архивировать дизайн и отвязать его
`update_design_metadata`	Изменить название, запрос, расположение или размер дизайна
`set_design_saved`	Сохранить дизайн в библиотеку или удалить его оттуда

Создание с помощью UX Pilot AI (5)

Инструмент	Описание
`start_design_agent`	Создать или изменить экраны, целые пользовательские сценарии или новое React-приложение по описанию; выполняется в фоновом режиме · расходует кредиты
`get_agent_job`	Проверить выполнение задачи агента и отобразить ход работы до её завершения
`stop_agent_job`	Остановить выполняющуюся задачу агента; готовые экраны сохраняются
`get_generation_status`	Проверить статус генерации, импорта и сборки React
`retrieve_designs`	Проверить статус и получить URL или HTML дизайнов (устаревший инструмент для старых клиентов)

Редактирование дизайнов и кода React вручную (7)

Эти изменения выполняются без UX Pilot AI и не расходуют кредиты.

Инструмент	Описание
`patch_design_html`	Внести небольшие точечные изменения в HTML дизайна: текст, классы, стили или атрибуты
`edit_design_html`	Сохранить HTML существующего дизайна целиком, заменив его
`list_react_projects`	Показать React-приложения и прототипы с фильтрацией по ключевым словам
`list_react_project_files`	Показать исходные файлы React-приложения
`read_react_project_file`	Прочитать исходный файл с хешем для безопасного редактирования
`search_react_project_files`	Найти в коде React-приложения компоненты, маршруты, классы или текст
`edit_react_project_files`	Сохранить изменения кода в новой версии и поставить сборку или публикацию в очередь

Импорт результатов работы внешних ИИ (15)

Инструмент	Описание
`import_html_design`	Импортировать внешний HTML как дизайн с возможностью предпросмотра · расходует кредиты
`import_live_url`	Сохранить общедоступный URL как дизайн · расходует кредиты
`add_canvas_assets`	Добавить на страницу ресурсы изображений или референсов по URL
`upload_canvas_asset`	Загрузить на страницу изображения в формате base64 или data URL
`update_canvas_assets`	Обновить существующие ресурсы холста и связанные элементы
`delete_canvas_assets`	Удалить ресурсы холста
`add_canvas_items`	Добавить на холст стикеры, заметки и узлы схемы процесса
`update_canvas_items`	Переместить элементы холста, изменить их подписи или стили
`delete_canvas_items`	Удалить элементы холста
`generate_flowchart`	Создать схему процесса по запросу
`edit_flowchart`	Изменить существующую схему процесса по инструкции
`list_diagrams`	Показать сохранённые схемы на странице
`create_diagram`	Создать и сохранить схему сайта, пользовательского пути или процесса
`update_diagram`	Изменить метаданные, узлы или связи схемы
`delete_diagram`	Удалить схему

Проверка, аудит и доступность (10)

Инструмент	Описание
`run_ux_review`	Проверить UX и сохранить результаты в виде комментариев · расходует кредиты
`get_review_status`	Проверить статус асинхронной задачи UX-проверки
`apply_ux_review_fixes`	Применить рекомендации проверки и создать дочернюю версию · расходует кредиты
`run_persona_audit`	Провести аудит с учётом пользовательских персон и сохранить результаты
`apply_persona_audit_fixes`	Применить рекомендации аудита по персонам и создать дочернюю версию · расходует кредиты
`save_accessibility_report`	Сохранить внешний отчёт о доступности в стиле axe
`apply_accessibility_fixes`	Устранить нарушения доступности и создать дочернюю версию · расходует кредиты
`compare_review_scores`	Сравнить оценки до и после проверки (только чтение)
`generate_heatmap`	Спрогнозировать, какие области дизайна привлекают внимание, и создать тепловую карту
`generate_gaze_flow`	Спрогнозировать порядок просмотра дизайна и создать схему движения взгляда

Версии и комментарии (12)

Инструмент	Описание
`create_design_version`	Создать версию с сохранением истории родительских версий
`compare_design_versions`	Сравнить два дизайна или версии (метаданные и различия в HTML)
`create_version_from_comments`	Создать дочернюю версию на основе исправленного HTML и комментариев
`create_comment`	Оставить комментарий на странице или прикрепить его к дизайну или фигуре
`update_comment`	Изменить текст, упоминания или положение собственного комментария
`delete_comment`	Удалить комментарий и ответы на него
`reply_to_comment`	Ответить в ветке комментариев
`update_comment_reply`	Изменить свой ответ
`delete_comment_reply`	Удалить ответ
`resolve_comment`	Отметить комментарий как решённый или снова открыть его
`resolve_comments_with_version_summary`	Ответить на комментарии, закрыть их и добавить сводку по версии
`summarize_comments`	Показать комментарии к странице и подготовить их сводку

Создание прототипов и публикация (5)

Инструмент	Описание
`generate_react_prototype`	Создать React-приложение на основе дизайнов · расходует кредиты
`edit_react_prototype`	Изменить существующее React-приложение с помощью UX Pilot AI · расходует кредиты
`build_react_prototype`	Поставить обновление сборки или публикации прототипа в очередь
`publish_prototype`	Опубликовать прототип и получить размещённый URL
`publish_design_preview`	Опубликовать HTML дизайна для предпросмотра · расходует кредиты

Также доступен request_action_confirmation — служебный инструмент для безопасного выполнения рискованных действий, который создаёт токен подтверждения.

Быстрый старт

Выберите AI-клиент, который хотите использовать с UX Pilot.
Выполните описанные выше стандартные шаги входа с URL сервера.
Если клиенту нужны статические заголовки, создайте API-ключ и замените ep_your_api_key в резервной конфигурации.
Попросите ассистента: «Создай страницу в UX Pilot, импортируй этот HTML как дизайн, затем проведи UX-проверку».

Поддержка

Помощь по продукту и аккаунту: uxpilot.ai
Вопросы по этой интеграции: создайте issue
Спецификация MCP: modelcontextprotocol.io