Stori3D
Sign in Start free

Help centre · AI

AI agents

Connect Claude, Cursor, VS Code or another AI tool to your open project through MCP, and see and undo everything it changes.

You can work on a project by hand, or with your AI. Stori3D speaks MCP (the Model Context Protocol), so AI tools on your computer can look at the building you have open and change it with you. Every change shows in the app and can be undone.

Set up your AI tool

Your AI tool runs a small server, stori3d-mcp, on your own computer. It needs Node.js 18 or newer.

The AI agents page on our website has the steps for each tool: Claude Desktop, Claude Code, Cursor, VS Code with GitHub Copilot, Windsurf, OpenAI Codex, Gemini CLI and Google Antigravity. Cursor and VS Code have one-click install buttons. You can also open AI agent in the side rail and pick your tool under Set up your AI tool for the same instructions.

You set this up once. With the usual setup, your AI tool fetches the newest version each time it starts.

Connect to your project

  1. Open your project in Stori3D in Chrome, Edge or Firefox, on the same computer as your AI tool.
  2. Open AI agent in the side rail and press Connect. Stori3D shows a 6-digit code.
  3. Tell your agent "Connect to Stori3D with code 123456", using your code.

The app bar shows AI connected while an agent is connected. If your browser asks whether Stori3D may reach apps on this device, allow it: that's the connection to the server on your computer. Disconnect ends it. A code works for one pairing; press Connect again for a new one.

The agent works on whichever project is open in the tab you connected, in the cloud or only on this device.

What agents can do

Agents can:

  • read the project: levels, rooms, walls, doors, windows, furniture, schedules and the catalogue;
  • look at the model in 3D, on the plan and in elevations and sections, to check their own work;
  • move the camera, change level, cut sections and set the sun and sky;
  • draw rooms, walls, doors, windows, roofs, stairs, columns and furniture, and paint finishes;
  • save views, make tours, lay out sheets, set custom properties, and export files and images;
  • read and answer comments on a review link.

Things to try:

  • "Lay out a ground floor with a living room, kitchen and WC, about 60 m²."
  • "Furnish the bedroom, and add a window on the east wall of the study."
  • "Plan a route from the front door to the garden and make it a tour."
  • "Give me a door and window schedule."

See and undo every change

Each change an agent makes is one undo step named "AI: …", like any other edit. The AI agent panel lists everything the agent does under Activity, and has a button to undo the latest AI change. Ctrl+Z (⌘Z on a Mac) works too.

Some changes always ask you first, with Allow or Don't allow: deleting a level or more than 10 elements, sharing or taking down a link, and answering a client's comment.

Keep the agent to looking

Turn on Read only under Permissions. The agent can look at the model and move the view, but not change the model.

Privacy and safety

  • The server runs on your computer and only talks to Stori3D's pages.
  • The agent sees nothing until you press Connect and give it the code.
  • Agents can't run scripts in Stori3D or reach your account.
  • What the agent sees goes to the AI tool you chose, under its terms.

AI tools that only run in a web page, such as ChatGPT or claude.ai in the browser, can't reach the server on your computer. Safari and iPad aren't supported for connecting yet.

The in-app chat

A chat with Claude inside Stori3D is being tested and isn't on for everyone yet. If you're one of the testers, you'll see a Chat tab in the AI agent panel once you're signed in. Your AI tool is the other tab, for connecting your own AI tool as above.

See Plans and support for which plans include AI agents.

Still stuck? Contact us, or ask in the app: Help → Contact support.