Connect

Connect Reforma to your AI client using this MCP 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

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.

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.

Open Claude connectors, add a custom connector, and use:

https://api.reforma.ai/mcp

In Claude Desktop, open Settings → Connectors, add a custom connector, and use the same URL.

Complete the Reforma sign-in when prompted.

Run:

codex mcp add reforma --url https://api.reforma.ai/mcp

Then authenticate with Reforma when Codex prompts you.

If your client is not listed above, add Reforma as a remote MCP server:

{
  "mcpServers": {
    "reforma": {
      "url": "https://api.reforma.ai/mcp"
    }
  }
}

Put that config where your client stores MCP servers, then sign in to Reforma when prompted.

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.

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.

What you see	What to do
Reforma shows as disconnected or returns `401`	Authenticate again with your Reforma account.
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.

For protocol details, tool names, arguments, and resources, see Reference.

New to MCP? Start with the Overview.