Documentation

Get started with Orchestrix in your favorite AI-powered IDE.

Getting Started

Orchestrix provides AI-powered development agents through the MCP (Model Context Protocol). You can configure it with Claude Code or Cursor IDE in just a few steps.

Prerequisites: You'll need a license key to use Orchestrix.Sign up to get your license key, or log in to view your existing keys.

Installation

Orchestrix connects directly to our cloud server. No local dependencies required, always up-to-date.

Claude Code

Option 1: Command Line

claude mcp add --transport http orchestrix https://orchestrix-mcp.youlidao.ai/api/mcp \
  --header "Authorization: Bearer YOUR_LICENSE_KEY"

Option 2: Configuration File

Add to ~/.claude.json (global) or .mcp.json (project):

~/.claude.json
{
  "mcpServers": {
    "orchestrix": {
      "type": "http",
      "url": "https://orchestrix-mcp.youlidao.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_LICENSE_KEY"
      }
    }
  }
}

Cursor

Edit ~/.cursor/mcp.json:

~/.cursor/mcp.json
{
  "mcpServers": {
    "orchestrix": {
      "url": "https://orchestrix-mcp.youlidao.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_LICENSE_KEY"
      }
    }
  }
}

Slash Commands Setup

Install Slash Commands for easier agent activation. This is the recommended way to use Orchestrix.

Option 1: Automatic Installation (via Claude Code)

Important: Before running orchestrix-init, make sure the Orchestrix MCP Server is connected. Look for orchestrix: connected in the Claude Code status bar, or run /mcp to check MCP server status.

In Claude Code, use one of the following commands:

# Recommended - explicitly call the MCP tool
Please call the orchestrix-init tool from the Orchestrix MCP server

# Or use these alternative phrases:
Please run orchestrix-init to install Slash Commands
Use orchestrix MCP to initialize Slash Commands

Claude will call the orchestrix-init tool and create the following files automatically:

Slash Commands (in project root):

  • .claude/commands/o.md - Main agent activation command
  • .claude/commands/o-help.md - Show available agents
  • .claude/commands/o-status.md - Check server status

Project Configuration (in project root):

  • .orchestrix-core/core-config.yaml - Project-specific Orchestrix configuration
Tip: If Claude doesn't recognize the command, try being more explicit:Please call the orchestrix-init MCP tool
After Installation: You must restart Claude Code (/exit then claude) for the new Slash Commands to be recognized. Claude Code does not automatically reload commands.

Option 2: Manual Installation

Run this command in your terminal:

curl -fsSL https://raw.githubusercontent.com/dorayo/orchestrix-mcp-server/main/setup/install-commands.sh | bash

After installation, restart Claude Code to recognize the new commands.

Available Commands

After installation, these commands are available in Claude Code:

CommandDescription
/o [agent]Activate an agent (e.g., /o dev, /o sm)
/o-helpShow all available agents
/o-statusShow Orchestrix status

Usage

After configuration, restart Claude Code or Cursor to activate the MCP server.

Quick Start with Slash Commands

If you've installed the Slash Commands, simply type:

/o dev        # Activate Developer agent
/o sm         # Activate Scrum Master agent
/o qa         # Activate QA Engineer agent
/o architect  # Activate System Architect agent

Available Agents

AgentDescription
devFull Stack Developer
smScrum Master
qaQA Engineer
architectSystem Architect
analystBusiness Analyst
pmProduct Manager
poProduct Owner
ux-expertUX Expert

Troubleshooting

"Unknown slash command" after installation

Claude Code does not automatically reload Slash Commands. You must restart Claude Code:

/exit
claude

orchestrix-init tool not found

  • Make sure Orchestrix MCP Server is connected (check with /mcp)
  • Verify your license key is correct in the configuration
  • Try being more explicit: Please call the orchestrix-init tool from the Orchestrix MCP server

MCP server not connecting

  • Verify your license key is correct
  • Check that the configuration file is valid JSON
  • Restart your IDE after making changes

Learn More

For comprehensive guides, advanced usage, and detailed documentation, visit the Orchestrix Documentation.