Skip to content
English
Go to merchantspring.io
  • There are no suggestions because the search field is empty.

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

You can connect the MerchantSpring MCP server to Claude Desktop to access MerchantSpring data and tools directly from Claude.  This allows Claude to retrieve information such as - Connected channels and stores, Sales and performance metrics, Traffic and conversion data, Custom reports and analysis.

How to Connect to the MCP Using OAuth

This is the easiest and most user-friendly way to connect to the MCP using Claude Desktop.

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 → Customize.  
     
     



     
  4. Add custom connector. Note: Free plans are limited to 1 custom connector. If you see it grayed out, remove any existing custom connectors you have.


     

     5. Add in the MCP server information

    1. Name: (any name)
    2. Remove MCP Server URL: https://mcp.merchantspring.io
    3. Advanced Settings: Leave it empty

                 

 
       6. Click on Connect.
      7. You will get redirected to the browser to login using Developer Portal credentials. 
 

 

      8. Once login succeed, it will redirect back to Claude Desktop, showing the list of available tools.

      9. You should see the Connector listed as part of the tools in the main chat box.

 

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.

mcp available

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.