Installation and Configuration
You can install and run the Release MCP Server using Docker. Docker is recommended as it provides a consistent, containerized environment that is easy to deploy and manage.
To set up the Release MCP server, you need:
- Access to the target infrastructure: Ability to run Docker containers on the intended server or workstation.
- Digital.ai Release API credentials: You can use your own credentials (username/password) or personal access tokens. You will only be able to perform operations according to your access rights in the Release instance.
Prerequisites
- Digital.ai Release 25.3 or later
- API credentials
- Docker: Docker must be installed and running.
Authentication Methods
- Basic Authentication (username/password)
- Personal Access Token (recommended)
You can use your own credentials or personal access tokens. You will only be able to perform operations according to your access rights in the Release instance.
Install the Release MCP Server
Installing the Release MCP Server on Docker is recommended as it provides a simple, reliable, and repeatable way to deploy the server in any environment that supports Docker. You will pull the official Docker image and start the server container with the required configuration.
| Registry | Purpose | Example Tags |
|---|---|---|
| xebialabsearlyaccess/dai-release-mcp | Early Access / Beta | 26.1-beta, 26.1.0-beta.319 |
Visual Studio Code Configuration
To use Visual Studio Code as a client to interact with the Release MCP Server, edit your MCP configuration.
- macOS:
~/Library/Application Support/Code/User/mcp.json - Windows:
%APPDATA%\Code\User\mcp.json
Using Docker with Environment Variables
{
"servers": {
"digitalai-release": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"-e", "RELEASE_BASE_URL=https://your-release-server.com",
"-e", "RELEASE_AUTH_TYPE=token",
"-e", "RELEASE_TOKEN=your-personal-access-token",
"xebialabsearlyaccess/dai-release-mcp:26.1.0-beta.319"
]
}
}
}
Using Docker with Environment File
Create a .env file with your credentials:
RELEASE_BASE_URL=https://your-release-server.com
RELEASE_AUTH_TYPE=token
RELEASE_TOKEN=your-personal-access-token
Then reference it in your configuration:
{
"servers": {
"digitalai-release": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"--env-file", "/path/to/your/.env",
"xebialabsearlyaccess/dai-release-mcp:26.1.0-beta.319"
]
}
}
}
Claude Desktop Configuration
Configure Claude Desktop if you want to connect to the Release MCP Server from the Claude Desktop application.
Edit your configuration file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Using Docker
{
"mcpServers": {
"digitalai-release": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"-e", "RELEASE_BASE_URL=https://your-release-server.com",
"-e", "RELEASE_AUTH_TYPE=token",
"-e", "RELEASE_TOKEN=your-personal-access-token",
"xebialabsearlyaccess/dai-release-mcp:26.1.0-beta.319"
]
}
}
}
Restart Claude Desktop to load the MCP server.
Environment Variables
Core Configuration
| Variable | Description | Required |
|---|---|---|
RELEASE_BASE_URL | The base URL of your Digital.ai Release server. Example: https://your-instance.digitalai.com | Yes |
RELEASE_AUTH_TYPE | Authentication method: basic for username/password, token for personal access token. Values: basic, token | Yes |
RELEASE_USERNAME | Username for basic authentication. Only required if RELEASE_AUTH_TYPE is basic. Example: admin | If using basic |
RELEASE_PASSWORD | Password for basic authentication. Only required if RELEASE_AUTH_TYPE is basic. | If using basic |
RELEASE_TOKEN | Personal access token for authentication. Only required if RELEASE_AUTH_TYPE is token. Example: rpa_xxxxxx | If using token |
MCP_READONLY_MODE | Run the MCP server in read-only mode (no changes will be made). Values: true, false. Default: false | No |
MCP_TRANSPORT | Transport protocol: stdio, sse or streamable-http. Default: stdio | No |
MCP_HOST | Host to bind to for HTTP transports (ignored for stdio). Default: 0.0.0.0 | No |
MCP_PORT | Port to bind to for HTTP transports (ignored for stdio). Default: 8000 | No |
Logging Configuration
| Variable | Description | Required |
|---|---|---|
DAI_SERVICE_LOG_LEVEL | Logging level for the MCP server. Values: DEBUG, INFO, WARNING, ERROR, CRITICAL. Default: INFO | No |
DAI_FEATURE__PLAINTEXT_LOGGING | Enable plaintext (human-readable) logs instead of JSON. Values: true, false. Default: false | No |
DAI_FEATURE__FILE_LOGGING | Enable file logging to disk. Values: true, false. Default: false | No |
DAI_SERVICE_LOG_PATH | File path for log output. Required if DAI_FEATURE__FILE_LOGGING is true. Example: /var/log/digitalai/release-mcp/service.log | If file logging enabled |