Connect Claude or ChatGPT#
Simcraft serves a remote MCP server at https://app.simcraft.io/mcp. Connect Claude or ChatGPT to it, and that tool can list, read, create, edit, and run your Simcraft cloud models as you.
Your email must be on the Simcraft access list before you can sign in. Simcraft is pre-alpha, version 0.1.0, and this connection can change before 1.0.0.
A connected tool reaches your cloud models, the models in the Cloud models list at app.simcraft.io. It does not reach a model you opened from a file. Ask the tool to create your first model, or save a model to Your models in the app.
This page covers claude.ai, Claude Desktop, Claude Code, and ChatGPT. Each connects the same way.
The tool registers itself with Simcraft, then opens Simcraft in your browser. You sign in with the 6-digit code Simcraft emails you, or the link in the same email. Your first sign-in creates your account. Simcraft then shows a consent page, and after you choose Allow the tool has access.
claude.ai and Claude Desktop#
Open Connectors in your Claude settings, add a custom connector, and give it this address:
https://app.simcraft.io/mcpThe route to Connectors depends on your Claude plan. Anthropic's guide to custom connectors gives the current one.
Claude Code#
Add the server:
claude mcp add --transport http simcraft https://app.simcraft.io/mcpThen run /mcp, choose simcraft, and finish the sign-in in the browser that opens. Until you do, claude mcp list reports the server as needing authentication.
ChatGPT#
In ChatGPT's connector settings, add a custom connector with the address https://app.simcraft.io/mcp and OAuth authentication. ChatGPT registers itself, so it needs no client id and no secret.
The access that Allow grants#
The consent page names the address that receives your authorization. For claude.ai and ChatGPT it is claude.ai or chatgpt.com. For Claude Code it is an address on your own computer, 127.0.0.1 or localhost, and the page warns you before you allow it. The page also names the tool and marks that name unverified, because any tool can choose any name. Simcraft never remembers a consent: each authorization shows the page again.
Allow grants the one scope models. The tool then acts as you:
- It lists, reads, creates, edits, and runs your cloud models. It also reads saved runs by their id.
- Its edits show in Edit history and in the open model as
<tool name> (MCP), and each edit is one step you can undo.
An access token lasts 1 hour. The tool refreshes it without asking you, for up to 30 days after you allowed it. After that, the tool sends you through the consent page again.
The access covers every cloud model in your account, not only the model you have open. Model text is data, so a tool that reads a model can follow an instruction someone wrote into the model. Check a tool's changes in Edit history, and undo a step you did not want.
What a connected tool cannot do#
- It cannot delete a model or a saved run.
- It cannot reach another person's models.
The tool does not receive your email address or a model's Edit history.
Links to models#
A tool that reads, edits, or runs a model returns a link to it, such as https://app.simcraft.io/models/5248dc3e-01a9-4e28-bcaf-9e0d578a2575. The link opens the model in Simcraft, after a sign-in when needed. Ask the tool for the link when it does not give you one.
Disconnect a tool#
In the app, open the main menu and choose Connected AI tools… to see every tool you have connected. The dialog names each tool, its address, and when you allowed it. Disconnect ends that tool's access at once.
Signing out of the app does not disconnect a tool. Removing your email from the access list disconnects every tool.
Read more#
- Your first model: build and run the M/M/1 queue in the browser, and see how an OSDL model is written.
- The reference implementation: the engine, the editor, and the other authoring surfaces.
- Terms and conditions: your responsibility for what a connected tool does.
- Privacy policy: the data Simcraft handles for an AI tool connection.