Skip to content

MCP client setup

Connect your AI app to Patcherly so it can read your workspace (errors, sites, usage, and more). You sign in with your normal Patcherly account in the browser — no API keys to copy and paste.

Before you start

  • A workspace admin must enable MCP under Profile → MCP.
  • Open the dashboard and switch to the workspace you want the AI to use before you sign in.
  • If you are not already signed in to Patcherly, the browser consent step opens the login form first, then returns you to the same authorize page (your OAuth request is not lost).

What MCP can do, admin settings, and troubleshooting: Connect your AI assistant.

Server URL (every client uses this): https://mcp.patcherly.com/mcp

Cursor

One click — then sign in when Cursor asks:

Install Patcherly MCP in Cursor

Open Customize → MCPs, choose Authenticate (or Connect / Login) for patcherly, complete the browser consent, and confirm tools such as list_errors appear. Prefer Authenticate over Logout if a previous attempt interrupted.

Optional — add to your project .cursor/mcp.json instead of the button above:

{
  "mcpServers": {
    "patcherly": {
      "url": "https://mcp.patcherly.com/mcp"
    }
  }
}

Cursor registers via Patcherly’s OAuth Dynamic Client Registration (same public patcherly-mcp client). No auth.CLIENT_ID is required in mcp.json.

You can also install the Patcherly Cursor plugin (same server, plus skills for triaging errors and exports) from the Cursor marketplace or the public cursor/ folder on patcherly-mcp-plugins.

Claude Code (terminal)

claude mcp add --transport http patcherly https://mcp.patcherly.com/mcp
claude mcp login patcherly

Complete sign-in in the browser. In Claude Code, run /mcp to confirm patcherly is connected. Optional full plugin (skills included): claude/ on patcherly-mcp-plugins.

Codex CLI (terminal)

codex mcp add patcherly --url https://mcp.patcherly.com/mcp
codex mcp login patcherly

Start a new session and run /mcp to verify the connection. Optional full plugin: codex/ on patcherly-mcp-plugins.

VS Code

  1. Open the Command Palette (Ctrl+Shift+P on Windows/Linux, Cmd+Shift+P on Mac).
  2. Run MCP: Add Server → HTTP / remote.
  3. Enter https://mcp.patcherly.com/mcp and finish sign-in in the browser.

Or add this to your user or workspace mcp.json (VS Code Copilot):

{
  "servers": {
    "patcherly": {
      "type": "http",
      "url": "https://mcp.patcherly.com/mcp"
    }
  }
}

Reload the window if tools do not appear immediately. No API key or client id is required — sign in with OAuth when prompted.

Claude Desktop

Patcherly is a remote MCP server (no local MCP binary). Prefer adding a custom connector / remote MCP URL in Claude Desktop or Claude.ai:

  1. Add connector URL https://mcp.patcherly.com/mcp.
  2. Complete OAuth sign-in in the browser when prompted.

If your Claude build still uses a local MCP config file, the same URL-only entry works:

{
  "mcpServers": {
    "patcherly": {
      "url": "https://mcp.patcherly.com/mcp"
    }
  }
}

Restart Claude if tools do not appear, then sign in when prompted.

Other MCP apps

Use URL https://mcp.patcherly.com/mcp in any client that supports remote HTTP MCP with OAuth. Apps that only support local plugins cannot connect to Patcherly’s hosted server directly.

After connecting

  • Review active sessions under Profile → MCP (AI assistant connections) and revoke any you no longer need (each row is one assistant connection).
  • Problems? See Troubleshooting on the main integration guide.