Connect MCP

Use Lunagraph’s MCP to design on the canvas from the coding agent you already use in your terminal or editor.

The MCP server runs inside the Lunagraph desktop app. Keep the app open while your agent uses it.

Video walkthrough

This clip is from Part 3 of the getting started tutorial, starting at 14:40.

Set up the MCP

In Lunagraph, click MCP in the top bar to open Connect MCP. The dialog shows your local server URL and whether the server is ready. You can copy the setup for your agent from there, or use the steps below.

Claude Code
Codex
Cursor
Other

Add Lunagraph MCP to Claude Code

Run this command in your terminal to register the Lunagraph MCP server:

claude mcp add --scope user --transport http lunagraph http://127.0.0.1:21209/mcp

Verify connection

Run this command and confirm Lunagraph appears as connected:

claude mcp list

Add Lunagraph MCP to Codex

Run this command in your terminal to register the Lunagraph MCP server:

codex mcp add lunagraph --url http://127.0.0.1:21209/mcp

To configure it manually instead, add this to your Codex config.toml:

[mcp_servers.lunagraph]
url = "http://127.0.0.1:21209/mcp"
enabled = true

Verify connection

Run this command and confirm the Lunagraph server appears:

codex mcp list

Add Lunagraph MCP to Cursor

Paste this configuration into Settings > MCP, or into ~/.cursor/mcp.json:

{
  "mcpServers": {
    "lunagraph": {
      "url": "http://127.0.0.1:21209/mcp"
    }
  }
}

Verify connection

Open Cursor Settings > MCP and confirm the Lunagraph server shows as connected.

Add Lunagraph MCP to your client

If your client isn’t listed, set up Lunagraph manually. The server URL is http://127.0.0.1:21209/mcp.

{
  "mcpServers": {
    "lunagraph": {
      "serverUrl": "http://127.0.0.1:21209/mcp"
    }
  }
}

If your client doesn’t support remote URLs, use the mcp-remote bridge. It needs Node.js.

{
  "mcpServers": {
    "lunagraph": {
      "command": "npx",
      "args": ["mcp-remote", "http://127.0.0.1:21209/mcp"]
    }
  }
}

Verify connection

Confirm the Lunagraph MCP server shows as connected in your client’s settings.

Point the agent at your selection

Tell your agent exactly which element you mean by giving it a link to your selection.

Open your agent in the terminal

Start Claude Code or another connected agent while Lunagraph is open.

Copy a link to your selection

Select an element on the canvas and press Shift + Cmd + L to copy a link to it.

Paste the link into your prompt

Paste the link into your message along with what you want to change. The agent uses the MCP to find that element on the canvas.

Getting started

Guides

On this page

Video walkthrough

Set up the MCP

Point the agent at your selection

​On this page

​Video walkthrough

​Set up the MCP

​Point the agent at your selection

On this page

Video walkthrough

Set up the MCP

Point the agent at your selection