Skip to content

Commit 602dbfc

Browse files
committed
update readme to reflect Windows claude desktop config
1 parent 02677c8 commit 602dbfc

File tree

1 file changed

+54
-16
lines changed

1 file changed

+54
-16
lines changed

README.md

Lines changed: 54 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -411,23 +411,60 @@ In this example, we show how to use the bearer token using the Openbridge API ke
411411
"Accept: application/json, text/event-stream"
412412
],
413413
"env": {
414-
"MCP_TIMEOUT":"300",
415-
"HOSTNAME":"your_hostname",
416-
"PORT":"your_server_port",
417-
"MCP_TIMEOUT":"120000",
418-
"MCP_REQUEST_TIMEOUT":"60000",
419-
"MCP_CONNECTION_TIMEOUT":"10000",
420-
"MCP_SERVER_REQUEST_TIMEOUT":"60000",
421-
"MCP_TOOL_TIMEOUT":"120000",
422-
"MCP_REQUEST_WARNING_THRESHOLD":"10000",
423-
"OPENBRIDGE_REFRESH_TOKEN":"your_openbridge_token_here"
414+
"MCP_TIMEOUT": "300",
415+
"HOSTNAME": "your_hostname",
416+
"PORT": "your_server_port",
417+
"MCP_TIMEOUT": "120000",
418+
"MCP_REQUEST_TIMEOUT": "60000",
419+
"MCP_CONNECTION_TIMEOUT": "10000",
420+
"MCP_SERVER_REQUEST_TIMEOUT": "60000",
421+
"MCP_TOOL_TIMEOUT": "120000",
422+
"MCP_REQUEST_WARNING_THRESHOLD": "10000",
423+
"OPENBRIDGE_REFRESH_TOKEN": "your_openbridge_token_here"
424424
}
425425
}
426426
}
427427
}
428428
```
429429
**Note**: Replace `hostname`, `port` and `your_openbridge_token_here` with your actual OpenBridge token.
430430

431+
**IMPORTANT**: Cursor and Claude Desktop (Windows) have a bug where spaces inside args aren't escaped when it invokes npx, which ends up mangling these values. You can work around it using: [mcp-remote custom headers documentation](https://github.com/geelen/mcp-remote?tab=readme-ov-file#custom-headers).
432+
433+
The config would look something like this:
434+
435+
436+
```json
437+
{
438+
"mcpServers": {
439+
"amazon_ads_mcp": {
440+
"command": "npx",
441+
"args": [
442+
"-y",
443+
"--allow-http",
444+
"mcp-remote",
445+
"http://${HOSTNAME}:${PORT}/mcp/",
446+
"--header",
447+
"Authorization:${AUTH_HEADER}"
448+
"--header",
449+
"Accept: application/json, text/event-stream"
450+
],
451+
"env": {
452+
"MCP_TIMEOUT": "300",
453+
"HOSTNAME": "your_hostname",
454+
"PORT": "your_server_port",
455+
"MCP_TIMEOUT": "120000",
456+
"MCP_REQUEST_TIMEOUT": "60000",
457+
"MCP_CONNECTION_TIMEOUT": "10000",
458+
"MCP_SERVER_REQUEST_TIMEOUT": "60000",
459+
"MCP_TOOL_TIMEOUT": "120000",
460+
"MCP_REQUEST_WARNING_THRESHOLD": "10000",
461+
"AUTH_HEADER": "Bearer <your_openbridge_token_here>"
462+
}
463+
}
464+
}
465+
}
466+
```
467+
431468
Here is another example, which can be used if you are using OAuth since the `OPENBRIDGE_REFRESH_TOKEN` is not needed:
432469

433470
```json
@@ -441,12 +478,12 @@ Here is another example, which can be used if you are using OAuth since the `OPE
441478
"http://localhost:9080/mcp"
442479
],
443480
"env": {
444-
"MCP_TIMEOUT":"120000",
445-
"MCP_REQUEST_TIMEOUT":"60000",
446-
"MCP_CONNECTION_TIMEOUT":"10000",
447-
"MCP_SERVER_REQUEST_TIMEOUT":"60000",
448-
"MCP_TOOL_TIMEOUT":"120000",
449-
"MCP_REQUEST_WARNING_THRESHOLD":"10000"
481+
"MCP_TIMEOUT""120000",
482+
"MCP_REQUEST_TIMEOUT": "60000",
483+
"MCP_CONNECTION_TIMEOUT": "10000",
484+
"MCP_SERVER_REQUEST_TIMEOUT": "60000",
485+
"MCP_TOOL_TIMEOUT": "120000",
486+
"MCP_REQUEST_WARNING_THRESHOLD": "10000"
450487
}
451488
}
452489
}
@@ -487,6 +524,7 @@ If you're encountering unexpected length issues, review which tools are active.
487524

488525
**Claude not recognizing the server?**
489526
- Restart Claude Desktop after configuration changes
527+
- "Reload Page" in Claude Desktop if the MCP is not active
490528
- Check the JSON syntax is valid
491529
- Ensure the server name matches exactly
492530

0 commit comments

Comments
 (0)