Быстрый старт

Это руководство поможет подключить Moira к вашему AI-клиенту и запустить первый воркфлоу.

Предварительные требования

• MCP-совместимый AI-клиент (см. поддерживаемые клиенты ниже)
• Аккаунт Moira (регистрация на Moira)

Настройка

1. Получите MCP endpoint

   Для Moira Cloud: https://moira-mcp.com/mcp

   Для self-hosted используйте endpoint вашего сервера.

2. Настройте AI-клиент

Claude Code

Рекомендуется: используйте CLI-команду

Terminal

claude mcp add --transport http moira https://moira-mcp.com/mcp

Затем авторизуйтесь:

OAuth Flow

# После добавления авторизуйтесь в claude:
/mcp
# → Выберите "moira"
# → Нажмите "Authenticate"
# → Откроется браузер для OAuth

Альтернатива: ручная настройка JSON

{
  "mcpServers": {
    "moira": {
      "url": "https://moira-mcp.com/mcp"
    }
  }
}

Аутентификация без OAuth

Для CI/CD, Docker или окружений без браузера — используйте API токен вместо OAuth.

1. Войдите в веб-интерфейс Moira → Настройки → API Токены
2. Создайте токен (начинается с moira_)
3. Замените moira_YOUR_TOKEN ниже на ваш токен

~/.config/claude/mcp.json

{
  "mcpServers": {
    "moira": {
      "url": "https://moira-mcp.com/mcp",
      "headers": {
        "Authorization": "Bearer moira_YOUR_TOKEN"
      }
    }
  }
}

Copilot CLI

Рекомендуется: файл конфигурации

~/.copilot/mcp-config.json

{
  "mcpServers": {
    "moira": {
      "type": "http",
      "url": "https://moira-mcp.com/mcp"
    }
  }
}

Затем авторизуйтесь:

OAuth Flow

# После сохранения конфигурации:
# 1. Запустите сессию Copilot CLI
# 2. Введите /mcp
# 3. Выберите "moira" → Authenticate
# → Откроется браузер для OAuth

Альтернатива: интерактивная настройка

# В Copilot CLI:
/mcp
# → Нажмите "Add server"
# → Введите URL сервера
# → Завершите OAuth

# Конфигурация на уровне проекта:
# .copilot/mcp-config.json (тот же формат)

Аутентификация без OAuth

Для CI/CD, Docker или окружений без браузера — используйте API токен вместо OAuth.

1. Войдите в веб-интерфейс Moira → Настройки → API Токены
2. Создайте токен (начинается с moira_)
3. Замените moira_YOUR_TOKEN ниже на ваш токен

~/.copilot/mcp-config.json

{
  "mcpServers": {
    "moira": {
      "type": "http",
      "url": "https://moira-mcp.com/mcp",
      "headers": {
        "Authorization": "Bearer moira_YOUR_TOKEN"
      }
    }
  }
}

Cursor

Рекомендуется: Установка в один клик

Добавить в Cursor

Затем авторизуйтесь:

OAuth Flow

# После нажатия кнопки:
# 1. Cursor откроется с запросом на установку
# 2. Нажмите "Install", чтобы добавить moira MCP сервер
# 3. Settings → MCP Servers → Найдите "moira"
# 4. Нажмите "Authenticate" → Браузер откроется для OAuth

Альтернатива: Ручная настройка JSON

~/.cursor/mcp.json

{
  "mcpServers": {
    "moira": {
      "url": "https://moira-mcp.com/mcp"
    }
  }
}

Аутентификация без OAuth

Для CI/CD, Docker или окружений без браузера — используйте API токен вместо OAuth.

1. Войдите в веб-интерфейс Moira → Настройки → API Токены
2. Создайте токен (начинается с moira_)
3. Замените moira_YOUR_TOKEN ниже на ваш токен

~/.cursor/mcp.json

{
  "mcpServers": {
    "moira": {
      "url": "https://moira-mcp.com/mcp",
      "headers": {
        "Authorization": "Bearer moira_YOUR_TOKEN"
      }
    }
  }
}

Claude Desktop

Десктоп-приложение: GUI-метод

Settings → Connectors

# В приложении Claude Desktop:

# 1. Откройте Settings (⌘+,)
# 2. Перейдите на вкладку "Connectors"
# 3. Нажмите "Add custom connector"
# 4. Введите:
#    Server URL: https://moira-mcp.com/mcp
# 5. Нажмите "Connect"
# 6. Откроется браузер → OAuth → Готово

# Редактировать файлы не нужно

VS Code

Рекомендуется: Установка в один клик

Добавить в VS Code

Затем авторизуйтесь:

OAuth Flow

# После нажатия кнопки:
# 1. VS Code откроется с запросом на установку
# 2. Нажмите "Install", чтобы добавить moira MCP сервер
# 3. Settings → MCP Servers → Найдите "moira"
# 4. Нажмите "Authenticate" → Браузер откроется для OAuth

Альтернатива: Ручная настройка

settings.json

{
  "mcpServers": {
    "moira": {
      "url": "https://moira-mcp.com/mcp"
    }
  }
}

Аутентификация без OAuth

Для CI/CD, Docker или окружений без браузера — используйте API токен вместо OAuth.

1. Войдите в веб-интерфейс Moira → Настройки → API Токены
2. Создайте токен (начинается с moira_)
3. Замените moira_YOUR_TOKEN ниже на ваш токен

settings.json

{
  "mcpServers": {
    "moira": {
      "url": "https://moira-mcp.com/mcp",
      "headers": {
        "Authorization": "Bearer moira_YOUR_TOKEN"
      }
    }
  }
}

Claude Web

claude.ai - Веб-чат (самый популярный)

Settings → Connectors

# На claude.ai (Pro/Max/Team/Enterprise):

# 1. Откройте Settings → Connectors
# 2. Нажмите "Add custom connector"
# 3. Введите:
#    Server URL: https://moira-mcp.com/mcp
# 4. Нажмите "Connect"
# 5. Завершите OAuth-аутентификацию в браузере
# 6. Инструменты появятся в чате

# Требуется платный тариф

ChatGPT

chat.openai.com - Веб-чат

Settings → Connectors

# На chat.openai.com (Plus/Pro):

# 1. Profile → Settings
# 2. Перейдите в "Connectors" или "Integrations"
# 3. Нажмите "Add connector"
# 4. Введите:
#    Name: MCP Moira
#    URL: https://moira-mcp.com/mcp
# 5. Завершите OAuth-аутентификацию
# 6. Инструменты доступны в чате

# Бесплатный тариф не поддерживает MCP

Perplexity

Mac-приложение: с хелпером

Settings → Connectors

# Perplexity Mac App:

# 1. Сначала установите PerplexityXPC хелпер:
#    Settings → Connectors → Install Helper
# 2. Нажмите "Add Connector"
# 3. Введите:
#    Server Name: moira
#    Command: npx
#    Args: -y mcp-remote https://moira-mcp.com/mcp
# 4. Завершите OAuth-аутентификацию
# 5. Попросите Perplexity использовать инструменты MCP Moira

# Рекомендуется платный тариф

Continue

Расширение VS Code: Open-source AI-ассистент

config.yaml

mcpServers:
  - name: moira
    url: "https://moira-mcp.com/mcp"

Аутентификация без OAuth

Для CI/CD, Docker или окружений без браузера — используйте API токен вместо OAuth.

1. Войдите в веб-интерфейс Moira → Настройки → API Токены
2. Создайте токен (начинается с moira_)
3. Замените moira_YOUR_TOKEN ниже на ваш токен

config.yaml

mcpServers:
  - name: moira
    url: "https://moira-mcp.com/mcp"
    headers:
      Authorization: "Bearer moira_YOUR_TOKEN"

Zed

Быстрый редактор кода с AI

~/.config/zed/settings.json

{
  "context_servers": {
    "moira": {
      "url": "https://moira-mcp.com/mcp"
    }
  }
}

Аутентификация без OAuth

Для CI/CD, Docker или окружений без браузера — используйте API токен вместо OAuth.

1. Войдите в веб-интерфейс Moira → Настройки → API Токены
2. Создайте токен (начинается с moira_)
3. Замените moira_YOUR_TOKEN ниже на ваш токен

~/.config/zed/settings.json

{
  "context_servers": {
    "moira": {
      "url": "https://moira-mcp.com/mcp",
      "headers": {
        "Authorization": "Bearer moira_YOUR_TOKEN"
      }
    }
  }
}

Gemini CLI

Google AI терминальный ассистент

~/.gemini/settings.json

{
  "mcpServers": {
    "moira": {
      "httpUrl": "https://moira-mcp.com/mcp"
    }
  }
}

Аутентификация без OAuth

Для CI/CD, Docker или окружений без браузера — используйте API токен вместо OAuth.

1. Войдите в веб-интерфейс Moira → Настройки → API Токены
2. Создайте токен (начинается с moira_)
3. Замените moira_YOUR_TOKEN ниже на ваш токен

~/.gemini/settings.json

{
  "mcpServers": {
    "moira": {
      "httpUrl": "https://moira-mcp.com/mcp",
      "headers": {
        "Authorization": "Bearer moira_YOUR_TOKEN"
      }
    }
  }
}

3. Авторизуйте MCP сервер

   После добавления конфигурации сервера завершите OAuth-аутентификацию. Большинство клиентов запросят авторизацию автоматически или имеют кнопку “Authenticate”.

   OAuth не поддерживается?

   Если ваш клиент не может открыть браузер для OAuth, создайте API-токен:

   1. Войдите в веб-интерфейс Moira → Settings → API Tokens
   2. Создайте токен и скопируйте его (начинается с moira_)
   3. Добавьте его как Authorization: Bearer moira_... заголовок в конфигурации клиента

   Подробнее: MCP клиенты → API-токены

4. Проверьте подключение

   Попросите AI-клиент вывести список воркфлоу Moira:

   Покажи доступные воркфлоу Moira

   Вы должны увидеть список доступных воркфлоу.

5. Начните с онбординга

   Теперь просто напишите в чате:

   Запусти воркфлоу "user-onboarding" в Moira

   Интерактивный онбординг:

   • показывает на практике директивы, критерии завершения, входные схемы и переход после проверенного результата;
   • читает все страницы текущего доступного вам публичного каталога, а не использует скопированный список;
   • объясняет границы между готовыми checklist, задачами с предварительным планом, декомпозицией и recovery отдельных пунктов, быстрыми и восстанавливаемыми задачами, полной разработкой, ограниченной проверкой, filesystem-first итеративным исследованием, переносимым адаптивным исследованием с файловым или memory-состоянием, corpus-scale исследованием, анализом предоставленных данных, планированием тестов, требованиями к продукту, контентом и созданием воркфлоу;
   • сохраняет одну точную квалифицированную идентичность, например moira/test-planning;
   • просит явно выбрать запуск или отсрочку: отсрочка ничего не изменяет, а запуск создаёт выбранный воркфлоу как дочернее выполнение, связанное с онбордингом.

   Используйте онбординг для первого знакомства с Moira. Если нужный воркфлоу уже известен, запускайте его напрямую.

Доступные MCP-инструменты

Основной цикл выполнения использует следующие инструменты Moira:

Инструмент	Описание
list	Получить доступные воркфлоу с пагинацией
start	Подготовить или выполнить отдельный либо дочерний запуск
step	Отправить проверенный результат шага и получить новую директиву
session	Просмотреть и возобновить выполнение воркфлоу
help	Получить документацию и справку Moira

Moira также предоставляет операции управления workflow, настройками, заметками, артефактами, блокировками, reconciliation и токенами больших файлов. Полный актуальный каталог, точные входные схемы, поддерживаемые действия и примеры находятся в справочнике MCP-инструментов.

Пример сессии

Вот как выглядит типичная сессия воркфлоу:

Агент: Запускаю полный воркфлоу разработки.
       [вызывает start с workflowId: "moira/software-development-flow"
        и parentExecutionId: "none"]

Moira: Process ID: 123e4567-e89b-42d3-a456-426614174000
       Step attempt ID: 11111111-1111-4111-8111-111111111111
       Ваша следующая задача: Проанализировать документ требований...
       Критерий успеха: Требования задокументированы...

Агент: [анализирует требования, создает вывод]
       [вызывает step с точными Process ID, текущим Step attempt ID
        и данными по входной схеме]

Moira: Process ID: 123e4567-e89b-42d3-a456-426614174000
       Step attempt ID: 22222222-2222-4222-8222-222222222222
       Ваша следующая задача: Создать план реализации...
       Критерий успеха: План охватывает все требования...

[... воркфлоу продолжается до завершения]

Следующие шаги

• Воркфлоу — Понимание структуры воркфлоу
• Интеграция с Claude Code — Детальная настройка Claude Code
• MCP клиенты — Другие интеграции MCP клиентов