Verse
oficialPublique 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
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/mcpe 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
| Ferramenta | O que faz |
|---|---|
upload_scene | Caminho 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_status | Estado da compilação, progresso e tempo estimado; o link quando estiver pronto. |
list_scenes | Cenas pertencentes à sua conta. |
create_share_link | Define 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_link | Revoga um token de compartilhamento privado (ou lista os ativos). |
get_embed_code | iframe, elemento <verse-viewer> e URL simples. |
list_camera_paths, set_camera_path, reset_auto_camera_path, delete_camera_path | Tours guiados: ler, criar, replanejar o sobrevoo automático ou excluir um tour. |
create_upload_link | Para 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_status | O 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.