Usa a Estanza com a 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

O que é

O MCP, Model Context Protocol, é uma norma aberta que permite a um assistente de IA usar outro serviço por ti, tal como uma app do telemóvel usa a câmara depois de lhe dares autorização.

O servidor MCP da Estanza permite ao teu assistente ler as tuas casas e alterá-las com as mesmas ferramentas que o editor da Estanza usa. Inicias sessão na Estanza, não no assistente, e podes retirar o acesso quando quiseres.

Como ligar

Todas as apps usam o mesmo endereço. Procura a tua abaixo, depois inicia sessão na Estanza e autoriza o acesso quando to pedir.

https://api.estanza.casa/mcp

Claude: abre Customize e depois Connectors. Escolhe Add custom connector, cola o endereço e inicia sessão.
ChatGPT: liga o Developer mode em Settings, Security and login. Depois abre Plugins, carrega em + e cola o endereço.
Le Chat: abre Connectors. Escolhe Add Connector, depois Custom MCP Connector, cola o endereço e inicia sessão.
Cursor: Adicionar ao Cursor com um clique, e inicia sessão quando o Cursor pedir.

Claude Code: executa isto e depois /mcp para iniciar sessão.

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

Codex: executa isto e depois codex mcp login estanza para iniciar sessão.
```
codex mcp add estanza --url https://api.estanza.casa/mcp
```
Qualquer outra app ou agente: adiciona um conector ou servidor MCP personalizado com o endereço acima. Um agente que edita a sua própria configuração MCP precisa disto:
```
{"mcpServers":{"estanza":{"url":"https://api.estanza.casa/mcp"}}}
```

As apps de chat não conseguem adicionar um conector a partir de uma mensagem, por isso cola o endereço nas definições delas, como se mostra acima. Depois ativa a Estanza numa conversa e pede.

O que a tua IA pode fazer

Diz o que queres, por exemplo "transforma o segundo quarto num escritório e põe a secretária debaixo da janela". O teu assistente pode:

Começar uma casa, em branco ou a partir de um dos modelos da Estanza.
Decalcar uma imagem de uma planta que lhe dês: desenha as paredes e pede-te uma medida real para acertar a escala.
Alterá-la: divisões, pisos, paredes, portas, janelas, escadas, móveis, luzes, cabos, jardim e notas. Cada alteração é uma nova versão, por isso podes anulá-la no editor.
Mostrá-la: uma imagem da planta desenhada pela Estanza e uma ligação para a vista em 3D.
Publicá-la e dar-te a ligação para partilhar e a do cartão do Home Assistant, com os passos para pôr o cartão no teu painel.
Adicionar o teu próprio modelo 3D de um móvel e colocá-lo.

Cada alteração aparece também no editor da Estanza, por isso podes continuar à mão sempre que quiseres.

Limites

As alterações feitas a partir da tua IA nunca contam para as perguntas do editor, porque quem pensa é o teu assistente. Os limites habituais da conta continuam a aplicar-se: número de casas, 100 MB de armazenamento, gravações por dia e tamanho da casa.

Privacidade

Só casas. O teu assistente vê as tuas casas e nada pessoal: nem email, nem nome, nem dados de início de sessão.
O teu assistente só chega às tuas próprias casas, e só depois de iniciares sessão na Estanza e o autorizares.
Nunca vê a tua palavra-passe nem a tua sessão da Estanza.
Publicar uma casa precisa de uma autorização própria.
Desliga qualquer app na app da Estanza, em Definições, Apps ligadas. Terminar sessão em todo o lado ou eliminar a conta desliga-as todas.
Consulta a política de privacidade para o resto.

Claude é uma marca da Anthropic. ChatGPT é uma marca da OpenAI. Le Chat é uma marca da Mistral AI. Cursor é uma marca da Anysphere. As marcas aparecem apenas para indicar que a Estanza funciona com elas; a Estanza não é afiliada a nenhuma delas nem aprovada por elas.