Verse

oficial

Publica escenas 3D, recorridos y mundos, desde un solo producto hasta una ciudad entera, como enlaces que se abren en cualquier navegador. Tu asistente recibe un enlace, código para insertar, enlaces privados para compartir y visitas guiadas. Inicia sesión con Verse, no se necesita una clave de API.

¿Qué puedes hacer con Verse MCP?

  • Publicar una escena — Pídele a tu asistente que suba un archivo local o una URL pública y te devuelva un enlace de Verse, código de inserción o enlace para compartir.
  • Gestionar la visibilidad — Configura una escena como pública, no listada o privada, y obtén un enlace con token revocable para compartir escenas privadas.
  • Consultar el estado de compilación — Pregunta por el estado de compilación, el progreso y el tiempo estimado de una escena, y obtén el enlace cuando esté lista.
  • Obtener el código de inserción — Solicita opciones de inserción con iframe, el elemento <verse-viewer> o una URL simple para una escena publicada.
  • Crear recorridos de cámara — Consulta, configura, vuelve a planificar o elimina rutas de cámara guiadas para el recorrido aéreo de una escena.
  • Crear enlaces de carga — Genera un enlace de un solo uso válido durante 30 minutos para un archivo que no puedes entregar directamente y luego consulta su estado.

Servidor MCP alojado

npx add-mcp 'https://verse.ctruh.com/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

@ctruhtech/verse-mcp

Verse MCP server

Un servidor MCP para Verse Engine, que publica escenas 3D, recorridos y mundos, desde un solo producto hasta una ciudad entera, como enlaces que se abren en cualquier navegador en dispositivos de uso cotidiano. Conéctalo a Claude, ChatGPT, Cursor, VS Code o a tu propio agente, y tu asistente podrá publicar un archivo o una URL pública y devolverte un enlace de Verse, código para insertar, un enlace privado para compartir o un recorrido guiado con cámara.

"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."

Con licencia MIT. Documentación: https://verse.ctruh.com/docs/#/mcp. Página de instalación con botones de un solo clic: https://verse.ctruh.com/mcp.

Conéctate en un paso: inicia sesión con Verse

Añade https://verse.ctruh.com/mcp a tu asistente e inicia sesión con tu cuenta de Verse en el navegador. No hace falta copiar ninguna clave de API ni instalar nada.

  • Claude (web y escritorio): Settings → Connectors → Add custom connector → URL https://verse.ctruh.com/mcp → Add y, después, Connect.
  • Claude Code: claude mcp add --transport http --scope user verse https://verse.ctruh.com/mcp; luego ejecuta /mcp y elige Authenticate.
  • ChatGPT: Settings → Connectors → Create (developer mode) → URL https://verse.ctruh.com/mcp, autenticación OAuth → Create y, después, inicia sesión.
  • Cursor: Añadir a Cursor, o { "mcpServers": { "verse": { "url": "https://verse.ctruh.com/mcp" } } } en ~/.cursor/mcp.json; luego, Connect en Settings → MCP.
  • VS Code: Instalar en VS Code, o { "servers": { "verse": { "type": "http", "url": "https://verse.ctruh.com/mcp" } } } en .vscode/mcp.json; luego, Start.

La primera vez, una página de Verse te pedirá que inicies sesión (con un código por correo electrónico o WhatsApp) y pulses Allow. La aplicación obtiene una clave llamada "MCP · " en tu página de cuenta; dura 30 días, se renueva mientras se usa y puedes revocarla allí.

¿Prefieres ejecutarlo localmente con una clave de API? Consulta Configuración (stdio) más abajo: npx -y @ctruhtech/verse-mcp, Node 20 o posterior.

Herramientas

HerramientaQué hace
upload_sceneConvierte una ruta local o una URL pública en un enlace de Verse. Reanudable para archivos grandes, con notificaciones de progreso y espera a que termine la compilación.
get_scene_statusEstado de la compilación, progreso y tiempo estimado; muestra el enlace al terminar.
list_scenesEscenas de tu cuenta.
create_share_linkEstablece la visibilidad (pública / no listada / privada); las escenas privadas obtienen un enlace con un token para compartir que se puede revocar. Reproducción automática opcional de la ruta de cámara.
revoke_share_linkRevoca un token privado para compartir (o muestra los activos).
get_embed_codeiframe, elemento <verse-viewer> y URL simple.
list_camera_paths, set_camera_path, reset_auto_camera_path, delete_camera_pathRecorridos guiados: consultar, crear, volver a planificar el recorrido automático o eliminar uno.
create_upload_linkPara un archivo que el usuario tiene, pero no puede entregar directamente (un archivo adjunto del chat o un archivo en un teléfono): un enlace de un solo uso válido durante 30 minutos donde puede subirlo; el archivo se guarda en su cuenta.
get_upload_link_statusEstado de un enlace de carga: en espera, cargando, compilando, completado (escena y enlace), fallido o caducado.

Cada herramienta es una capa fina sobre la API REST pública (referencia de la API) a través de @ctruhtech/verse-sdk. No hay ninguna herramienta para generar mundos, porque la API no tiene ese endpoint. Los enlaces para compartir no caducan por sí solos; la API no ofrece caducidad, así que revoca un enlace privado para poner fin al acceso. Los errores se devuelven en una sola frase sin formato.

Credenciales

Establece VERSE_API_KEY en uno de estos valores:

  • una clave de API del espacio de trabajo vk_... de tu página de cuenta (tarjeta API keys). Actúa como miembro de ese espacio de trabajo: cargas, escenas, visibilidad, enlaces privados y rutas de cámara;
  • tu token de cuenta (64 caracteres hexadecimales, de Studio). Tiene los mismos permisos y está vinculado a ti.

Ambos se envían como Authorization: Bearer. Para cargar archivos se necesita una cuenta gratuita de Verse; para abrir un enlace publicado no. VERSE_BASE_URL apunta a otro origen (por defecto, https://verse.ctruh.com). La clave solo se envía a ese origen como encabezado; nunca se registra ni se devuelve en la salida de las herramientas. VERSE_UPLOAD_KEY (opcional) es el X-API-Key de un servidor autoalojado que se ejecuta en modo con clave.

Configuración (stdio)

Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %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 (o .cursor/mcp.json en un proyecto); usa el mismo JSON que 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}" }
    }
  }
}

Remoto (Streamable HTTP)

La configuración para iniciar sesión está al principio de esta página. Las claves de API siguen funcionando: envía Authorization: Bearer <key> (una clave de la página de cuenta o tu token de cuenta) y no se iniciará ninguna sesión.

Para clientes que solo aceptan un encabezado fijo (agentes alojados, scripts):

{
  "mcpServers": {
    "verse": {
      "url": "https://verse.ctruh.com/mcp",
      "headers": { "Authorization": "Bearer paste-your-key" }
    }
  }
}

Claude Code con una clave en lugar de iniciar sesión: claude mcp add --transport http verse https://verse.ctruh.com/mcp --header "Authorization: Bearer $VERSE_API_KEY". No se almacena nada entre solicitudes y las rutas de archivos locales están deshabilitadas en el servidor remoto (pasa URL públicas). Si una solicitud no incluye una clave ni una sesión iniciada, se responde con 401, WWW-Authenticate: Bearer realm="verse-mcp", resource_metadata="…" y un error JSON-RPC que indica qué se debe enviar.

Para alojarlo tú mismo:

VERSE_BASE_URL=https://verse.ctruh.com npx @ctruhtech/verse-mcp --http --port 8787   # http://127.0.0.1:8787/mcp

Configura TLS delante del servidor. Para montarlo dentro de un servidor Node existente:

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);

Línea de comandos

verse-mcp                 stdio server
verse-mcp --http [--port 8787] [--host 127.0.0.1] [--allow-anonymous]
verse-mcp --version

Desarrollo

npm install
npm run typecheck
npm test                  # scripted Verse origin, both transports, driven by the official MCP client

Problemas y código fuente: https://github.com/dev-vinayagastya/verse-mcp. Licencia: MIT; consulta LICENSE.