Claude Code

Setup — one command

Run this once in any terminal. Claude Code registers Conductor immediately — it's available in the current session and all future sessions.

claude mcp add conductor -- npx -y @useconductor/conductor

This uses npx — no global install needed. Conductor downloads and runs on first use.

Setup — with global install

If you installed Conductor globally with npm, register the binary directly. Slightly faster startup since it skips npx resolution.

# Install globally first (optional — npx works without it)
npm install -g @useconductor/conductor

# Then register with Claude Code
claude mcp add conductor -- conductor mcp start

Verify it worked

# List all registered MCP servers
claude mcp list

# Should show:
# conductor    npx -y @useconductor/conductor    enabled

Or ask Claude Code directly:

# These prompts verify specific plugins are working:

"List the files in the current directory"
→ Uses filesystem.list

"What's the git status of this repo?"
→ Uses git.status

"Run: echo hello"
→ Uses shell.exec (will ask for approval first)

"Search for TODO comments in src/"
→ Uses filesystem.search

Passing environment variables

Plugin credentials (GitHub token, Slack token, etc.) can be passed directly through Claude Code's MCP config using -e flags. These are stored securely and passed to the Conductor process at startup.

# Pass environment variables to Conductor from Claude Code
claude mcp add conductor \
  -e GITHUB_TOKEN=ghp_... \
  -e SLACK_BOT_TOKEN=xoxb-... \
  -- npx -y @useconductor/conductor

Scope — global vs project

By default, claude mcp add registers globally (all projects). Use --scope project to create a .mcp.json file in the repo — commit it to share Conductor with your team.

# Add to current project only (creates .mcp.json in repo root)
claude mcp add conductor --scope project -- npx -y @useconductor/conductor

# Add globally for all projects (default)
claude mcp add conductor --scope global -- npx -y @useconductor/conductor

# Add for current user only
claude mcp add conductor --scope user -- npx -y @useconductor/conductor

// .mcp.json — committed to repo, shared with team
{
  "mcpServers": {
    "conductor": {
      "command": "npx",
      "args": ["-y", "@useconductor/conductor"]
    }
  }
}

Managing Conductor in Claude Code

Troubleshooting