Перейти к содержимому

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

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

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

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

Настройка

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

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

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

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

Выполните команду в своём проекте. По умолчанию подключение доступно только вам в этом проекте; добавьте --scope user для всех проектов. Ручная альтернатива .mcp.json ниже действует на уровне проекта; перед включением проверьте доверие. Объединяйте записи с существующим файлом, сохраняя другие серверы.

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

Если нужна авторизация, следуйте приглашению в браузере или выполните команду входа. Для удалённого терминала claude mcp login moira --no-browser печатает ссылку. Не повторяйте вход для уже работающего подключения.

Terminal
claude mcp login moira
Ручная настройка
.mcp.json
{
  "mcpServers": {
    "moira": {
      "type": "http",
      "url": "https://moira-mcp.com/mcp"
    }
  }
}
Альтернатива: API-токен

Используйте статический API-токен, если выбираете этот способ вместо OAuth через браузер. Храните токен в секрете.

Войдите в Moira → Настройки → API Токены и создайте токен. Замените moira_YOUR_TOKEN ниже на этот токен. Объедините альтернативу с конфигурацией клиента, не добавляя вторую запись Moira.

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

Выполните claude mcp list или откройте /mcp в Claude Code и проверьте подключение Moira и её инструменты. Затем попросите агента вызвать инструмент Moira list, который только читает данные, и показать доступные процессы. Сохранённая конфигурация сама по себе не подтверждает подключение.

Официальная документация клиента
  1. Авторизуйте MCP сервер

    Проверьте состояние подключения по инструкции выбранного клиента выше. Если Moira уже работает, сохраните это подключение. Иначе завершите поддерживаемый клиентом вход: браузерный OAuth, если он предложен, либо настройку API-токена в его родном формате. Сохранение конфигурации само по себе не подтверждает авторизацию.

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

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

    1. Войдите в веб-интерфейс Moira → Настройки → Приложения и токены → API-токены
    2. Создайте токен и скопируйте его (начинается с moira_)
    3. Используйте пример токена выбранного клиента выше: расположение заголовка зависит от клиента, а Codex ссылается на переменную окружения. Не сохраняйте токен в Git или логах.

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

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

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

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

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

  3. Запустите первый флоу

    Попросите агента обычными словами запустить первый учебный пример на любой небольшой задаче:

    Запусти в Moira Пример 1: Простые шаги для этой задачи: переименуй файл notes.txt в todo.txt

    Агент запускает moira/example-simple-steps-ru и проходит четыре шага — понять задачу, выполнить её, проверить результат, отчитаться — по одному; Moira выдаёт ему каждый шаг и проверяет ответ перед следующим. Откройте Воркфлоу в веб-приложении и выберите пример, чтобы увидеть те же шаги простой схемой.

    Дальше называть флоу вообще не обязательно. Опишите, что нужно, и агент сам выберет готовый флоу или соберёт новый под задачу. Туториал проходит все три учебных примера; Какой готовый флоу выбрать рассказывает о повседневных.

    Нужна экскурсия по каталогу?

    Скажите Запусти воркфлоу "user-onboarding" в Moira. Интерактивный онбординг читает текущий доступный вам публичный каталог, объясняет, чем флоу различаются, фиксирует один точный воркфлоу, например moira/test-planning, и запускает его, только если вы так решите; отсрочка ничего не меняет.

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

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

ИнструментОписание
workflow (list)Получить доступные воркфлоу с пагинацией
execution (prepare, execute)Подготовить или выполнить отдельный либо дочерний запуск
execution (step)Отправить проверенный результат шага и получить новую директиву
executionПросмотреть и возобновить выполнение воркфлоу
helpПолучить документацию и справку Moira

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

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

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

Агент: Запускаю полный воркфлоу разработки.
[вызывает execution с action: "prepare",
workflowId: "moira/software-development-flow", parentExecutionId: "none"]
Moira: Start attempt ID: aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa
Агент: [вызывает execution с action: "execute" и именно этим startAttemptId;
при потере ответа повторяет execute, а не готовит новый запуск]
Moira: Process ID: 123e4567-e89b-42d3-a456-426614174000
Step attempt ID: 11111111-1111-4111-8111-111111111111
Ваша следующая задача: Проанализировать документ требований...
Критерий успеха: Требования задокументированы...
Агент: [анализирует требования, создает вывод]
[вызывает execution с action: "step" с точными Process ID, текущим Step attempt ID
и данными по входной схеме]
Moira: Process ID: 123e4567-e89b-42d3-a456-426614174000
Step attempt ID: 22222222-2222-4222-8222-222222222222
Ваша следующая задача: Создать план реализации...
Критерий успеха: План охватывает все требования...
[... воркфлоу продолжается до завершения]

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