Usa Estanza dalla tua 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

Che cos'è

MCP, il Model Context Protocol, è uno standard aperto che permette a un assistente di IA di usare un altro servizio per te, come un'app del telefono usa la fotocamera dopo che glielo hai permesso.

Il server MCP di Estanza permette al tuo assistente di leggere le tue case e modificarle con gli stessi strumenti che usa l'editor di Estanza. Accedi a Estanza, non all'assistente, e puoi revocare l'accesso in qualsiasi momento.

Come collegarlo

Tutte le app usano lo stesso indirizzo. Trova la tua qui sotto, poi accedi a Estanza e consenti l'accesso quando te lo chiede.

https://api.estanza.casa/mcp

Claude: apri Customize e poi Connectors. Scegli Add custom connector, incolla l'indirizzo e accedi.
ChatGPT: attiva Developer mode in Settings, Security and login. Poi apri Plugins, premi + e incolla l'indirizzo.
Le Chat: apri Connectors. Scegli Add Connector, poi Custom MCP Connector, incolla l'indirizzo e accedi.
Cursor: Aggiungi a Cursor con un clic, poi accedi quando Cursor lo chiede.

Claude Code: esegui questo comando, poi /mcp per accedere.

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

Codex: esegui questo comando, poi codex mcp login estanza per accedere.
```
codex mcp add estanza --url https://api.estanza.casa/mcp
```
Qualsiasi altra app o agente: aggiungi un connettore o un server MCP personalizzato con l'indirizzo qui sopra. Un agente che modifica da solo la propria configurazione MCP vuole:
```
{"mcpServers":{"estanza":{"url":"https://api.estanza.casa/mcp"}}}
```

Le app di chat non possono aggiungere un connettore da un messaggio, quindi incolla l'indirizzo nelle loro impostazioni come indicato. Poi attiva Estanza in una chat e chiedi.

Cosa può fare la tua IA

Di' cosa vuoi, per esempio "trasforma la seconda camera in uno studio e metti la scrivania sotto la finestra". Il tuo assistente può:

Iniziare una casa, vuota o da uno dei modelli di Estanza.
Ricalcare l'immagine di una planimetria che gli dai: disegna le pareti e ti chiede una misura reale per impostare la scala.
Modificarla: stanze, piani, pareti, porte, finestre, scale, mobili, luci, cavi, giardino e note. Ogni modifica è una nuova versione, quindi puoi annullarla dall'editor.
Mostrartela: un'immagine della planimetria disegnata da Estanza e un link alla vista in 3D.
Pubblicarla e darti il link di condivisione e quello della card di Home Assistant, con i passaggi per mettere la card sulla tua dashboard.
Aggiungere un tuo modello 3D di un mobile e posizionarlo.

Ogni modifica compare anche nell'editor di Estanza, così puoi continuare a mano quando vuoi.

Limiti

Le modifiche fatte dalla tua IA non contano mai sulle domande dell'editor, perché a pensare è il tuo assistente. Restano i soliti limiti dell'account: numero di case, 100 MB di spazio, salvataggi al giorno e dimensione della casa.

Privacy

Solo case. Il tuo assistente vede le tue case e niente di personale: né email, né nome, né dati di accesso.
Il tuo assistente raggiunge solo le tue case, e solo dopo che hai effettuato l'accesso a Estanza e glielo hai permesso.
Non vede mai la tua password né la tua sessione di Estanza.
Pubblicare una casa richiede un permesso a parte.
Scollega qualsiasi app nell'app di Estanza, in Impostazioni, App collegate. Uscire da tutti i dispositivi o eliminare l'account le scollega tutte.
Leggi l'informativa sulla privacy per il resto.

Claude è un marchio di Anthropic. ChatGPT è un marchio di OpenAI. Le Chat è un marchio di Mistral AI. Cursor è un marchio di Anysphere. I loro marchi compaiono solo per indicare che Estanza funziona con loro; Estanza non è affiliata né approvata da nessuno di loro.