Używaj Estanzy w swojej AI

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

Co to jest

MCP, czyli Model Context Protocol, to otwarty standard, dzięki któremu asystent AI może korzystać z innej usługi w Twoim imieniu, tak jak aplikacja w telefonie korzysta z aparatu, gdy jej na to pozwolisz.

Serwer MCP Estanzy pozwala Twojemu asystentowi czytać Twoje domy i zmieniać je tymi samymi narzędziami, których używa edytor Estanzy. Logujesz się do Estanzy, nie do asystenta, i w każdej chwili możesz cofnąć dostęp.

Jak połączyć

Każda aplikacja używa tego samego adresu. Znajdź swoją poniżej, a potem zaloguj się do Estanzy i zezwól na dostęp, gdy pojawi się pytanie.

https://api.estanza.casa/mcp

Claude: otwórz Customize, a potem Connectors. Wybierz Add custom connector, wklej adres i zaloguj się.
ChatGPT: włącz Developer mode w Settings, Security and login. Potem otwórz Plugins, naciśnij + i wklej adres.
Le Chat: otwórz Connectors. Wybierz Add Connector, potem Custom MCP Connector, wklej adres i zaloguj się.
Cursor: Dodaj do Cursora jednym kliknięciem, a potem zaloguj się, gdy Cursor poprosi.
Claude Code: uruchom to polecenie, a potem /mcp, żeby się zalogować.
```
claude mcp add --transport http estanza https://api.estanza.casa/mcp
```
Codex: uruchom to polecenie, a potem codex mcp login estanza, żeby się zalogować.
```
codex mcp add estanza --url https://api.estanza.casa/mcp
```
Każda inna aplikacja lub agent: dodaj własny konektor lub serwer MCP z adresem podanym wyżej. Agent, który sam edytuje swoją konfigurację MCP, potrzebuje tego:
```
{"mcpServers":{"estanza":{"url":"https://api.estanza.casa/mcp"}}}
```

Aplikacje czatu nie dodadzą konektora z wiadomości, więc wklej adres w ich ustawieniach, tak jak pokazano wyżej. Potem włącz Estanzę w czacie i poproś.

Co może Twoja AI

Powiedz, czego chcesz, na przykład "zrób z drugiej sypialni gabinet i postaw biurko pod oknem". Twój asystent może:

Założyć dom, pusty albo z jednego z szablonów Estanzy.
Odrysować obraz planu, który mu dasz: narysuje ściany i zapyta Cię o jedną prawdziwą długość, żeby ustawić skalę.
Zmieniać go: pokoje, piętra, ściany, drzwi, okna, schody, meble, światła, kable, ogród i notatki. Każda zmiana to nowa wersja, więc możesz ją cofnąć w edytorze.
Pokazać go: obraz planu narysowany przez Estanzę i link do widoku 3D.
Opublikować go i dać Ci link do udostępniania oraz link do karty Home Assistant, z instrukcją, jak dodać kartę do pulpitu.
Dodać Twój własny model 3D mebla i go ustawić.

Każda zmiana pojawia się też w edytorze Estanzy, więc w każdej chwili możesz kontynuować ręcznie.

Limity

Zmiany wprowadzane przez Twoją AI nigdy nie liczą się do pytań w edytorze, bo myśli za nie Twój asystent. Obowiązują zwykłe limity konta: liczba domów, 100 MB miejsca, zapisy dziennie i wielkość domu.

Prywatność

Tylko domy. Twój asystent widzi Twoje domy i nic osobistego: żadnego e-maila, imienia ani danych logowania.
Twój asystent ma dostęp tylko do Twoich własnych domów i dopiero wtedy, gdy zalogujesz się do Estanzy i na to pozwolisz.
Nigdy nie widzi Twojego hasła ani Twojej sesji w Estanzie.
Publikowanie domu wymaga osobnej zgody.
Odłącz dowolną aplikację w aplikacji Estanza, w Ustawieniach, Połączone aplikacje. Wylogowanie się wszędzie albo usunięcie konta odłącza je wszystkie.
Resztę znajdziesz w polityce prywatności.

Claude jest znakiem towarowym Anthropic. ChatGPT jest znakiem towarowym OpenAI. Le Chat jest znakiem towarowym Mistral AI. Cursor jest znakiem towarowym Anysphere. Ich znaki pokazujemy tylko po to, żeby powiedzieć, że Estanza z nimi działa; Estanza nie jest z nimi powiązana ani przez nie wspierana.