Skip to content
Moira Documentation

Quick Start

This guide helps you connect Moira to your AI client and run your first workflow.

Prerequisites

Section titled “Prerequisites”
  • An MCP-compatible AI client (see supported clients below)
  • Moira account (sign up at moiraqq.com)

Setup

Section titled “Setup”

  1. Get your MCP endpoint

    For Moira Cloud: https://moiraqq.com/mcp

    For self-hosted, use your server’s MCP endpoint.

  2. Configure your AI client

    claude.ai - Browser chat (Pro/Max/Team/Enterprise)

    1. Go to Settings → Connectors
    2. Click “Add custom connector”
    3. Enter Server URL: https://moiraqq.com/mcp
    4. Click “Connect”
    5. Complete OAuth authentication in browser
    6. Tools appear in chat

    Requires paid plan

  3. Authenticate the MCP server

    After adding the server configuration, complete OAuth authentication. Most clients will prompt you automatically or have an “Authenticate” button.

  4. Verify connection

    Ask your AI client to list available Moira workflows:

    List available Moira workflows

    You should see a list of workflows you have access to.

  5. Start the user onboarding

    Now simply type in the chat:

    Start user onboarding flow

    The agent will guide you through an interactive onboarding experience that:

    • Explains Moira by demonstrating a workflow in action
    • Shows you key workflows available
    • Helps you get started with your first real task

    This is the recommended way to learn Moira!

Available MCP Tools

Section titled “Available MCP Tools”

Once connected, your AI client has access to these Moira tools:

ToolDescription
list_workflowsList available workflows
start_workflowStart a new workflow execution
execute_stepSubmit step result and get next directive
get_helpGet documentation and help
manage_settingsManage user settings

Example Session

Section titled “Example Session”

Here’s what a typical workflow session looks like:

Agent: I'll start the development workflow.
       [calls start_workflow with workflowId: "development-flow"]


Moira: Process ID: abc-123
       Your next task: Analyze the requirements document...
       Success criteria: Requirements are documented...


Agent: [analyzes requirements, produces output]
       [calls execute_step with processId: "abc-123" and result]


Moira: Process ID: abc-123
       Your next task: Create implementation plan...
       Success criteria: Plan covers all requirements...


[... workflow continues until completion]

Next Steps

Section titled “Next Steps”