Installation

The Konductro CLI plugin takes a few minutes to set up. You need Node.js, an IDE that supports MCP, and a personal CLI token from Konductro.

Prerequisites

Node.js 18+ installed
Claude Code or Amazon Q as your IDE
A Konductro account with project access
An Azure DevOps PAT with Packaging > Read permission

Connect to the npm Registry

The Konductro plugins are published to a private Azure Artifacts feed. Run these two commands once to register and authenticate:

npm config set @conductor:registry https://pkgs.dev.azure.com/idealsolution/_packaging/conductor/npm/registry/
npm config set //pkgs.dev.azure.com/idealsolution/_packaging/conductor/npm/registry/:_authToken YOUR_ADO_PAT

Replace YOUR_ADO_PAT with a personal access token from Azure DevOps that has Packaging > Read scope.

Install the Plugin

For Claude Code:

npm install -g @conductor/claude-plugin

For Amazon Q:

npm install -g @conductor/q-plugin

Generate a CLI Token

Open Konductro

Navigate to your profile settings in the Konductro platform UI.

Create a token

Under CLI Tokens, click Generate Token. Give it a descriptive name (e.g. "MacBook — Claude Code"). Copy the token — it is shown only once.

Configure the plugin

Run the setup command with your Konductro platform URL and CLI token:

# Claude Code plugin
conductor-claude-setup --url https://platform.konductro.com --token <your-cli-token>
 
# Amazon Q plugin
conductor-q-setup --url https://platform.konductro.com --token <your-cli-token>

Replace <your-cli-token> with the token you copied in the previous step. If your organisation uses a self-hosted instance, replace the URL accordingly.

The setup command registers the MCP server with your IDE and stores the connection configuration locally.

Verify the Connection

After setup, verify the plugin can reach Konductro:

# List your assigned tickets — if this returns results, you're connected
/list-tickets

Updating

Update to the latest version the same way you installed:

npm install -g @conductor/claude-plugin@latest

Troubleshooting

Problem	Solution
`EACCES` permission error	Use `sudo` or fix npm global permissions
Token rejected	Verify the token has not been revoked in Konductro settings
Plugin not recognised by IDE	Restart the IDE after installation
Connection timeout	Check that `platform.konductro.com` is reachable from your network