Claude Desktop
- Open Claude Desktop's Settings → Developer → Edit Config. That opens
claude_desktop_config.json(on a Mac in~/Library/Application Support/Claude, on Windows in%APPDATA%\Claude). - Add Stori3D under
mcpServers. If the file already lists servers, add the"stori3d"entry next to them.
{
"mcpServers": {
"stori3d": {
"command": "npx",
"args": ["-y", "stori3d-mcp@latest"]
}
}
}
- Save the file, then quit Claude Desktop completely and open it again. Stori3D's tools show up in a new chat.
Claude Code
Run this once in a terminal. --scope user makes Stori3D available in every folder you work in.
claude mcp add --scope user stori3d -- npx -y stori3d-mcp@latest
Then start a new Claude Code session. Type /mcp in it to check that stori3d is connected.
Cursor
The button opens Cursor and asks you to install the server. To add it by hand instead, add this to ~/.cursor/mcp.json (create the file if it isn't there):
{
"mcpServers": {
"stori3d": {
"command": "npx",
"args": ["-y", "stori3d-mcp@latest"]
}
}
}
Then ask in a chat in Agent mode.
VS Code (GitHub Copilot)
The button opens VS Code and asks you to install the server. Or run this in a terminal:
code --add-mcp '{"name":"stori3d","command":"npx","args":["-y","stori3d-mcp@latest"]}'
Then use Copilot Chat in Agent mode. It needs VS Code 1.102 or newer.
Windsurf
- In Cascade's MCP menu, choose Open MCP config file. That opens Windsurf's
mcp_config.json(where it is depends on your version of Windsurf). - Add Stori3D under
mcpServers, save, and refresh the servers in the MCP menu.
{
"mcpServers": {
"stori3d": {
"command": "npx",
"args": ["-y", "stori3d-mcp@latest"]
}
}
}
Other tools
OpenAI Codex: run this once in a terminal,
codex mcp add stori3d -- npx -y stori3d-mcp@latest
or add this to ~/.codex/config.toml.
[mcp_servers.stori3d]
command = "npx"
args = ["-y", "stori3d-mcp@latest"]
Gemini CLI: run this once in a terminal (--scope user makes it work in every folder), or add the same mcpServers entry as Claude Desktop to ~/.gemini/settings.json.
gemini mcp add --scope user stori3d npx -- -y stori3d-mcp@latest
Google Antigravity takes the same mcpServers entry: Agent panel → MCP Servers → Manage → View raw config.
Any other MCP client that runs servers on your computer: the command is npx with the arguments -y stori3d-mcp@latest. Assistants that only run in a web page, such as ChatGPT in the browser, can't reach a server on your computer yet.
@latest checks for a new version each time your AI tool starts, so restart it to pick up an update.
Connecting to your project
- Open your project in Stori3D in Chrome, Edge or Firefox, on the same computer as your AI tool.
- Open AI agent in the side rail and press Connect, and start your AI tool if it isn't running. Once Stori3D finds it, it shows a 6-digit code.
- Paste what Stori3D shows into your agent: “Connect to Stori3D with code 123456”. The app bar shows AI connected, and the panel lists everything the agent does.
To skip the code next time, turn on Remember … on this computer before you paste it. Then pressing Connect is enough, and while the page stays open your AI tool reconnects by itself when its session restarts. Forget remembered AI tools in the panel undoes it.
If Stori3D can't find your AI tool after half a minute, the panel says what to check: that the tool is running (quit it completely and reopen it after setting it up), that it lists stori3d among its MCP servers, and that Node.js is installed if your tool needs it.
If your browser asks whether Stori3D may access apps and services on this device, allow it: that's the connection to the server on your computer.
Things to ask
- Plan a route from the front door to the garden and make it a tour.
- Share the walkthrough with my client as a scroll story.
- Save the four views my client should see first.
- Set a clear sky and the sun at 4 pm in June.
- Lay out a ground floor with a living room, kitchen and WC, about 60 m².
- Add a window on the east wall of the study, and furnish the bedroom.
- Check the door widths and stairs against the usual rules.
- Give me a door and window schedule with marks.
- Show me the shadows at 9 am on the winter solstice.
- Put a hip roof on the house and an L-shaped stair with winders up to the first floor.
- Make the study 1 m wider, and curve the living room's south wall out into a bay.
- Trace the floor plan I brought in and turn it into walls.
- Find the clashes with the structural model and mark each one on my view.
- Lay out sheet A-101 with the ground floor plan and the south elevation, and issue it as revision A.
- Export the model as IFC for the structural engineer, and the drawings as a PDF.
- Render the living room view at 4K, realistic.
- Summarise my client's comments on the review link, and answer the ones about the kitchen.
- List the fire ratings of the walls in the Revit model I imported.
- Check the services model against the building for clashes, and list the worst.
- Make the site's terrain from these contours, and class the balustrades as IfcRailing.
The agent looks at the model, in 3D and on the plan, to check its own work.