Reforma

Connect

Connect Claude, Cursor, Codex, or another MCP client to Reforma.

Connect Reforma to your MCP client using this server:

https://api.reforma.ai/mcp

When your client asks you to authenticate, sign in with your Reforma account and approve access.

No API key is required.

Cursor

Install Reforma in 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/mcp

Start a Claude Code session and run:

/mcp

Then 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/mcp

Complete 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/mcp

Then 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 seeWhat to do
Reforma shows as disconnected or returns 401Authenticate again with your Reforma account.
MCP says the workspace is on Free, or includes a billing URLOpen 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 accessYou can list the workspace, but you cannot open or change it. Ask an owner for edit access.
File, terminal, preview, or publish tools fail immediatelyOpen a project first.
The project stopped responding after being idleOpen the project again.
You want to revoke a clientOpen Profile → Security and login → Connected apps in Reforma.