How to Connect MerchantSpring to Claude Desktop (MCP Setup Guide)

Prerequisites:

• Claude Desktop app
• Free tier account or above

How to set up:

1. Open the Claude Desktop app.
2. Go to Settings
   
   
   
   
3. Go to Connectors → In the Search box, type "MerchantSpring. 
   
   
   
    
4. Click Connect
   
   
   
   
5. You will get redirected to the browser to login using your Developer Portal credentials.
   
   
   
   
   
6. Once you've logged in successfully, it will redirect back to the Claude Desktop, showing the list of available tools.
   
   
   
   
   
7. You should see the Connector listed as part of the tools in the main chat box.
   
   
   

Method 2: Using OAuth

Step 1: Generate Your API Key

Create an API key from the MerchantSpring Developer Portal: https://developer.merchantspring.io/dashboard

You will need this key for the configuration file.

Step 2: Open Claude’s MCP Configuration

In Claude Desktop, navigate to: Settings → Developer → Edit Config

This opens the configuration file.

File locations

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Step 3: Add the MerchantSpring MCP Configuration

Add the following configuration to your file.

If no other MCP servers exist, you can replace the entire file.

{
  "globalShortcut": "",
  "mcpServers": {
    "merchantspring-remote": {
      "command": "npx",
      "args": [
        "-p", "node@22",
        "-p", "mcp-remote@latest",
        "--",
        "mcp-remote",
        "https://mcp.merchantspring.io/mcp",
        "--header", "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <user-api-key-goes-here>"
      }
    }
  }
}

Replace: <user-api-key-goes-here> with your MerchantSpring API key.

⚠ Important

• Do not include the < > brackets

• Keep the Bearer prefix
  
  Example: "AUTH_HEADER": "Bearer abc123xyz456"
  
  

Step 4: Restart Claude Desktop

After saving the file:

1. Close Claude Desktop

2. Reopen the application

You should now see an MCP indicator in the chat input area.

Click it to view available MCP tools.

Troubleshooting

If the MCP server does not appear:

1. Restart Claude Desktop

Most issues are resolved by restarting the app.

2. Check the configuration file

Ensure the JSON format is valid.

Incorrect syntax will prevent the MCP server from loading.

3. Check Claude logs

Mac: ~/Library/Logs/Claude
Windows: %APPDATA%\Claude\logs
Look for files beginning with: mcp*.log

Node / NPX Issues (Windows)

If you encounter Node-related errors:

Install npm globally: npm install -g npm
Also confirm this directory exists: %APPDATA%\npm

Security Notice

MCP servers can execute code locally on your machine.

Only install MCP servers from trusted sources and review documentation before enabling them.

Tip:

If you’re unsure which installation method to use, we recommend Method 1 (.mcpb install) for the fastest setup.