Connecting Claude Desktop to Xurrent MCP

The Xurrent MCP server is a remote server hosted by Xurrent. You connect to it from Claude Desktop using the mcp-remote bridge package, which proxies your local Claude Desktop client to the hosted endpoint.

Prerequisites

• Claude Desktop installed. Download from claude.com/download or your company's app catalog.
• Node.js 20.18.1 or higher (Node 22 LTS recommended). Check with node -v in a terminal. If you're below this version, see Troubleshooting before continuing.
• A Xurrent Personal Access Token (PAT) from a support domain account, with Sera AI enabled on that account. See Authentication and PAT Setup.

Configuration

Open your Claude Desktop config file:

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

Add the xurrent-mcp block to your mcpServers object.

For production (.com):

{
 "mcpServers": {
   "xurrent-mcp": {
     "command": "npx",
     "args": [
       "-y",
       "mcp-remote",
       "https://mcp.xurrent.com/mcp",
       "--header",
       "Authorization: Bearer YOUR_PAT_HERE"
     ]
   }
 }
}

For Demo:

{
 "mcpServers": {
   "xurrent-mcp": {
     "command": "npx",
     "args": [
       "-y",
       "mcp-remote",
       "https://mcp.xurrent-demo.com/mcp",
       "--header",
       "Authorization: Bearer YOUR_PAT_HERE"
     ]
   }
 }
}

For QA (.qa):

{
 "mcpServers": {
   "xurrent-mcp-qa": {
     "command": "npx",
     "args": [
       "-y",
       "mcp-remote",
       "https://mcp.xurrent.qa/mcp",
       "--header",
       "Authorization: Bearer YOUR_PAT_HERE"
     ]
   }
 }
}

Note on the npx path. Claude Desktop does not inherit your terminal's PATH. If you installed Node via nvm or Homebrew, a bare npx command will fail to launch with the error "No such file or directory."

Find the absolute path to npx by running this in a terminal (use where npx on Windows):

which npx

Then use the full path it returns as the command value. On macOS it looks like this:

"command": "/Users/<you>/.nvm/versions/node/v22.22.3/bin/npx"

On Windows, double the backslashes so the JSON stays valid:

"command": "C:\\Program Files\\nodejs\\npx.cmd"

You can run multiple connections side by side. Just use different keys (xurrent-mcp and xurrent-mcp-qa).

Fully quit Claude Desktop (Cmd+Q on macOS, not just close the window) and relaunch.

Verifying the connection

After relaunching, click the tools icon in Claude Desktop's chat input. You should see the Xurrent tools listed. Seeing the tools confirms the bridge connected to the server. It does not confirm that your token is authorized. To confirm that, run a real query, for example: "What are my open requests in Xurrent?" If you get data back, you are connected.

If the tools appear but a query returns a 403 error, the problem is not your Claude Desktop config. It is the token or the account. Check that the PAT belongs to a support domain account and that Sera AI is enabled on that account. See Authentication and PAT Setup and Troubleshooting.

A few things to know

• There is no @xurrent/mcp-server npm package. The Xurrent MCP server is remote, not a local package. Use mcp-remote as shown above.
• Authentication is via Bearer token in the Authorization header. XURRENT_API_TOKEN and XURRENT_ACCOUNT environment variables won't work.

If something isn't working, see the Troubleshooting guide.

‍