Verse

oficial

Publique cenas 3D, tours guiados e mundos, de um único produto a uma cidade inteira, como links que abrem em qualquer navegador. Seu assistente recebe um link, código de incorporação, links privados para compartilhamento e tours guiados. Entre com Verse, sem precisar de chave de API.

O que você pode fazer com Verse MCP?

  • Publicar uma cena — Peça ao seu assistente para enviar um arquivo local ou URL pública e retornar um link do Verse, código de incorporação ou link de compartilhamento.
  • Gerenciar a visibilidade — Defina uma cena como pública, não listada ou privada e obtenha um link com token de compartilhamento revogável para cenas privadas.
  • Verificar o status da compilação — Peça o estado, o progresso e o tempo estimado de conclusão da compilação de uma cena e receba o link quando ela estiver pronta.
  • Obter o código de incorporação — Solicite opções de incorporação por iframe, elemento <verse-viewer> ou URL simples para uma cena publicada.
  • Criar tours de câmera — Leia, defina, planeje novamente ou exclua trajetórias guiadas de câmera para o sobrevoo de uma cena.
  • Criar links de envio — Gere um link de uso único válido por 30 minutos para um arquivo que você não pode entregar diretamente e, em seguida, verifique o status.

Servidor MCP hospedado

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

Instala no Claude Code, Codex, Cursor e outros

Documentação

@ctruhtech/verse-mcp

Verse MCP server

Um servidor MCP para o Verse Engine, que publica cenas 3D, passeios virtuais e mundos, de um único produto a uma cidade inteira, como links que abrem em qualquer navegador em dispositivos do dia a dia. Conecte-o ao Claude, ChatGPT, Cursor, VS Code ou ao seu próprio agente, e seu assistente poderá publicar um arquivo ou uma URL pública e devolver um link do Verse, código de incorporação, um link privado de compartilhamento ou um tour guiado por câmera.

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

Licenciado sob MIT. Documentação: https://verse.ctruh.com/docs/#/mcp. Página de instalação com botões de um clique: https://verse.ctruh.com/mcp.

Conecte em uma etapa: entre com o Verse

Adicione https://verse.ctruh.com/mcp ao seu assistente e entre com sua conta Verse no navegador. Não é preciso copiar uma chave de API nem instalar nada.

  • Claude (web e desktop): Settings → Connectors → Add custom connector → URL https://verse.ctruh.com/mcp → Add e, em seguida, Connect.
  • Claude Code: claude mcp add --transport http --scope user verse https://verse.ctruh.com/mcp, depois execute /mcp e escolha Authenticate.
  • ChatGPT: Settings → Connectors → Create (developer mode) → URL https://verse.ctruh.com/mcp, autenticação OAuth → Create e, em seguida, entre.
  • Cursor: Adicionar ao Cursor, ou { "mcpServers": { "verse": { "url": "https://verse.ctruh.com/mcp" } } } em ~/.cursor/mcp.json, depois Connect em Settings → MCP.
  • VS Code: Instalar no VS Code, ou { "servers": { "verse": { "type": "http", "url": "https://verse.ctruh.com/mcp" } } } em .vscode/mcp.json, depois Start.

Na primeira vez, uma página do Verse solicitará que você entre (com código por e-mail ou WhatsApp) e pressione Allow. O app recebe uma chave chamada "MCP · " na sua página da conta; ela dura 30 dias, é renovada enquanto estiver em uso e pode ser revogada nessa página.

Prefere executá-lo localmente, com uma chave de API? Consulte Configuração (stdio) abaixo: npx -y @ctruhtech/verse-mcp, Node 20 ou mais recente.

Ferramentas

FerramentaO que faz
upload_sceneCaminho local ou URL pública para um link do Verse. Pode ser retomado para arquivos grandes, envia notificações de progresso e aguarda a conclusão da compilação.
get_scene_statusEstado da compilação, progresso e tempo estimado; o link quando estiver pronto.
list_scenesCenas pertencentes à sua conta.
create_share_linkDefine a visibilidade (pública / não listada / privada); cenas privadas recebem um link de compartilhamento com token revogável. Reprodução automática opcional do percurso da câmera.
revoke_share_linkRevoga um token de compartilhamento privado (ou lista os ativos).
get_embed_codeiframe, elemento <verse-viewer> e URL simples.
list_camera_paths, set_camera_path, reset_auto_camera_path, delete_camera_pathTours guiados: ler, criar, replanejar o sobrevoo automático ou excluir um tour.
create_upload_linkPara um arquivo que o usuário tem, mas não pode enviar diretamente (um anexo de chat, um arquivo no celular): um link de uso único, válido por 30 minutos, onde ele pode enviar o arquivo; ele será salvo na conta do usuário.
get_upload_link_statusO que aconteceu com um link de envio: aguardando, enviando, compilando, concluído (cena e link), falhou ou expirou.

Cada ferramenta é um wrapper simples da API REST pública (referência da API) por meio de @ctruhtech/verse-sdk. Não há uma ferramenta de geração de mundos, pois a API não tem esse endpoint. Os links de compartilhamento não expiram por conta própria; como a API não oferece expiração, revogue um link privado para encerrar o acesso. Os erros são retornados em uma única frase simples.

Credenciais

Defina VERSE_API_KEY como uma destas opções:

  • uma chave de API do workspace vk_... da página da sua conta (cartão API keys). Ela atua como membro desse workspace: envios, cenas, visibilidade, links privados e percursos de câmera;
  • seu token de conta (64 caracteres hexadecimais, do Studio). Tem os mesmos poderes e está vinculado a você.

Ambos são enviados como Authorization: Bearer. Para enviar arquivos, é necessária uma conta Verse gratuita; para abrir um link publicado, não. VERSE_BASE_URL aponta para outra origem (padrão https://verse.ctruh.com). A chave só é enviada a essa origem como cabeçalho e nunca é registrada em logs nem retornada na saída da ferramenta. VERSE_UPLOAD_KEY (opcional) é o X-API-Key de um servidor auto-hospedado em execução no modo com chave.

Configuração (stdio)

Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %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 (ou .cursor/mcp.json em um projeto), o mesmo JSON do 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)

A configuração de login está no início desta página. As chaves de API continuam funcionando: envie Authorization: Bearer <key> (uma chave da página da conta ou seu token de conta) e não será necessário fazer login.

Para clientes que aceitam apenas um cabeçalho fixo (agentes hospedados, scripts):

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

Claude Code com uma chave em vez de login: claude mcp add --transport http verse https://verse.ctruh.com/mcp --header "Authorization: Bearer $VERSE_API_KEY". Nada é armazenado entre as solicitações, e os caminhos de arquivos locais são desativados no servidor remoto (passe URLs públicas). Uma solicitação sem chave ou login recebe 401 com WWW-Authenticate: Bearer realm="verse-mcp", resource_metadata="…" e um erro JSON-RPC que informa o que enviar.

Para hospedá-lo por conta própria:

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

Configure TLS na frente dele. Para montá-lo dentro de um 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);

Linha de comando

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

Desenvolvimento

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

Problemas e código-fonte: https://github.com/dev-vinayagastya/verse-mcp. Licença: MIT, consulte LICENSE.