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 Engine용 MCP 서버입니다. 단일 제품부터 도시 전체까지 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에 추가하거나
~/.cursor/mcp.json에서{ "mcpServers": { "verse": { "url": "https://verse.ctruh.com/mcp" } } }를 실행한 다음 Settings → MCP에서 Connect를 누릅니다. - VS Code: VS Code에 설치하거나
.vscode/mcp.json에서{ "servers": { "verse": { "type": "http", "url": "https://verse.ctruh.com/mcp" } } }을 실행한 다음 Start를 누릅니다.
처음 연결할 때 Verse 페이지에서 로그인(이메일 또는 WhatsApp 코드)한 다음 Allow를 누르라는 메시지가 표시됩니다. 앱은 계정 페이지에 "MCP · "라는 키를 발급합니다. 이 키는 30일 동안 유효하고 사용 중에는 갱신되며, 해당 페이지에서 언제든지 취소할 수 있습니다.
API 키를 사용해 로컬에서 실행하려면 아래의 설정(stdio)을 참조하세요. npx -y @ctruhtech/verse-mcp, Node 20 이상이 필요합니다.
도구
| 도구 | 기능 |
|---|---|
upload_scene | 로컬 경로나 공개 URL을 Verse 링크로 변환합니다. 대용량 파일은 이어서 업로드할 수 있으며, 진행 상황 알림을 제공하고 빌드가 완료될 때까지 기다립니다. |
get_scene_status | 빌드 상태, 진행 상황, 예상 완료 시간(ETA)을 표시하고, 완료되면 링크를 제공합니다. |
list_scenes | 계정 소유 장면을 표시합니다. |
create_share_link | 공개 범위(공개 / 미등록 / 비공개)를 설정합니다. 비공개 장면에는 취소 가능한 공유 토큰 링크가 제공됩니다. 카메라 경로 자동 재생을 선택할 수 있습니다. |
revoke_share_link | 비공개 공유 토큰을 취소하거나 활성 토큰을 나열합니다. |
get_embed_code | iframe, <verse-viewer> 요소 및 일반 URL을 제공합니다. |
list_camera_paths, set_camera_path, reset_auto_camera_path, delete_camera_path | 안내 투어를 읽고, 작성하고, 자동 비행 경로를 다시 계획하거나 삭제합니다. |
create_upload_link | 사용자가 가지고 있지만 직접 전달할 수 없는 파일(채팅 첨부 파일이나 휴대폰에 있는 파일)을 위한 도구입니다. 파일을 업로드할 수 있는 30분 유효 단일 사용 링크를 만들며, 업로드된 파일은 사용자 계정에 저장됩니다. |
get_upload_link_status | 업로드 링크의 상태를 확인합니다. 대기 중, 업로드 중, 빌드 중, 완료(장면 및 링크), 실패 또는 만료 상태를 표시합니다. |
모든 도구는 @ctruhtech/verse-sdk을 통해 공개 REST API(API 참조)를 호출하는 얇은 래퍼입니다. API에 월드 생성 엔드포인트가 없으므로 월드 생성 도구는 없습니다. 공유 링크는 자동으로 만료되지 않습니다. API에 만료 기능이 없으므로 접근을 종료하려면 비공개 링크를 취소하세요. 오류는 일반 문장 하나로 반환됩니다.
자격 증명
VERSE_API_KEY에는 다음 중 하나를 설정합니다.
- 계정 페이지의 API keys 카드에서 발급한 워크스페이스 API 키
vk_.... 해당 워크스페이스의 구성원 권한으로 업로드, 장면, 공개 범위, 비공개 링크 및 카메라 경로를 사용할 수 있습니다. - 계정 토큰(64자리 16진수, 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), Claude Desktop과 동일한 JSON을 사용합니다.
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를 참조하세요.