Verse
oficialPublica 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
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/mcpy 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
| Herramienta | Qué hace |
|---|---|
upload_scene | Convierte 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_status | Estado de la compilación, progreso y tiempo estimado; muestra el enlace al terminar. |
list_scenes | Escenas de tu cuenta. |
create_share_link | Establece 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_link | Revoca un token privado para compartir (o muestra los activos). |
get_embed_code | iframe, elemento <verse-viewer> y URL simple. |
list_camera_paths, set_camera_path, reset_auto_camera_path, delete_camera_path | Recorridos guiados: consultar, crear, volver a planificar el recorrido automático o eliminar uno. |
create_upload_link | Para 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_status | Estado 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.