Claude Code Integration

Claude Code is Anthropic’s official CLI and VS Code extension for Claude. This guide covers integrating Moira with Claude Code.

• Claude Code installed and configured
• Moira server access (cloud or self-hosted)
• Valid Moira account credentials

1. Open Claude Code settings

   In VS Code, open Command Palette and run:

   Claude Code: Open Settings

   Or edit directly:

   • Directory~/.claude/

     • settings.json

2. Add Moira MCP server

   Add to your settings.json with URL: https://moiraqq.com/mcp

3. Restart Claude Code

   Reload the window or restart VS Code to apply changes.

4. Authenticate

   When first using Moira tools, you’ll be prompted to authenticate. Follow the OAuth flow in your browser.

Test the connection by asking Claude:

List available Moira workflows

You should see your workflows listed.

Start the "development-flow" workflow in Moira

Claude will:

1. Call start_workflow with the workflow ID
2. Receive the first step directive
3. Execute the directive
4. Submit results via execute_step
5. Continue until workflow completes

If a session was interrupted, continue with:

Continue my Moira workflow with process ID abc-123

Show Moira documentation for nodes

Claude will call get_help with the topic.

For project-specific workflows, add to your CLAUDE.md:

## Moira Workflows

This project uses Moira for development workflows.

### Available Workflows

- `dev-flow` - Main development workflow
- `review-flow` - Code review workflow

### Starting Development

To start a task, run the development workflow:

1. Start `dev-flow` workflow
2. Follow each step directive
3. Submit results before moving to next step

Once connected, these tools are available:

1. Verify MCP server URL is correct
2. Check network connectivity
3. Ensure authentication is valid
4. Check Claude Code logs for errors

1. Verify workflow ID exists: list_workflows
2. Check workflow visibility permissions
3. Ensure you have access to the workflow

If process ID is lost:

1. Check get_session_info for active executions
2. Resume with the correct process ID
3. Consider adding process ID to CLAUDE.md for persistence

1. Save Process IDs - Store in CLAUDE.md for session continuity
2. Follow Directives - Execute exactly what the directive says
3. Meet Completion Conditions - Verify before submitting
4. Check Help - Use get_help when unsure

• Quick Start - General setup guide
• MCP Clients - Other client integrations