Verse
officielPubliez des scènes 3D, des visites guidées et des mondes, d’un seul produit à une ville entière, sous forme de liens qui s’ouvrent dans n’importe quel navigateur. Votre assistant reçoit un lien, un code d’intégration, des liens de partage privés et des visites guidées. Connectez-vous avec Verse, aucune clé API n’est nécessaire.
Que pouvez-vous faire avec Verse MCP ?
- Publier une scène — Demandez à votre assistant de téléverser un fichier local ou une URL publique et de renvoyer un lien Verse, un code d’intégration ou un lien de partage.
- Gérer la visibilité — Définissez une scène comme publique, non répertoriée ou privée, et obtenez un lien de partage révocable avec jeton pour les scènes privées.
- Vérifier l’état de la génération — Demandez l’état de génération d’une scène, sa progression et le délai estimé, puis obtenez le lien une fois l’opération terminée.
- Obtenir le code d’intégration — Demandez des options d’intégration sous forme d’iframe, d’élément
<verse-viewer>ou d’URL simple pour une scène publiée. - Créer des visites guidées par caméra — Consultez, définissez, replanifiez ou supprimez des trajectoires de caméra guidées pour le survol d’une scène.
- Créer des liens de téléversement — Générez un lien à usage unique valable 30 minutes pour un fichier que vous ne pouvez pas transmettre directement, puis vérifiez son état.
Serveur MCP hébergé
npx add-mcp 'https://verse.ctruh.com/mcp'S’installe dans Claude Code, Codex, Cursor et plus
Documentation
@ctruhtech/verse-mcp
Un serveur MCP pour Verse Engine, qui publie des scènes 3D, des visites guidées et des mondes, d’un seul produit à une ville entière, sous forme de liens qui s’ouvrent dans n’importe quel navigateur sur les appareils du quotidien. Connectez-le à Claude, ChatGPT, Cursor, VS Code ou à votre propre agent : votre assistant pourra publier un fichier ou une URL publique et vous renvoyer un lien Verse, du code d’intégration, un lien de partage privé ou une visite guidée avec caméra.
"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."
Sous licence MIT. Documentation : https://verse.ctruh.com/docs/#/mcp. Page d’installation avec boutons en un clic : https://verse.ctruh.com/mcp.
Connexion en une étape : connectez-vous avec Verse
Ajoutez https://verse.ctruh.com/mcp à votre assistant et connectez-vous avec votre compte Verse dans le navigateur. Pas de clé API à copier, rien à installer.
- Claude (web et ordinateur) : Settings → Connectors → Add custom connector → URL
https://verse.ctruh.com/mcp→ Add, puis Connect. - Claude Code :
claude mcp add --transport http --scope user verse https://verse.ctruh.com/mcp, puis exécutez/mcpet choisissez Authenticate. - ChatGPT : Settings → Connectors → Create (developer mode) → URL
https://verse.ctruh.com/mcp, authentication OAuth → Create, puis connectez-vous. - Cursor : Ajouter à Cursor, ou
{ "mcpServers": { "verse": { "url": "https://verse.ctruh.com/mcp" } } }dans~/.cursor/mcp.json, puis Connect dans Settings → MCP. - VS Code : Installer dans VS Code, ou
{ "servers": { "verse": { "type": "http", "url": "https://verse.ctruh.com/mcp" } } }dans.vscode/mcp.json, puis Start.
La première fois, une page Verse vous demande de vous connecter (code par e-mail ou WhatsApp), puis d’appuyer sur Allow. L’application reçoit une clé nommée « MCP · » sur votre page de compte ; elle est valable 30 jours, est renouvelée tant qu’elle est utilisée et peut être révoquée depuis cette page.
Vous préférez l’exécuter localement avec une clé API ? Consultez Configuration (stdio) ci-dessous : npx -y @ctruhtech/verse-mcp, Node 20 ou version ultérieure.
Outils
| Outil | Fonction |
|---|---|
upload_scene | Chemin local ou URL publique, converti en lien Verse. Reprise possible pour les fichiers volumineux, notifications de progression et attente de la fin de la génération. |
get_scene_status | État de la génération, progression et délai estimé ; lien une fois la génération terminée. |
list_scenes | Scènes appartenant à votre compte. |
create_share_link | Définir la visibilité (public / non répertorié / privé) ; les scènes privées reçoivent un lien de partage avec jeton révocable. Lecture automatique facultative du parcours de caméra. |
revoke_share_link | Révoquer un jeton de partage privé (ou répertorier les jetons actifs). |
get_embed_code | iframe, élément <verse-viewer> et URL simple. |
list_camera_paths, set_camera_path, reset_auto_camera_path, delete_camera_path | Visites guidées : consulter, créer, replanifier le survol automatique ou supprimer une visite. |
create_upload_link | Pour un fichier que l’utilisateur possède, mais ne peut pas transmettre (pièce jointe d’une conversation, fichier sur un téléphone) : un lien à usage unique valable 30 minutes où il peut déposer le fichier, qui sera ajouté à son compte. |
get_upload_link_status | État d’un lien de téléversement : en attente, téléversement, génération, terminé (scène et lien), échec ou expiration. |
Chaque outil est une simple enveloppe autour de l’API REST publique (référence de l’API) via @ctruhtech/verse-sdk. Il n’existe pas d’outil de génération de mondes, car l’API ne propose pas de point de terminaison correspondant. Les liens de partage n’expirent pas d’eux-mêmes ; l’API ne prévoit pas d’expiration, il faut donc révoquer un lien privé pour mettre fin à l’accès. Les erreurs sont renvoyées sous la forme d’une seule phrase en texte brut.
Identifiants
Définissez VERSE_API_KEY sur l’une des valeurs suivantes :
- une clé API d’espace de travail
vk_...disponible sur votre page de compte (carte API keys). Elle agit comme un membre de cet espace de travail : téléversements, scènes, visibilité, liens privés et parcours de caméra ; - votre jeton de compte (64 caractères hexadécimaux, depuis Studio). Il offre les mêmes droits et est associé à votre compte.
Les deux sont transmis sous la forme de Authorization: Bearer. Le téléversement nécessite un compte Verse gratuit ; l’ouverture d’un lien publié n’en nécessite pas. VERSE_BASE_URL pointe vers une autre origine (par défaut https://verse.ctruh.com). La clé est uniquement envoyée à cette origine dans un en-tête ; elle n’est jamais consignée dans les journaux ni renvoyée dans la sortie d’un outil. VERSE_UPLOAD_KEY (facultatif) correspond au X-API-Key d’un serveur auto-hébergé exécuté en mode avec clé.
Configuration (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 dans un projet), même JSON que pour 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}" }
}
}
}
Distant (Streamable HTTP)
La configuration de la connexion se trouve en haut de cette page. Les clés API restent utilisables : envoyez Authorization: Bearer <key> (une clé de la page de compte ou votre jeton de compte) ; aucune connexion ne sera demandée.
Pour les clients qui n’acceptent qu’un en-tête fixe (agents hébergés, scripts) :
{
"mcpServers": {
"verse": {
"url": "https://verse.ctruh.com/mcp",
"headers": { "Authorization": "Bearer paste-your-key" }
}
}
}
Claude Code avec une clé plutôt qu’une connexion : claude mcp add --transport http verse https://verse.ctruh.com/mcp --header "Authorization: Bearer $VERSE_API_KEY". Rien n’est stocké entre les requêtes et les chemins de fichiers locaux sont désactivés sur le serveur distant (transmettez des URL publiques). Une requête sans clé ni connexion reçoit 401 avec WWW-Authenticate: Bearer realm="verse-mcp", resource_metadata="…" et une erreur JSON-RPC indiquant les informations à transmettre.
Pour l’héberger vous-même :
VERSE_BASE_URL=https://verse.ctruh.com npx @ctruhtech/verse-mcp --http --port 8787 # http://127.0.0.1:8787/mcp
Placez TLS devant le serveur. Pour le monter dans un serveur Node existant :
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);
Ligne de commande
verse-mcp stdio server
verse-mcp --http [--port 8787] [--host 127.0.0.1] [--allow-anonymous]
verse-mcp --version
Développement
npm install
npm run typecheck
npm test # scripted Verse origin, both transports, driven by the official MCP client
Problèmes et code source : https://github.com/dev-vinayagastya/verse-mcp. Licence : MIT, voir LICENSE.