Welcome
Administering
This guide describes how to install HCL DevOps Velocity (Velocity). After you install Velocity, you can perform administrative tasks such as license configuration, upgrading, migrating, managing access permissions and security. This guide is intended for system administrators.
DevOps Velocity MCP server
A Model Context Protocol (MCP) server provides a structured way for GenAI clients to access tools, data, and actions through a consistent, secure interface. When you connect a GenAI client that supports MCP to the HCL DevOps Velocity (Velocity) MCP server, you can use natural-language requests to retrieve information from your Velocity.
Connecting to the DevOps Velocity MCP server in Claude Desktop
You can connect to the HCL DevOps Velocity (Velocity) Model Context Protocol (MCP) server by using the Claude Desktop application to interact with Velocity and retrieve the necessary data and insights.

Release Notes
This document includes information about the new features introduced, defects fixed, and known issues identified in this version of HCL DevOps Velocity (Velocity). You can also find the installation and upgrade instructions along with the contact information of HCL Customer Support.
System Requirements
This document contains information about hardware and software requirements for HCL DevOps Velocity (Velocity).
Getting Started
This document provides an overview of HCL DevOps Velocity (Velocity).
High-Level Overview
Use HCL DevOps Velocity (Velocity) to automate your release lifecycle and manage your DevOps value streams.
Learning
Learn how to complete frequently-used tasks such as creating value streams.
Managing licenses
Configure your license or apply a trial key.
Administering
This guide describes how to install HCL DevOps Velocity (Velocity). After you install Velocity, you can perform administrative tasks such as license configuration, upgrading, migrating, managing access permissions and security. This guide is intended for system administrators.
- Installing DevOps Velocity
  To get started with HCL DevOps Velocity (Velocity), you must install it on any one of the container platforms. You can find information about the selection of a container platform, installation methods, and procedure for installing Velocity.
- Installing DevOps Velocity plugins on air-gapped networks
  HCL DevOps Velocity (Velocity) plugin installations on air-gapped networks.
- Uninstalling DevOps Velocity
  You can uninstall HCL DevOps Velocity (Velocity) by stopping the server and removing the product containers.
- Configuring trusted certificates in DevOps Velocity
  The default configuration in Velocity accepts connections with self-signed CA certificates. You can configure Velocity to restrict self-signed CA certificates and allow only a predefined set of trusted CA certificates.
- Upgrading DevOps Velocity
  You can find information about upgrading of HCL DevOps Velocity (Velocity).
- Migrating DevOps Velocity
  You can find information about migration of HCL DevOps Velocity (Velocity) to another container orchestration.
- Configuring DevOps Velocity
  A default HCL DevOps Velocity (Velocity) administrator ID is included as part of Velocity. It is used to install and complete initial configuration tasks.
- DevOps Velocity MCP server
  A Model Context Protocol (MCP) server provides a structured way for GenAI clients to access tools, data, and actions through a consistent, secure interface. When you connect a GenAI client that supports MCP to the HCL DevOps Velocity (Velocity) MCP server, you can use natural-language requests to retrieve information from your Velocity.
  - Getting Started with the MCP server in DevOps Velocity: URL and Tools
    You can find information about the connection endpoint for the Model Context Protocol (MCP) server in HCL DevOps Velocity (Velocity) and explore the available tools for accessing application data, workflows, and metrics.
  - Prerequisites to connect with the MCP server in DevOps Velocity
    You can find information about the requirements and setup steps needed before connecting to the MCP server in HCL DevOps Velocity (Velocity).
  - Connecting to the DevOps Velocity MCP server in Claude Desktop
    You can connect to the HCL DevOps Velocity (Velocity) Model Context Protocol (MCP) server by using the Claude Desktop application to interact with Velocity and retrieve the necessary data and insights.
  - Connecting to the DevOps Velocity MCP server by using GitHub Copilot in Visual Studio Code
    You can connect to the HCL DevOps Velocity (Velocity) Model Context Protocol (MCP) server by using GitHub Copilot in Visual Studio (VS) Code to interact with Velocity and retrieve the necessary data and insights.
  - Disabling the MCP Deployment in DevOps Velocity
    You can disable the MCP deployment in the HCL DevOps Velocity (Velocity) to minimize resource consumption if the MCP server is not in use. By default, the MCP deployment is enabled. The MCP deployment is enabled with the default configuration.
Managing Value Streams
A value stream represents the objects and activities that you employ to deliver customer value, from initial concept to final delivered project.
Developing Data Insights
The Insights feature provides DevOps metrics for your project data.
Analytics Dashboards
Analytics creates team-specific dashboards that generate charts for each activity of the product development. HCL DevOps Velocity (Velocity) creates dashboards automatically while you create a team.
Releasing Software
A release is a repeatable plan that is used to drive deployments.
Extending Product Functions
Learn how to extend the function of HCL DevOps Velocity (Velocity)
How to
The topics in this section describe how to work with HCL DevOps Velocity (Velocity) features. Tutorials and workbooks are available for users of all experience levels.
Troubleshooting
Before you contacting support, gather background information and perform tasks that will assist in solving the problem. It helps to be as specific as possible and include all relevant information.
Notices for DevOps Velocity
This document provides information about copyright, trademarks, terms and conditions for the product documentation.
DevOps Velocity GDPR statement
General Data Protection Regulation (GDPR) has been adopted by the European Union (EU) and applies from May 25, 2018.
Glossary

Connecting to the DevOps Velocity MCP server in Claude Desktop

You can connect to the HCL DevOps Velocity (Velocity) Model Context Protocol (MCP) server by using the Claude Desktop application to interact with Velocity and retrieve the necessary data and insights.

Before you begin

You must have completed the following tasks:

Installed Velocity, configured Keycloak, and set up OIDC authentication in Velocity. See Prerequisites to connect with the MCP server in DevOps Velocity.
Obtained the MCP Server URL. For example: https://<velocity_hostname>/mcp
Ensured that Claude Desktop is installed.

Procedure

Open the Claude Desktop application.
Navigate to Settings > Connectors.
Click Add custom connector.
The Add custom connector window is displayed.
Enter the name of the connector. For example: Velocity MCP server
Enter the Velocity MCP server URL in the Remote MCP server URL field.
Click Add.
The MCP server is now added and listed on the Connectors page.
Click the Connect button next to the newly added Velocity MCP server entry.

Claude Desktop redirects you to the DevOps Loop login page.
Sign in using the Velocity OIDC user credentials.

A consent screen is displayed requesting access to MCP tools, Velocity APIs that are used internally for tool execution, and basic profile and role information.
Click Yes to approve and complete the connection.

After successful authentication, Claude Desktop displays the list of available MCP tools provided by the Velocity MCP Server.

Note: The MCP server times out after 30 minutes of inactivity. If no tool calls occur during this period, your session expires and you are required to re-authenticate.

Results

You have successfully connected to the Velocity MCP server by using Claude Desktop.

What to do next

You can run prompts related to Velocity to confirm a successful connection.