Skip to content

Commit e91fed3

Browse files
committed
CM-64439 updated READ for MCP with certificates
1 parent da8a2ab commit e91fed3

1 file changed

Lines changed: 33 additions & 0 deletions

File tree

README.md

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -559,6 +559,37 @@ cycode mcp -t streamable-http -H 127.0.0.2 -p 9000 &
559559
}
560560
```
561561

562+
##### Custom Certificates and Timeouts (Proxy Environments)
563+
564+
If your organization uses a corporate proxy or a custom CA bundle for HTTPS inspection, you need to tell Cycode CLI (and the underlying Python TLS stack) where to find the trusted certificate bundle. You can also increase the MCP tool call timeout if scans are being cut short.
565+
566+
| Environment Variable | Description |
567+
|----------------------|-------------|
568+
| `REQUESTS_CA_BUNDLE` | Path to a custom CA bundle file (`.pem` or `.crt`). Used by the `requests` library for all HTTPS calls made by Cycode CLI. |
569+
| `SSL_CERT_FILE` | Path to a custom CA bundle file. Used by Python's low-level `ssl` module. Set this alongside `REQUESTS_CA_BUNDLE` for full coverage. |
570+
| `MCP_TOOL_TIMEOUT` | Timeout (in seconds) that MCP clients such as Claude and GitHub Copilot wait for a tool call to complete. Increase this if long-running scans are being cut off before they finish. |
571+
572+
> [!TIP]
573+
> Set both `REQUESTS_CA_BUNDLE` and `SSL_CERT_FILE` to the same CA bundle path. `REQUESTS_CA_BUNDLE` covers the HTTP layer; `SSL_CERT_FILE` covers the lower-level TLS layer. Using only one may still cause certificate errors in some environments.
574+
575+
Example `mcp.json` configuration with custom certificates and a longer timeout:
576+
577+
```json
578+
{
579+
"mcpServers": {
580+
"cycode": {
581+
"command": "cycode",
582+
"args": ["mcp"],
583+
"env": {
584+
"REQUESTS_CA_BUNDLE": "/path/to/your/corporate-ca-bundle.pem",
585+
"SSL_CERT_FILE": "/path/to/your/corporate-ca-bundle.pem",
586+
"MCP_TOOL_TIMEOUT": "1800"
587+
}
588+
}
589+
}
590+
}
591+
```
592+
562593
> [!NOTE]
563594
> The MCP server requires proper Cycode CLI authentication to function. Make sure you have authenticated using `cycode auth` or configured your credentials before starting the MCP server.
564595
@@ -608,6 +639,8 @@ This information can be helpful when:
608639
- Identifying authentication problems
609640
- Debugging transport-specific issues
610641
642+
### MCP Configuration
643+
611644
612645
# Platform Command \[BETA\]
613646

0 commit comments

Comments
 (0)