Photoshop MCP

alisaitteke/photoshop-mcp· Проверено 12.11.2026· 855на GitHub

Даёт агенту работать в запущенном Photoshop: убрать фон, отретушировать портрет, подготовить картинки для сайта и соцсетей, нарезать карусель, поставить водяной знак на целую папку.

128 инструментов: 111 отдельных операций и 17 готовых рецептов, каждый рецепт отменяется одним шагом; работает через ExtendScript, плагин в Photoshop не обязателен.

Как подключить

Что сделать до подключения

1

Запущенный Photoshop на Windows или macOS, версия 2012 или новее

2

Node.js 18 или новее

3

Для генеративных функций: Photoshop 24+ и вход в аккаунт Adobe с генеративными кредитами

4

Для нейрофильтров: необязательный плагин UXP из папки uxp-plugin/ репозитория

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio photoshop \
  -- npx -y @alisaitteke/photoshop-mcp

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Инструменты сервера

photoshop_pingпроверяет связь с Photoshop
photoshop_get_document_infoчитает сведения о документе
photoshop_create_documentсоздаёт документ
photoshop_get_layersперечисляет слои
photoshop_create_text_layerсоздаёт текстовый слой
photoshop_set_layer_blend_modeменяет режим наложения
photoshop_select_subjectвыделяет объект
photoshop_create_layer_maskсоздаёт маску слоя
photoshop_adjust_curvesправит кривые
photoshop_resize_imageменяет размер изображения
photoshop_crop_documentкадрирует документ
photoshop_undoотменяет шаг
photoshop_play_actionзапускает экшен
photoshop_execute_scriptвыполняет скрипт в Photoshop
photoshop_generative_fillзаполняет выделение генеративно
photoshop_export_asэкспортирует в нужный формат
photoshop_recipe_remove_backgroundубирает фон с маской
photoshop_recipe_enhance_portraitретуширует портрет
photoshop_recipe_split_carouselрежет баннер на слайды
photoshop_recipe_batch_watermarkставит водяной знак на папку

Показано 20 из 128.

Что попросить агента

«Убери фон с этого портрета и оставь маску, чтобы можно было поправить»Агент вызовет photoshop_recipe_remove_background: выделит объект и создаст маску слоя
«Отретушируй портрет: сгладь кожу и поправь тон, средняя сила»Агент вызовет photoshop_recipe_enhance_portrait, всё уложится в один шаг отмены
«Разрежь этот широкий баннер на 5 бесшовных слайдов для карусели»Агент вызовет photoshop_recipe_split_carousel и сохранит пронумерованные слайды
«Поставь водяной знак <текст или файл> на все фото в папке <путь>»Агент вызовет photoshop_recipe_batch_watermark, оригиналы останутся нетронутыми
«Подгони изображение до 1080 px по ширине и сохрани в JPEG»Агент вызовет photoshop_resize_image и photoshop_export_as

Для каких задач

Убрать фон с портрета и оставить редактируемую маску
Сгладить кожу и поправить тон портрета средней силой
Подготовить макет для сайта и выгрузить варианты для Instagram и X
Разрезать широкий баннер на 5 бесшовных слайдов карусели
Поставить водяной знак на все фото в папке, оставив оригиналы нетронутыми
Собрать фото на паспорт или карточки из таблицы CSV

Ограничения

!

Photoshop должен быть запущен; сервер работает только на Windows и macOS

!

Генеративная заливка, замена неба и другие функции Firefly требуют Photoshop 24+ и аккаунт Adobe с генеративными кредитами

!

Нейрофильтры работают только с отдельным плагином UXP из репозитория

!

Сервер по умолчанию отправляет анонимную статистику использования; отключается переменной ANALYTICS_DISABLED=1

Если не работает

Сервер пишет Photoshop not found
Если Photoshop стоит не в папке по умолчанию, укажите путь в переменной PHOTOSHOP_PATH: на macOS к пакету .app, на Windows к Photoshop.exe.
Ошибка Failed to connect to Photoshop
Откройте Photoshop и повторите photoshop_ping: сервер сам его не запускает. На Windows проверьте, что настройки безопасности не блокируют COM-автоматизацию.
На macOS ошибка automation_permission_denied с кодом -1743
В System Settings > Privacy & Security > Automation разрешите приложению, в котором работает сервер, управлять Adobe Photoshop.
Ошибка Script execution timeout на долгих операциях
По умолчанию на скрипт отводится 30 секунд. Передайте timeout_ms в photoshop_execute_script (до 600000) или задайте PHOTOSHOP_SCRIPT_TIMEOUT в миллисекундах.
Photoshop пишет, что рабочие диски заполнены, и зависает
Освободите место на системном диске, удалите файлы, имя которых начинается с Photoshop Temp, и перезапустите Photoshop. Другой диск выбирается в настройках Scratch Disks.

Частые вопросы

Можно обойтись без Cursor или Claude?
Да: команда npx -p @alisaitteke/photoshop-mcp ui открывает чат в браузере. В нём входят по ключу ИИ-провайдера или через уже настроенные Claude Code и Gemini CLI.
Что будет, если агент ошибся?
Каждый рецепт ложится в Photoshop одним шагом отмены, а ошибки приходят агенту в структурированном виде, чтобы он сам выбрал следующий шаг. Есть и отдельные инструменты отмены и повтора.
Нужен ли плагин в Photoshop?
Для основной работы нет: сервер управляет Photoshop через ExtendScript на обеих системах. Плагин UXP нужен только для нейрофильтров: сглаживания кожи, гармонизации, размытия глубины, суперзума и раскраски.
Что такое Jev в чате?
Это необязательная маршрутизация от TypeSafe AI для встроенного чата: 26 простых команд вроде отмены, прозрачности или удаления фона выполняются сразу, без вызова языковой модели. Включается ключом TYPESAFE_API_KEY, тогда запросы уходят и на api.typesafe.ai.
Работает ли сервер из России?
Сервер работает на вашем компьютере, ключи не нужны; генеративные функции Firefly идут через аккаунт Adobe.

Похожие серверы