Vectreal — MCP-сервер для Claude Code: загрузка и публикация 3D-моделей
MCP-сервер для Claude Code, Cursor и других агентов: загружает GLB-модели, публикует их на платформе Vectreal и генерирует embed-код для встраивания на сайты. Работает через CLI с сохранением сессии в OS keychain.
AGPL-3.0 ★ 27 обновлён 2026-10-29
claude mcp add vectreal -- npx -y @vctrl/cliЧто делает Vectreal
Сервер устанавливается через @vctrl/cli и предоставляет агенту набор инструментов для работы с 3D-сценами. Загружает локальные GLB-файлы как черновики, анализирует модели (размер, меши, материалы, анимации), меняет параметры окружения и управления камерой, сжимает сцены (Draco, KTX2) при публикации и выдаёт встраиваемые фрагменты кода.
Отрицаёт работу без предварительного входа через vectreal login — сессия хранится в OS keychain (Keychain на macOS, Credential Manager на Windows, Secret Service на Linux). На headless-серверах без Secret Service падает в ~/.config/vectreal/credentials.json. Привязывается к проекту в текущей директории через vectreal init, дальше инструменты используют этот проект по умолчанию; можно перейти на другой через аргумент --project.
Получает доступ к документации Vectreal через search_docs и read_doc без входа. Список и создание проектов, сцен, управление опубликованными моделями — только в рамках аутентифицированной сессии.
Какие задачи решает
- загрузить 3D-модель как черновик и опубликовать её на сервере
- встроить опубликованную 3D-сцену на веб-сайт с конфигурацией
- проверить размер и структуру GLB-модели перед загрузкой
- управлять параметрами 3D-сцены (окружение, камера, тени) из агента
- опубликовать несколько моделей в одном проекте и выдать ссылки
Примеры запросов агенту
- Загрузи модель
character.glbкак новую сцену в проект - Сжми и опубликуй сцену, потом дай мне код для встраивания
- Покажи, какие меши и материалы в файле
scene.glb, без загрузки
Как установить Vectreal
Командой платформы
claude mcp add vectreal -- npx -y @vctrl/cliКомандой платформы
codex mcp add cli -- npx -y @vctrl/cliФайл настроек
{
"mcpServers": {
"cli": {
"command": "npx",
"args": [
"-y",
"@vctrl/cli"
]
}
}
}Файл настроек
{
"servers": {
"cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@vctrl/cli"
]
}
}
}Командой платформы
gemini mcp add cli npx -y @vctrl/cliПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Vectreal
Как установить Vectreal в Claude Code?
Выполни claude mcp add vectreal -- npx -y @vctrl/cli mcp в директории проекта. Сервер появится в списке MCP-инструментов Claude Code.
Что делает Vectreal?
MCP-сервер загружает 3D-модели на платформу Vectreal, управляет их параметрами (свет, камера, анимация) и выдаёт встраиваемый код для размещения на сайтах. Агенты могут делать это прямо во время разработки.
Нужна ли регистрация перед использованием?
Да, требуется запустить vectreal login один раз — сессия сохранится в OS keychain и будет использоваться всеми командами. Без входа инструменты вернут ошибку 3.