@ompo-design/mcp-server

MCP server for applying Ompo visual edits to your codebase.

Important: this is not a web connector

Settings → Connectors → Add custom connector only works for remote URLs (hosted servers).

Ompo is a local MCP server. Install it via the steps below — not through the Connectors URL dialog.

Claude Desktop — install for ALL projects (recommended)

Prerequisites: Node.js installed.

1. Run one command in Terminal

npx @ompo-design/mcp-server setup-global

This adds Ompo to:

• Claude Desktop (claude_desktop_config.json)
• Claude Code user config (~/.claude.json)

Works across every project, not just one folder.

2. Quit and reopen Claude Desktop

Fully quit with Cmd+Q, then reopen.

3. Verify

Open any Code project, then type:

/mcp

ompo should show 4 tools. Approve it if prompted.

Manual install (Claude Desktop)

1. Open Claude Desktop → Settings → Developer → Edit Config
2. Add inside mcpServers:

"ompo": {
  "command": "/usr/local/bin/npx",
  "args": ["-y", "@ompo-design/mcp-server"],
  "env": {}
}

3. Save, quit Claude Desktop (Cmd+Q), reopen.

Use the full path to npx — the Desktop app often cannot find npx on its own.

Per-project install (optional)

From a project folder:

npx @ompo-design/mcp-server setup

Creates .mcp.json in that project only.

Check install

npx @ompo-design/mcp-server doctor

Using Ompo

1. Edit your site in Ompo
2. Click Send (creates .ompo/edits/ in your project)
3. Open that same project in Claude Code
4. Paste the Send prompt — Claude calls get_edit and apply_edit

Cursor

.cursor/mcp.json:

{
  "mcpServers": {
    "ompo": {
      "command": "npx",
      "args": ["-y", "@ompo-design/mcp-server"]
    }
  }
}