Verse
официальныйПубликуйте 3D-сцены, интерактивные туры и миры — от отдельного продукта до целого города — в виде ссылок, которые открываются в любом браузере. Ваш ассистент получит ссылку, код для встраивания, приватные ссылки для доступа и экскурсии с гидом. Войдите через Verse — API-ключ не нужен.
Что можно делать с Verse MCP?
- Опубликовать сцену — Попросите ассистента загрузить локальный файл или общедоступный URL и вернуть ссылку Verse, код для встраивания или ссылку для общего доступа.
- Управлять видимостью — Сделайте сцену общедоступной, доступной по ссылке или приватной и получите отзывную ссылку с токеном для приватных сцен.
- Проверить статус сборки — Запросите состояние сборки сцены, ход выполнения и примерное время завершения, а когда всё будет готово — получите ссылку.
- Получить код для встраивания — Запросите варианты встраивания опубликованной сцены: iframe, элемент
<verse-viewer>или обычный URL. - Создавать маршруты камеры — Просматривайте, задавайте, перепланируйте или удаляйте маршруты камеры для виртуального пролёта по сцене.
- Создавать ссылки для загрузки — Создайте одноразовую ссылку на 30 минут для файла, который нельзя передать напрямую, а затем проверьте её статус.
Размещённый MCP-сервер
npx add-mcp 'https://verse.ctruh.com/mcp'Устанавливается в Claude Code, Codex, Cursor и другие
Документация
@ctruhtech/verse-mcp
Сервер MCP для Verse Engine, который публикует 3D-сцены, туры и миры — от отдельного продукта до целого города — в виде ссылок, открывающихся в любом браузере на обычных устройствах. Подключите его к Claude, ChatGPT, Cursor, VS Code или собственному агенту, и ваш помощник сможет опубликовать файл или общедоступный URL и вернуть вам ссылку Verse, код для встраивания, приватную ссылку для доступа или тур с управляемой камерой.
"Put https://example.com/villa.glb on Verse and give me a link I can share."
"Make that scene private and give me a link I can send to the client."
"I have a big file on my phone. Give me a Verse upload link for it."
"Give me the embed code for it, 1:1."
Лицензия MIT. Документация: https://verse.ctruh.com/docs/#/mcp. Страница установки с кнопками установки в один клик: https://verse.ctruh.com/mcp.
Подключение за один шаг: войдите через Verse
Добавьте https://verse.ctruh.com/mcp в свой помощник и войдите в браузере в аккаунт Verse. Не нужно копировать API-ключ или что-либо устанавливать.
- Claude (веб-версия и приложение для компьютера): Settings → Connectors → Add custom connector → URL
https://verse.ctruh.com/mcp→ Add, затем Connect. - Claude Code:
claude mcp add --transport http --scope user verse https://verse.ctruh.com/mcp, затем выполните/mcpи выберите Authenticate. - ChatGPT: Settings → Connectors → Create (developer mode) → URL
https://verse.ctruh.com/mcp, authentication OAuth → Create, затем войдите в аккаунт. - Cursor: Добавить в Cursor или
{ "mcpServers": { "verse": { "url": "https://verse.ctruh.com/mcp" } } }в~/.cursor/mcp.json, затем нажмите Connect в Settings → MCP. - VS Code: Установить в VS Code или
{ "servers": { "verse": { "type": "http", "url": "https://verse.ctruh.com/mcp" } } }в.vscode/mcp.json, затем нажмите Start.
При первом подключении откроется страница Verse: войдите в аккаунт (по коду из электронной почты или WhatsApp) и нажмите Allow. Приложение получит ключ с названием «MCP · » на вашей странице аккаунта. Срок действия ключа — 30 дней; при использовании он продлевается. Отозвать ключ можно там же.
Хотите запустить сервер локально с API-ключом? См. раздел Настройка (stdio) ниже: npx -y @ctruhtech/verse-mcp, Node 20 или новее.
Инструменты
| Инструмент | Назначение |
|---|---|
upload_scene | Преобразует локальный путь или общедоступный URL в ссылку Verse. Поддерживает возобновление загрузки больших файлов, уведомления о ходе выполнения и ожидание завершения сборки. |
get_scene_status | Состояние сборки, ход выполнения и примерное время до завершения; после завершения — ссылка. |
list_scenes | Сцены, принадлежащие вашему аккаунту. |
create_share_link | Изменение видимости (public / unlisted / private); для приватных сцен создаётся ссылка с отзываемым токеном доступа. Можно включить автовоспроизведение траектории камеры. |
revoke_share_link | Отзывает токен доступа к приватной сцене или показывает список активных токенов. |
get_embed_code | iframe, элемент <verse-viewer> и обычный URL. |
list_camera_paths, set_camera_path, reset_auto_camera_path, delete_camera_path | Туры с управляемой камерой: просмотр, создание, повторное планирование автоматического облёта или удаление тура. |
create_upload_link | Для файла, который есть у пользователя, но который он не может передать напрямую (вложение в чате, файл на телефоне): одноразовая ссылка на 30 минут, куда можно загрузить файл; он появится в аккаунте пользователя. |
get_upload_link_status | Состояние загрузки по ссылке: ожидание, загрузка, сборка, завершение (сцена и ссылка), ошибка или истечение срока действия. |
Каждый инструмент — это тонкая обёртка над публичным REST API (справочник API) через @ctruhtech/verse-sdk. Инструмента для генерации миров нет, поскольку в API отсутствует соответствующая конечная точка. Срок действия ссылок для доступа не истекает автоматически; в API нет настройки срока действия, поэтому отзовите приватную ссылку, чтобы закрыть доступ. Ошибки возвращаются в виде одного обычного предложения.
Учётные данные
Задайте VERSE_API_KEY одним из следующих значений:
- API-ключ рабочей области
vk_...со страницы аккаунта (карточка API keys). Он действует от имени участника этой рабочей области и позволяет загружать файлы, управлять сценами и их видимостью, приватными ссылками и траекториями камеры; - токен аккаунта (64 шестнадцатеричных символа, из Studio). Обладает теми же правами и привязан к вам.
Оба значения передаются как Authorization: Bearer. Для загрузки нужен бесплатный аккаунт Verse; для открытия опубликованной ссылки аккаунт не требуется. VERSE_BASE_URL указывает на другой источник (по умолчанию https://verse.ctruh.com). Ключ передаётся этому источнику только в заголовке и никогда не записывается в журнал и не возвращается в выводе инструмента. Необязательный параметр VERSE_UPLOAD_KEY — это X-API-Key самостоятельно размещённого сервера, работающего в режиме с ключом.
Настройка (stdio)
Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json:
{
"mcpServers": {
"verse": {
"command": "npx",
"args": ["-y", "@ctruhtech/verse-mcp"],
"env": { "VERSE_API_KEY": "paste-your-key" }
}
}
}
Claude Code:
claude mcp add verse --env VERSE_API_KEY=paste-your-key -- npx -y @ctruhtech/verse-mcp
Cursor: ~/.cursor/mcp.json (или .cursor/mcp.json в проекте); используется тот же JSON, что и для Claude Desktop.
VS Code: .vscode/mcp.json:
{
"inputs": [{ "type": "promptString", "id": "verse-key", "description": "Verse API key", "password": true }],
"servers": {
"verse": {
"command": "npx",
"args": ["-y", "@ctruhtech/verse-mcp"],
"env": { "VERSE_API_KEY": "${input:verse-key}" }
}
}
}
Удалённый сервер (Streamable HTTP)
Инструкции по входу приведены в начале этой страницы. API-ключи также поддерживаются: передайте Authorization: Bearer <key> (ключ со страницы аккаунта или токен аккаунта), и вход не потребуется.
Для клиентов, которые принимают только фиксированный заголовок (размещённые агенты, скрипты):
{
"mcpServers": {
"verse": {
"url": "https://verse.ctruh.com/mcp",
"headers": { "Authorization": "Bearer paste-your-key" }
}
}
}
Claude Code с ключом вместо входа: claude mcp add --transport http verse https://verse.ctruh.com/mcp --header "Authorization: Bearer $VERSE_API_KEY". Данные между запросами не сохраняются, а локальные пути к файлам на удалённом сервере отключены (передавайте общедоступные URL). На запрос без ключа или входа сервер ответит 401 с WWW-Authenticate: Bearer realm="verse-mcp", resource_metadata="…" и ошибкой JSON-RPC, в которой указано, что нужно передать.
Чтобы разместить сервер самостоятельно:
VERSE_BASE_URL=https://verse.ctruh.com npx @ctruhtech/verse-mcp --http --port 8787 # http://127.0.0.1:8787/mcp
Настройте TLS перед сервером. Чтобы подключить его к существующему серверу Node:
import { createHttpHandler } from "@ctruhtech/verse-mcp";
const mcp = createHttpHandler({ baseUrl: "https://verse.ctruh.com" });
// in your request listener: if (url.pathname === "/mcp") return mcp(req, res);
Командная строка
verse-mcp stdio server
verse-mcp --http [--port 8787] [--host 127.0.0.1] [--allow-anonymous]
verse-mcp --version
Разработка
npm install
npm run typecheck
npm test # scripted Verse origin, both transports, driven by the official MCP client
Сообщения об ошибках и исходный код: https://github.com/dev-vinayagastya/verse-mcp. Лицензия: MIT, см. LICENSE.