Connect
Connect Claude, Cursor, Codex, or another MCP client to Reforma.
Connect Reforma to your MCP client using this server:
https://api.reforma.ai/mcpWhen your client asks you to authenticate, sign in with your Reforma account and approve access.
No API key is required.
Cursor
Or add Reforma manually to ~/.cursor/mcp.json:
{
"mcpServers": {
"reforma": {
"url": "https://api.reforma.ai/mcp"
}
}
}Restart Cursor if needed, then complete the Reforma sign-in when prompted.
Claude Code
Run:
claude mcp add --transport http reforma https://api.reforma.ai/mcpStart a Claude Code session and run:
/mcpThen complete the Reforma sign-in in your browser.
Claude
Custom connectors work in Claude, Claude Desktop, and Cowork.
Free / Pro / Max
Open Claude connectors, add a custom connector, and use:
https://api.reforma.ai/mcpComplete the Reforma sign-in when prompted.
Team / Enterprise
An owner adds the connector in Organization settings → Connectors (custom / web) with the same URL.
Members then open Claude connectors, find Reforma, and select Connect.
Codex
Run:
codex mcp add reforma --url https://api.reforma.ai/mcpThen authenticate with Reforma when Codex prompts you.
Other clients
If your client is not listed above, add Reforma as a remote MCP server. Config shape varies by client; this is a common form:
{
"mcpServers": {
"reforma": {
"url": "https://api.reforma.ai/mcp"
}
}
}Put that config where your client stores MCP servers, then sign in to Reforma when prompted.
Check the connection
Once connected, ask your agent to list your Reforma projects.
A typical session starts by opening a project before working with its files, terminal, preview, or publishing tools.
How the agent should open a project and which tools to call: Project lifecycle.
Project sessions
Reforma's editor and MCP use the same project sandbox, so changes made by your agent appear in the same environment you see in Reforma.
Inactive sandboxes shut down after one hour. If that happens, ask the agent to open the project again and continue where you left off.
Troubleshooting
| What you see | What to do |
|---|---|
Reforma shows as disconnected or returns 401 | Authenticate again with your Reforma account. |
| MCP says the workspace is on Free, or includes a billing URL | Open that workspace's Billing page (https://app.reforma.ai/workspace/{id}/billing), upgrade to Pro, then open the project again. |
| MCP says you do not have edit access | You can list the workspace, but you cannot open or change it. Ask an owner for edit access. |
| File, terminal, preview, or publish tools fail immediately | Open a project first. |
| The project stopped responding after being idle | Open the project again. |
| You want to revoke a client | Open Profile → Security and login → Connected apps in Reforma. |