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, Amazon Q, or OpenAI Codex as your IDE
A Konductro account with project access

Install the Plugin

The Konductro plugins are published to the public npm registry under the @konductro scope. No registry configuration or authentication is required.

For Claude Code:

npm install -g @konductro/claude-plugin

For Amazon Q:

npm install -g @konductro/q-plugin

For OpenAI Codex:

npm install -g @konductro/codex-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
konductro-claude-setup --url https://platform.konductro.com --token <your-cli-token>
 
# Amazon Q plugin
konductro-q-setup --url https://platform.konductro.com --token <your-cli-token>
 
# OpenAI Codex plugin
konductro-codex-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 @konductro/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