Advanced

Testing Merge Agent Handler Locally

How to setup MCP JSON Configs in different providers.

MCP JSON config

Load Merge Agent Handler locally in different providers like Claude Desktop, Windsurf, and Cursor by setting up the MCP JSON configuration file. The config contains the Merge Agent Handler MCP url, and the bearer token.

What you need from Merge Agent Handler:

  • Tool Pack ID
  • Registered User ID
  • Production and Test Access Key
1{
2  "mcpServers": {
3    "agent-handler": {
4      "command": "npx",
5      "args": [
6        "-y",
7        "mcp-remote@latest",
8        "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9        "--header",
10        "Authorization: Bearer ${AUTH_TOKEN}"
11      ],
12      "env": {
13        "AUTH_TOKEN": "<ah-production-access-key>"
14      }
15    }
16  }
17}

Implementations in different providers

Claude Desktop

Steps:

  1. Open Claude Desktop Settings in the system’s menu bar
  2. Navigate to Developer settings
  3. Click “edit config”. You’ll need to open this file in a text editor or IDE.
  4. Paste the Merge Agent Handler MCP JSON config into the file. Remember to replace the Tool Pack ID, Registered User ID, and Access Key with information from the Merge Agent Handler dashboard.
  5. Click save, and then restart Claude Desktop. You should now see Merge Agent Handler tools loaded up!

For more detailed instructions, you can follow the guide here.

Windsurf

Steps:

  1. Open Windsurf Settings in the system’s menu bar
  2. Navigate to Cascade, and click on “Manage MCPs”
  3. Click on “View raw config”. This will open to the file where you can paste the JSON config.
  4. Paste the Merge Agent Handler MCP JSON config into the file. Remember to replace the Tool Pack ID, Registered User ID, and Access Key with information from the Merge Agent Handler dashboard.
  5. Click save, and then click “Refresh” on the Manage MCPs page.

For more detailed instructions, you can follow the guide here.

You can also do this directly in Cascade, the Windsurf agent. Click on the Customization icon in the top of Cascade (boxes icon), and click on the below icon.

MCP JSON Config

Cursor

You can follow the guide here.