Skip to content

Commit 8fd792c

Browse files
added a section for common issues
1 parent ceb36fc commit 8fd792c

File tree

1 file changed

+29
-0
lines changed

1 file changed

+29
-0
lines changed

README.md

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -400,3 +400,32 @@ For VS Code configuration with Docker and proxy, modify the settings.json like t
400400
}
401401
}
402402
```
403+
404+
## Common Issues
405+
If you are experiencing issues with the MCP server, here are some common troubleshooting steps:
406+
### Review Log
407+
A log will be created, by default under `/tmp/mcp-contrast.log` either locally or witin the docker container. You can view this log to see if there are any errors or issues with the MCP server.
408+
409+
### Enable Debug Logging
410+
To enable debug logging you can add the following flag to the command line arguments when running the MCP server:
411+
`--logging.level.root=DEBUG`
412+
This can be added at this part of the docker command
413+
```
414+
"--rm",
415+
"contrast/mcp-contrast:latest",
416+
"-t",
417+
"--logging.level.root=DEBUG",
418+
"stdio"
419+
],
420+
```
421+
422+
### Certificate Issues
423+
If the SSL Certificate for the Teamserver URL is not trusted, you may see the following error:
424+
```
425+
Failed to list applications: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target
426+
```
427+
If this occurs you will need to add the certificate to the Java Truststore and then add the following to the command line arguments when running the MCP server:
428+
`-Djavax.net.ssl.trustStore=/loctaion/to/mcp-truststore.jks, -Djavax.net.ssl.trustStorePassword=yourpassword`
429+
More details on how to do this can be found in the [Java documentation](https://docs.oracle.com/cd/E19509-01/820-3503/6nf1il6er/index.html). Or ask your LLM to help you with this.
430+
431+

0 commit comments

Comments
 (0)