Skip to main content
Version: Release 25.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.1.5 or later
  • API credentials (username/password or personal access token)
  • Docker: Must be installed and running. See Get Docker.

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 on Docker​

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.

For more information about the environment configuration variables, see Environment Variables.

RegistryPurposeExample Tags
xebialabsearlyaccess/dai-release-mcpEarly Access25.3-beta, 25.3.0-beta.926

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
{
  "servers": {
    "dai-release-mcp": {
      "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:25.3.0-beta.926"
      ]
    }
  }
}

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
{
  "mcpServers": {
    "dai-release-mcp": {
      "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:25.3.0-beta.926"
      ]
    }
  }
}

Environment Variables​

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. Example: yourpasswordIf using basic
RELEASE_TOKENPersonal access token for authentication. Only required if RELEASE_AUTH_TYPE is token. Example: dai.xxxxxxxxIf using token
MCP_LOG_LEVELLogging level for the MCP server. Values: INFO, DEBUG, WARNING, ERROR. Default: INFONo
MCP_ENABLE_FILE_LOGGINGEnable file logging. Values: true, false. Default: falseNo
MCP_READONLY_MODERun the MCP server in read-only mode (no changes will be made). Values: true, false. Default: falseNo