Connect Claude Code

The desktop app runs a small server on your PC that follows the Model Context Protocol (MCP). Other AI apps, such as Claude Code, Codex, Claude Desktop, Cursor and Cline, can connect to it and edit your open project with the same tools as the built-in chat.

This is separate from choosing a model inside the editor. Here, the other app is in charge and Evaloon Editor is the tool it uses.

Note

This is a desktop-app feature. The MCP tab only appears in Settings in the desktop app.

Connect Claude Code

1. Open the editor and a project. Open Settings and choose the MCP tab.

2. Check that Status says Running. The panel shows the local address and a token. They are only for tools on this PC.

3. Under Client Setup, choose Claude Code. The panel shows a claude mcp add ... command with the right paths already filled in. Copy it.

4. Paste the command into a terminal and run it. It adds a server named evaloon to Claude Code.

5. Back in Evaloon Editor, select Test connection. It should report that it can reach the server.

6. In Claude Code, ask it to look at your timeline. It can now read it and edit it.

You do not need Node.js. The command runs the helper that ships inside Evaloon Editor.

Teach Claude Code how to use Evaloon

Under Client Setup, Share Evaloon skill to Claude Code copies a built-in skill called evaloon-editor into your Claude Code skills folder. It tells Claude how to read the timeline, follow Evaloon’s own skills, and check its work by looking at frames.

Other apps

• Codex: choose Codex under Client Setup. It gives you either a codex mcp add command or a block to add to ~/.codex/config.toml.
• Anything else: choose JSON. Copy the mcpServers block into the app’s MCP settings. It looks like this, with the paths filled in by the panel:

{
  "mcpServers": {
    "evaloon": {
      "command": "<path to Evaloon Editor.exe>",
      "args": ["<path to the evaloon-mcp helper>"],
      "env": { "ELECTRON_RUN_AS_NODE": "1" }
    }
  }
}

Do not paste the address and token into Claude’s Connectors screen. Those connectors reach out from the internet, so they cannot see your PC.

Staying safe

• Local only. The server listens on your own PC and refuses any request without the token.
• Approvals. By default, edits that delete or cost something are refused over MCP with a “confirmation required” notice. In the Trusted Local section, the Auto-allow destructive actions switch lets trusted local apps run them. Leave it off unless you need it.
• Rotate token. If you think the token leaked, select Rotate token. Apps set up through Client Setup pick up the new token by themselves. Anything using the address and token directly needs the new token.

If it does not connect

• Status says Stopped: restart Evaloon Editor and open Settings > MCP again.
• Test connection fails: check the editor is still open. The server only exists while the app runs.
• The app cannot find the helper: run the Client Setup command again from the panel, since it contains the current paths.