Connect your agent

MCP (Model Context Protocol) is the protocol an AI agent uses to connect to an application and work with its content. While Ream is running, it serves a local MCP server at http://127.0.0.1:41100/mcp. An agent connected to this server sees the file open in Ream and can read and edit it.

Before you start

1. Install Ream — download.
2. Launch the app and open a file. The MCP server runs while a file is open in Ream.

Claude Code

Add the Ream marketplace:

/plugin marketplace add ream-design/agent-plugins

Install the plugin:

/plugin install ream-desktop@ream

If the Ream tools don't show up, restart Claude Code.

Cursor

The Ream plugin isn't in the Cursor Marketplace yet, so add the server through settings. Open Cursor Settings → MCP → Add new MCP server, or add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "ream": {
      "url": "http://127.0.0.1:41100/mcp"
    }
  }
}

Codex

Add the Ream marketplace:

codex plugin marketplace add ream-design/agent-plugins

Install the plugin:

codex plugin install ream-desktop@ream

Other agents

Ream works with any agent that supports MCP over HTTP. Point it at the server address:

http://127.0.0.1:41100/mcp

Check it works

Ask your agent to do something in Ream, for example:

Create a frame with a red rectangle in Ream.

If the connection works, the agent will call the Ream tools, and you'll see it working on the canvas in the app.

If it doesn't work

• Connection refused — Ream isn't running, or no file is open.
• No tools after install — restart your agent session.
• The agent says it's out of calls — the free-plan limit is reached; the tool response says when calls become available again.