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

Verse MCP server

Сервер 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_codeiframe, элемент <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.