Estanza aus Ihrer KI nutzen

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

Was es ist

MCP, das Model Context Protocol, ist ein offener Standard, mit dem ein KI-Assistent einen anderen Dienst für Sie nutzen kann, so wie eine App auf Ihrem Handy die Kamera nutzt, sobald Sie es erlauben.

Mit dem MCP-Server von Estanza kann Ihr Assistent Ihre Häuser lesen und sie mit denselben Werkzeugen ändern, die der Estanza-Editor verwendet. Sie melden sich bei Estanza an, nicht beim Assistenten, und können den Zugriff jederzeit wieder entziehen.

So verbinden Sie es

Jede App nutzt dieselbe Adresse. Suchen Sie unten Ihre App, melden Sie sich dann bei Estanza an und erlauben Sie den Zugriff, wenn Sie gefragt werden.

https://api.estanza.casa/mcp

Claude: Öffnen Sie Customize und dann Connectors. Wählen Sie Add custom connector, fügen Sie die Adresse ein und melden Sie sich an.
ChatGPT: Schalten Sie unter Settings, Security and login den Developer mode ein. Öffnen Sie dann Plugins, tippen Sie auf + und fügen Sie die Adresse ein.
Le Chat: Öffnen Sie Connectors. Wählen Sie Add Connector, dann Custom MCP Connector, fügen Sie die Adresse ein und melden Sie sich an.
Cursor: Zu Cursor hinzufügen mit einem Klick, dann melden Sie sich an, wenn Cursor fragt.
Claude Code: Führen Sie diesen Befehl aus, dann /mcp, um sich anzumelden.
```
claude mcp add --transport http estanza https://api.estanza.casa/mcp
```
Codex: Führen Sie diesen Befehl aus, dann codex mcp login estanza, um sich anzumelden.
```
codex mcp add estanza --url https://api.estanza.casa/mcp
```
Andere Apps und Agenten: Fügen Sie mit der Adresse oben einen eigenen MCP-Connector oder -Server hinzu. Ein Agent, der seine MCP-Konfiguration selbst bearbeitet, braucht:
```
{"mcpServers":{"estanza":{"url":"https://api.estanza.casa/mcp"}}}
```

Chat-Apps können keinen Connector aus einer Nachricht hinzufügen. Fügen Sie die Adresse deshalb wie oben gezeigt in den Einstellungen ein. Schalten Sie Estanza dann in einem Chat ein und legen Sie los.

Was Ihre KI kann

Sagen Sie, was Sie möchten, zum Beispiel "mach aus dem zweiten Schlafzimmer ein Büro und stell den Schreibtisch unters Fenster". Ihr Assistent kann:

Ein Zuhause anlegen, leer oder aus einer der Estanza-Vorlagen.
Ein Grundrissbild nachzeichnen, das Sie ihm geben: Er zeichnet die Wände und fragt Sie nach einer echten Länge für den Maßstab.
Es ändern: Räume, Etagen, Wände, Türen, Fenster, Treppen, Möbel, Lampen, Kabel, Garten und Notizen. Jede Änderung ist eine neue Version, die Sie im Editor rückgängig machen können.
Es zeigen: ein von Estanza gezeichnetes Bild des Grundrisses und einen Link zur 3D-Ansicht.
Es veröffentlichen und Ihnen den Teilen-Link und den Link zur Home-Assistant-Karte geben, mit den Schritten, um die Karte auf Ihr Dashboard zu bringen.
Ihr eigenes 3D-Modell eines Möbelstücks hinzufügen und platzieren.

Jede Änderung erscheint auch im Estanza-Editor, sodass Sie jederzeit von Hand weitermachen können.

Limits

Änderungen aus Ihrer KI zählen nie gegen die Fragen im Editor, denn das Denken übernimmt Ihr Assistent. Die üblichen Kontolimits gelten weiter: Anzahl der Häuser, 100 MB Speicher, Speichervorgänge pro Tag und Größe des Hauses.

Datenschutz

Nur Häuser. Ihr Assistent sieht Ihre Häuser und nichts Persönliches: keine E-Mail, keinen Namen, keine Anmeldedaten.
Ihr Assistent erreicht nur Ihre eigenen Häuser, und erst nachdem Sie sich bei Estanza angemeldet und es erlaubt haben.
Er sieht nie Ihr Passwort oder Ihre Estanza-Sitzung.
Ein Zuhause zu veröffentlichen braucht eine eigene Erlaubnis.
Trennen Sie jede App in der Estanza-App unter Einstellungen, Verbundene Apps. Überall abmelden oder Ihr Konto löschen trennt alle auf einmal.
Alles Weitere steht in der Datenschutzerklärung.

Claude ist eine Marke von Anthropic. ChatGPT ist eine Marke von OpenAI. Le Chat ist eine Marke von Mistral AI. Cursor ist eine Marke von Anysphere. Die Marken werden nur gezeigt, um zu sagen, dass Estanza mit ihnen funktioniert; Estanza ist mit keinem dieser Unternehmen verbunden und wird von keinem unterstützt.