Troubleshooting

Common Issues

Connection refused

• Verify your Release URL is accessible from the machine running the MCP server.
• Check firewall/proxy settings.
• Ensure the Digital.ai Release server is running.

Authentication failed

• Basic auth: Verify RELEASE_USERNAME and RELEASE_PASSWORD are correct.
• Token auth: Use a Personal Access Token and ensure it has not expired. Verify with RELEASE_TOKEN.
• Check that your user has the required API access permissions in the Release instance.

---

Enable Debug Logging

The following environment variables from older documentation are deprecated. Use the platform-standard replacements:

Deprecated Variable	Replacement	Notes
MCP_LOG_LEVEL	DAI_SERVICE_LOG_LEVEL	Values: DEBUG, INFO, WARNING, ERROR, CRITICAL
MCP_ENABLE_FILE_LOGGING	DAI_FEATURE__FILE_LOGGING	Values: true, false

To enable debug logging, set the platform logging variable:

{
  "env": {
    "DAI_SERVICE_LOG_LEVEL": "DEBUG",
    "DAI_FEATURE__FILE_LOGGING": "true"
  }
}

Docker

docker run --rm -i \
  -e RELEASE_BASE_URL=https://your-release-server.com \
  -e RELEASE_AUTH_TYPE=token \
  -e RELEASE_TOKEN=your-token \
  -e DAI_SERVICE_LOG_LEVEL=DEBUG \
  xebialabsearlyaccess/dai-release-mcp:26.1.0-beta.319

---