Utilisez Estanza via votre IA

For AI agents

Endpoint

https://api.estanza.casa/mcp, remote MCP over Streamable HTTP. Stateless: no session id, the home id is the only handle.

Auth

OAuth 2.1 with PKCE. An unsigned call gets HTTP 401 with WWW-Authenticate: Bearer resource_metadata=.... Clients register with a Client ID Metadata Document or dynamic client registration. The person signs in on an Estanza page; you never handle a password.

Scopes

homes:read, homes:write, homes:publish. Publishing is its own consent.

Units

Centimetres. Ids come from read_home. edit_home applies a list of actions all or nothing, one version per call; dry_run: true returns the plan picture without saving.

Errors

A business error is a normal result with isError: true, a plain sentence to repeat to the person, and a code in structuredContent, for example home_limit.

Seeing it

render_plan returns a PNG of a floor. view_url returns a capture link: open it in a headless browser, wait for html[data-ready="true"], then screenshot.

Models

upload_model takes a GLB. Every viewer and wall tablet downloads it on each load, so aim under 500 KB, never over 25 MB: real-world scale in metres, Y up, a few thousand triangles, textures 1024 px or less.

Plans

upload_plan puts a floor plan picture under a floor. Shrink it first without losing the lines: WebP only, no camera metadata, longest side about 2000 px, under 500 KB, never over 3 MB. Then read it yourself, draw the walls with edit_home, and ask the person for one real length to set the scale.

Data

Homes only. get_limits returns homes and storage used and allowed; no tool returns an email, a name or sign-in details.

Tools

homes:readget_limitslist_homesread_homerender_planview_urllist_versionssearch_cataloglist_templates

homes:writecreate_homerename_homeduplicate_homedelete_homeedit_homeundorestore_versionrequest_furnitureupload_modelupload_plan

homes:publishpublishunpublish

Index

/llms.txt

De quoi s'agit-il

MCP, le Model Context Protocol, est un standard ouvert qui permet à un assistant d'IA d'utiliser un autre service pour vous, comme une app de votre téléphone utilise l'appareil photo une fois que vous l'y avez autorisée.

Le serveur MCP d'Estanza permet à votre assistant de lire vos maisons et de les modifier avec les mêmes outils que l'éditeur Estanza. Vous vous connectez à Estanza, pas à l'assistant, et vous pouvez retirer l'accès à tout moment.

Comment le connecter

Toutes les apps utilisent la même adresse. Trouvez la vôtre ci-dessous, puis connectez-vous à Estanza et autorisez l'accès quand on vous le demande.

https://api.estanza.casa/mcp

Claude : ouvrez Customize, puis Connectors. Choisissez Add custom connector, collez l'adresse et connectez-vous.
ChatGPT : activez Developer mode dans Settings, Security and login. Ouvrez ensuite Plugins, appuyez sur + et collez l'adresse.
Le Chat : ouvrez Connectors. Choisissez Add Connector, puis Custom MCP Connector, collez l'adresse et connectez-vous.
Cursor : Ajouter à Cursor en un clic, puis connectez-vous quand Cursor le demande.

Claude Code : lancez cette commande, puis /mcp pour vous connecter.

claude mcp add --transport http estanza https://api.estanza.casa/mcp

Codex : lancez cette commande, puis codex mcp login estanza pour vous connecter.
```
codex mcp add estanza --url https://api.estanza.casa/mcp
```
Toute autre app ou agent : ajoutez un connecteur ou un serveur MCP personnalisé avec l'adresse ci-dessus. Un agent qui modifie sa propre configuration MCP attend ceci :
```
{"mcpServers":{"estanza":{"url":"https://api.estanza.casa/mcp"}}}
```

Les apps de chat ne peuvent pas ajouter un connecteur depuis un message : collez donc l'adresse dans leurs réglages comme indiqué. Activez ensuite Estanza dans une conversation et demandez.

Ce que votre IA peut faire

Dites ce que vous voulez, par exemple "fais de la deuxième chambre un bureau et place la table de travail sous la fenêtre". Votre assistant peut :

Commencer une maison, vierge ou à partir d'un des modèles Estanza.
Décalquer l'image d'un plan que vous lui donnez : il dessine les murs et vous demande une longueur réelle pour fixer l'échelle.
La modifier : pièces, étages, murs, portes, fenêtres, escaliers, meubles, lumières, câbles, jardin et notes. Chaque modification est une nouvelle version, que vous pouvez annuler depuis l'éditeur.
La montrer : une image du plan dessinée par Estanza et un lien vers la vue en 3D.
La publier et vous donner le lien de partage et celui de la carte Home Assistant, avec les étapes pour mettre la carte sur votre tableau de bord.
Ajouter votre propre modèle 3D d'un meuble et le placer.

Chaque modification apparaît aussi dans l'éditeur Estanza, pour que vous puissiez continuer à la main quand vous voulez.

Limites

Les modifications faites depuis votre IA ne comptent jamais dans les questions de l'éditeur, car c'est votre assistant qui réfléchit. Les limites habituelles du compte s'appliquent toujours : nombre de maisons, 100 Mo de stockage, enregistrements par jour et taille de la maison.

Confidentialité

Uniquement les maisons. Votre assistant voit vos maisons et rien de personnel : ni e-mail, ni nom, ni identifiants de connexion.
Votre assistant n'accède qu'à vos propres maisons, et seulement après que vous vous êtes connecté à Estanza et l'avez autorisé.
Il ne voit jamais votre mot de passe ni votre session Estanza.
Publier une maison demande une autorisation à part.
Déconnectez n'importe quelle app dans l'app Estanza, sous Paramètres, Apps connectées. Vous déconnecter partout ou supprimer votre compte les déconnecte toutes.
Consultez la politique de confidentialité pour le reste.

Claude est une marque d'Anthropic. ChatGPT est une marque d'OpenAI. Le Chat est une marque de Mistral AI. Cursor est une marque d'Anysphere. Leurs marques ne sont affichées que pour indiquer qu'Estanza fonctionne avec eux ; Estanza n'est affiliée à aucun d'eux ni approuvée par eux.