Skip to main content
Version: Release 26.1

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 for production)

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.

RegistryPurposeExample Tags
xebialabsearlyaccess/dai-release-mcpEarly Access / Beta26.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

VariableDescriptionRequired
RELEASE_BASE_URLThe base URL of your Digital.ai Release server. Example: https://your-instance.digitalai.comYes
RELEASE_AUTH_TYPEAuthentication method: basic for username/password, token for personal access token. Values: basic, tokenYes
RELEASE_USERNAMEUsername for basic authentication. Only required if RELEASE_AUTH_TYPE is basic. Example: adminIf using basic
RELEASE_PASSWORDPassword for basic authentication. Only required if RELEASE_AUTH_TYPE is basic.If using basic
RELEASE_TOKENPersonal access token for authentication. Only required if RELEASE_AUTH_TYPE is token. Example: rpa_xxxxxxIf using token
MCP_READONLY_MODERun the MCP server in read-only mode (no changes will be made). Values: true, false. Default: falseNo
MCP_TRANSPORTTransport protocol: stdio, sse or streamable-http. Default: stdioNo
MCP_HOSTHost to bind to for HTTP transports (ignored for stdio). Default: 0.0.0.0No
MCP_PORTPort to bind to for HTTP transports (ignored for stdio). Default: 8000No

Logging Configuration

VariableDescriptionRequired
DAI_SERVICE_LOG_LEVELLogging level for the MCP server. Values: DEBUG, INFO, WARNING, ERROR, CRITICAL. Default: INFONo
DAI_FEATURE__PLAINTEXT_LOGGINGEnable plaintext (human-readable) logs instead of JSON. Values: true, false. Default: falseNo
DAI_FEATURE__FILE_LOGGINGEnable file logging to disk. Values: true, false. Default: falseNo
DAI_SERVICE_LOG_PATHFile path for log output. Required if DAI_FEATURE__FILE_LOGGING is true. Example: /var/log/digitalai/release-mcp/service.logIf file logging enabled