KeyShot MCP — MCP-сервер для Claude Code: установка
Управляет сохранёнными сценами KeyShot через MCP: меняет материалы, камеры и окружение, показывает превью и запускает рендер.
claude mcp add --env KEYSHOT_HEADLESS_EXE=<KEYSHOT_HEADLESS_EXE> --env KEYSHOT_OUTPUT_DIR=<KEYSHOT_OUTPUT_DIR> --env KEYSHOT_ALLOW_EXTERNAL_OUTPUTS=<KEYSHOT_ALLOW_EXTERNAL_OUTPUTS> --env KEYSHOT_TIMEOUT_MS=<KEYSHOT_TIMEOUT_MS> --env KEYSHOT_LICENSE_ARGS=<KEYSHOT_LICENSE_ARGS> --transport stdio keyshot-mcp -- npx -y keyshot-mcpЧто делает KeyShot MCP
KeyShot MCP подключает агент к локальному KeyShot через headless scripting. Он анализирует сохранённую сцену, находит камеры, меняет выбранные материалы и окружение, затем возвращает превью. Финальный рендер выполняется после проверки результата.
Сервер работает с копией сцены, поэтому исходный файл не перезаписывается. Он поддерживает несколько сохранённых камер и экспортирует PNG вместе с копией сцены. Агент получает данные сцены и превью, а настройки MCP-клиента могут передавать их выбранному провайдеру модели.
Без локально установленной лицензированной версии KeyShot с headless scripting сервер не запустится. В README указана проверка на Windows 11 с KeyShot Studio 2025 / KeyShot 14.1; также нужен Node.js 20+.
Какие задачи решает
- проверить сохранённую сцену KeyShot
- заменить материал выбранного объекта
- настроить камеру и окружение
- показать превью перед экспортом
- отрендерить копию сцены в PNG
Примеры запросов агенту
- Проверь сохранённую сцену KeyShot и перечисли доступные камеры.
- В копии сцены замени материал металлического объекта на brushed steel и покажи превью.
- После моего подтверждения отрендери PNG и сохрани копию сцены.
Как установить KeyShot MCP
Командой платформы
claude mcp add --env KEYSHOT_HEADLESS_EXE=<KEYSHOT_HEADLESS_EXE> --env KEYSHOT_OUTPUT_DIR=<KEYSHOT_OUTPUT_DIR> --env KEYSHOT_ALLOW_EXTERNAL_OUTPUTS=<KEYSHOT_ALLOW_EXTERNAL_OUTPUTS> --env KEYSHOT_TIMEOUT_MS=<KEYSHOT_TIMEOUT_MS> --env KEYSHOT_LICENSE_ARGS=<KEYSHOT_LICENSE_ARGS> --transport stdio keyshot-mcp -- npx -y keyshot-mcpВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Командой платформы
codex mcp add keyshot-mcp --env KEYSHOT_HEADLESS_EXE=<KEYSHOT_HEADLESS_EXE> --env KEYSHOT_OUTPUT_DIR=<KEYSHOT_OUTPUT_DIR> --env KEYSHOT_ALLOW_EXTERNAL_OUTPUTS=<KEYSHOT_ALLOW_EXTERNAL_OUTPUTS> --env KEYSHOT_TIMEOUT_MS=<KEYSHOT_TIMEOUT_MS> --env KEYSHOT_LICENSE_ARGS=<KEYSHOT_LICENSE_ARGS> -- npx -y keyshot-mcpВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Файл настроек
{
"mcpServers": {
"keyshot-mcp": {
"command": "npx",
"args": [
"-y",
"keyshot-mcp"
],
"env": {
"KEYSHOT_HEADLESS_EXE": "<KEYSHOT_HEADLESS_EXE>",
"KEYSHOT_OUTPUT_DIR": "<KEYSHOT_OUTPUT_DIR>",
"KEYSHOT_ALLOW_EXTERNAL_OUTPUTS": "<KEYSHOT_ALLOW_EXTERNAL_OUTPUTS>",
"KEYSHOT_TIMEOUT_MS": "<KEYSHOT_TIMEOUT_MS>",
"KEYSHOT_LICENSE_ARGS": "<KEYSHOT_LICENSE_ARGS>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Файл настроек
{
"servers": {
"keyshot-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"keyshot-mcp"
],
"env": {
"KEYSHOT_HEADLESS_EXE": "<KEYSHOT_HEADLESS_EXE>",
"KEYSHOT_OUTPUT_DIR": "<KEYSHOT_OUTPUT_DIR>",
"KEYSHOT_ALLOW_EXTERNAL_OUTPUTS": "<KEYSHOT_ALLOW_EXTERNAL_OUTPUTS>",
"KEYSHOT_TIMEOUT_MS": "<KEYSHOT_TIMEOUT_MS>",
"KEYSHOT_LICENSE_ARGS": "<KEYSHOT_LICENSE_ARGS>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Командой платформы
gemini mcp add -e KEYSHOT_HEADLESS_EXE=<KEYSHOT_HEADLESS_EXE> -e KEYSHOT_OUTPUT_DIR=<KEYSHOT_OUTPUT_DIR> -e KEYSHOT_ALLOW_EXTERNAL_OUTPUTS=<KEYSHOT_ALLOW_EXTERNAL_OUTPUTS> -e KEYSHOT_TIMEOUT_MS=<KEYSHOT_TIMEOUT_MS> -e KEYSHOT_LICENSE_ARGS=<KEYSHOT_LICENSE_ARGS> keyshot-mcp npx -y keyshot-mcpВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о KeyShot MCP
Как установить KeyShot MCP в Claude Code?
Выполните claude mcp add keyshot-mcp -e KEYSHOT_HEADLESS_EXE=<KEYSHOT_HEADLESS_EXE> -- npx -y keyshot-mcp.
Что делает KeyShot MCP?
Сервер связывает агент с локальным KeyShot: проверяет сохранённые сцены, меняет материалы, камеры и окружение, возвращает превью и запускает рендер копии.
Какая версия KeyShot нужна для работы?
В README указана проверка на Windows 11 с KeyShot Studio 2025 / KeyShot 14.1. Нужна лицензированная установка с headless scripting.
