Connecting to the DevOps Velocity MCP server using Claude Desktop

You can connect to the HCL DevOps Velocity (Velocity) 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 and enabled the MCP server. See MCP server setup in DevOps Velocity.
  • Obtained the MCP Server URL. For example: https://<velocity_hostname>/mcp
  • Ensured that Claude Desktop is installed.
You must have

Procedure

  1. Open Claude Desktop.
  2. Go to My Profile → Settings → Developer.
  3. Configure the MCP server by adding the JSON configuration. 
    {
  "mcpServers": {
    "velocity-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "<velocity_mcp_server_url>",
        "-k",
        "--allow-http",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "UserAccessKey <velocity_user_access_key>",
        "NODE_TLS_REJECT_UNAUTHORIZED": "0"
      }
    }
  }
}
    Notes:
    • The -k argument allows self-signed certificates. Use it only if required.
    • The --allow-http option enables non-https communication.
    • The environment variable NODE_TLS_REJECT_UNAUTHORIZED=0 should be used only in testing environments.
    Property Description
    <velocity_mcp_server_url> Specifies the full Velocity MCP server URL. For example:

    https://<velocity_hostname>/mcp
    <velocity_user_access_key> Provides the credentials necessary to access the Velocity MCP server. Create an User Access Key in Velocity and use it.
  4. Save your changes and restart Claude Desktop.
  5. Go to My Profile → Settings → Developer.
  6. Verify the connection.
    The Velocity MCP Server status should display Running.

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.