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.
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):
{
"mcpServers": {
"orchestrix": {
"type": "http",
"url": "https://orchestrix-mcp.youlidao.ai/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_LICENSE_KEY"
}
}
}
}Cursor
Edit ~/.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)
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 CommandsClaude 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
Please call the orchestrix-init MCP tool/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 | bashAfter installation, restart Claude Code to recognize the new commands.
Available Commands
After installation, these commands are available in Claude Code:
| Command | Description |
|---|---|
| /o [agent] | Activate an agent (e.g., /o dev, /o sm) |
| /o-help | Show all available agents |
| /o-status | Show 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 agentAvailable Agents
| Agent | Description |
|---|---|
| dev | Full Stack Developer |
| sm | Scrum Master |
| qa | QA Engineer |
| architect | System Architect |
| analyst | Business Analyst |
| pm | Product Manager |
| po | Product Owner |
| ux-expert | UX Expert |
Troubleshooting
"Unknown slash command" after installation
Claude Code does not automatically reload Slash Commands. You must restart Claude Code:
/exit
claudeorchestrix-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.