Быстрый старт
Это руководство поможет подключить Moira к вашему AI-клиенту и запустить первый воркфлоу.
Предварительные требования
- MCP-совместимый AI-клиент (см. поддерживаемые клиенты ниже)
- Аккаунт Moira (регистрация на Moira)
Настройка
-
Получите MCP endpoint
Для Moira Cloud:
https://moira-mcp.com/mcpДля self-hosted используйте endpoint вашего сервера.
-
Настройте AI-клиент
Выполните команду в своём проекте. По умолчанию подключение доступно только вам в этом проекте; добавьте --scope user для всех проектов. Ручная альтернатива .mcp.json ниже действует на уровне проекта; перед включением проверьте доверие. Объединяйте записи с существующим файлом, сохраняя другие серверы.
claude mcp add --transport http moira 'https://moira-mcp.com/mcp'Если нужна авторизация, следуйте приглашению в браузере или выполните команду входа. Для удалённого терминала claude mcp login moira --no-browser печатает ссылку. Не повторяйте вход для уже работающего подключения.
claude mcp login moiraРучная настройка
{
"mcpServers": {
"moira": {
"type": "http",
"url": "https://moira-mcp.com/mcp"
}
}
}Альтернатива: API-токен
Используйте статический API-токен, если выбираете этот способ вместо OAuth через браузер. Храните токен в секрете.
Войдите в Moira → Настройки → API Токены и создайте токен. Замените moira_YOUR_TOKEN ниже на этот токен. Объедините альтернативу с конфигурацией клиента, не добавляя вторую запись Moira.
{
"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, который только читает данные, и показать доступные процессы. Сохранённая конфигурация сама по себе не подтверждает подключение.
Официальная документация клиентаВыполните команду добавления HTTP-сервера. Пользовательская конфигурация хранится в ~/.copilot/mcp-config.json. Переносимые проектные файлы — .mcp.json или .github/mcp.json; они используют mcpServers, а не формат servers из VS Code. Ручной пример разрешает все инструменты сервера через tools: ["*"]; при необходимости сократите список. Политика организации может ограничивать серверы и инструменты.
copilot mcp add --transport http moira 'https://moira-mcp.com/mcp'В сессии Copilot CLI при необходимости выполните команду авторизации и завершите вход в браузере.
/mcp auth moiraРучная настройка
{
"mcpServers": {
"moira": {
"type": "http",
"url": "https://moira-mcp.com/mcp",
"tools": [
"*"
]
}
}
}Альтернатива: API-токен
Используйте статический API-токен, если выбираете этот способ вместо OAuth через браузер. Храните токен в секрете.
Войдите в Moira → Настройки → API Токены и создайте токен. Замените moira_YOUR_TOKEN ниже на этот токен. Объедините альтернативу с конфигурацией клиента, не добавляя вторую запись Moira.
{
"mcpServers": {
"moira": {
"type": "http",
"url": "https://moira-mcp.com/mcp",
"tools": [
"*"
],
"headers": {
"Authorization": "Bearer moira_YOUR_TOKEN"
}
}
}
}Откройте /mcp show moira для проверки состояния и инструментов или выполните copilot mcp list в терминале. Затем попросите агента вызвать инструмент Moira list, который только читает данные, и показать доступные процессы. Сохранённая конфигурация сама по себе не подтверждает подключение.
Официальная документация клиентаНажмите кнопку установки и проверьте запрос Cursor либо добавьте ручную конфигурацию в ~/.cursor/mcp.json для своего пользователя или .cursor/mcp.json для проекта. После ручной настройки перезапустите Cursor. Настройка локального редактора не настраивает Cloud Agents автоматически.
Добавить в CursorОткройте Customize → MCPs и при необходимости завершите авторизацию HTTP-сервера. Конфигурация с токеном ниже — альтернатива входу OAuth через браузер.
Ручная настройка
{
"mcpServers": {
"moira": {
"url": "https://moira-mcp.com/mcp"
}
}
}Альтернатива: API-токен
Используйте статический API-токен, если выбираете этот способ вместо OAuth через браузер. Храните токен в секрете.
Войдите в Moira → Настройки → API Токены и создайте токен. Замените moira_YOUR_TOKEN ниже на этот токен. Объедините альтернативу с конфигурацией клиента, не добавляя вторую запись Moira.
{
"mcpServers": {
"moira": {
"url": "https://moira-mcp.com/mcp",
"headers": {
"Authorization": "Bearer moira_YOUR_TOKEN"
}
}
}
}Проверьте Moira в Customize → MCPs и в списке инструментов чата. Если её нет, откройте Output → MCP Logs. Затем попросите агента вызвать инструмент Moira list, который только читает данные, и показать доступные процессы. Сохранённая конфигурация сама по себе не подтверждает подключение.
Официальная документация клиентаОткройте Customize → Connectors → + Add → Add custom connector. Введите имя Moira и URL сервера ниже, затем Continue, проверьте авторизацию и нажмите Add. Это удалённый коннектор аккаунта, общий с Claude Web. Его HTTPS-адрес должен быть доступен из облака Claude. В организации сначала может потребоваться добавление владельцем; тариф Free поддерживает один пользовательский коннектор.
https://moira-mcp.com/mcpВыберите вход и при запросе завершите OAuth в браузере. Участнику организации сначала может потребоваться подключить коннектор, добавленный владельцем.
В разговоре откройте + → Connectors и включите Moira. Затем попросите агента вызвать инструмент Moira list, который только читает данные, и показать доступные процессы. Сохранённая конфигурация сама по себе не подтверждает подключение.
Официальная документация клиентаНажмите кнопку установки и проверьте запрос либо объедините ручную запись servers с .vscode/mcp.json. Для настройки на уровне пользователя откройте пользовательскую MCP-конфигурацию командой VS Code. Примеры настраивают встроенную интеграцию VS Code, а не отдельного терминального агента.
Добавить в VS CodeПроверьте запрос доверия рабочей области и серверу, затем при необходимости завершите вход в браузере. Конфигурация с токеном ниже — отдельная альтернатива авторизации.
Ручная настройка
{
"servers": {
"moira": {
"type": "http",
"url": "https://moira-mcp.com/mcp"
}
}
}Альтернатива: API-токен
Используйте статический API-токен, если выбираете этот способ вместо OAuth через браузер. Храните токен в секрете.
Войдите в Moira → Настройки → API Токены и создайте токен. Замените moira_YOUR_TOKEN ниже на этот токен. Объедините альтернативу с конфигурацией клиента, не добавляя вторую запись Moira.
{
"servers": {
"moira": {
"type": "http",
"url": "https://moira-mcp.com/mcp",
"headers": {
"Authorization": "Bearer moira_YOUR_TOKEN"
}
}
}
}Выполните MCP: List Servers, выберите Moira, затем Start Server или Show Output. Проверьте обнаружение инструментов и включение сервера для выбранного агента. Затем попросите агента вызвать инструмент Moira list, который только читает данные, и показать доступные процессы. Сохранённая конфигурация сама по себе не подтверждает подключение.
Официальная документация клиентаНа claude.ai откройте Customize → Connectors → + Add → Add custom connector. Введите имя Moira и URL сервера ниже, затем Continue, проверьте авторизацию и нажмите Add. HTTPS-адрес должен быть доступен из облака Claude. Тариф Free поддерживает один пользовательский коннектор; также действуют политики организации и настройка владельцем.
https://moira-mcp.com/mcpВыберите вход и при запросе завершите OAuth в браузере. Участники организации подключают коннектор, предоставленный владельцем.
В разговоре откройте + → Connectors и включите Moira. Затем попросите агента вызвать инструмент Moira list, который только читает данные, и показать доступные процессы. Сохранённая конфигурация сама по себе не подтверждает подключение.
Официальная документация клиентаОткройте https://chatgpt.com/plugins. Выберите плюс → Add custom MCP server, укажите имя и URL сервера ниже, выберите авторизацию, проверьте предупреждение и нажмите Create as a plugin. Отдельно установите созданный плагин. HTTPS-адрес должен быть доступен из облака ChatGPT; права рабочей области и политики безопасности могут ограничивать пользовательские серверы.
https://moira-mcp.com/mcpВыберите OAuth для Moira с авторизацией и при запросе завершите вход.
Выберите установленный плагин Moira через @ в разговоре и явно попросите вызвать его инструмент. Затем попросите агента вызвать инструмент Moira list, который только читает данные, и показать доступные процессы. Сохранённая конфигурация сама по себе не подтверждает подключение.
Официальная документация клиентаОткройте Plugins или Customize → Connectors во время обновления интерфейса. Выберите Add custom → Connector → Add MCP connector → Remote, введите HTTPS URL сервера ниже, выберите Streamable HTTP и нажмите Add. Удалённые коннекторы доступны на поддерживаемых тарифах Pro, Max и Enterprise; также могут действовать права организации. Для этого удалённого подключения не нужен Mac helper.
https://moira-mcp.com/mcpВыберите OAuth, затем откройте созданную карточку коннектора для авторизации и включения. Адрес должен быть доступен из облака Perplexity.
Убедитесь, что коннектор включён и доступен в текущем разговоре. Затем попросите агента вызвать инструмент Moira list, который только читает данные, и показать доступные процессы. Сохранённая конфигурация сама по себе не подтверждает подключение.
Официальная документация клиентаОбъедините этот фрагмент с активной YAML-конфигурацией Continue, обычно ~/.continue/config.yaml. Сохраните существующие настройки и серверы. Отдельный блок .continue/mcpServers/moira.yaml дополнительно требует метаданные name, version и schema; здесь приведён фрагмент активной конфигурации, а не полный отдельный блок.
mcpServers:
- name: moira
type: streamable-http
url: "https://moira-mcp.com/mcp"
requestOptions:
headers:
Authorization: "Bearer moira_YOUR_TOKEN"Используйте документированный вход по токену: войдите в Moira → Настройки → API Токены, создайте токен и замените moira_YOUR_TOKEN в конфигурации. Authorization размещается в requestOptions.headers. Не предполагайте поддержку браузерного OAuth для произвольного удалённого сервера в Continue.
Переключитесь в Agent mode и убедитесь, что агент может использовать настроенные инструменты Moira. Затем попросите агента вызвать инструмент Moira list, который только читает данные, и показать доступные процессы. Сохранённая конфигурация сама по себе не подтверждает подключение.
Официальная документация клиентаОткройте Settings → AI → MCP Servers → Add Server → Add Remote Server и введите адрес выбранного сервера либо объедините запись context_servers ниже с ~/.config/zed/settings.json. Сохраните другие настройки и серверы.
{
"context_servers": {
"moira": {
"url": "https://moira-mcp.com/mcp"
}
}
}Без заголовка Authorization при необходимости следуйте приглашению MCP OAuth в Zed. Статический Authorization — альтернативный вариант с токеном ниже.
Альтернатива: API-токен
Используйте статический API-токен, если выбираете этот способ вместо OAuth через браузер. Храните токен в секрете.
Войдите в Moira → Настройки → API Токены и создайте токен. Замените moira_YOUR_TOKEN ниже на этот токен. Объедините альтернативу с конфигурацией клиента, не добавляя вторую запись Moira.
{
"context_servers": {
"moira": {
"url": "https://moira-mcp.com/mcp",
"headers": {
"Authorization": "Bearer moira_YOUR_TOKEN"
}
}
}
}Проверьте зелёную точку и подсказку Server is active, затем используйте Zed Agent. Терминальные агенты используют свои конфигурации CLI; передача серверов другому агенту может настраиваться отдельно. Затем попросите агента вызвать инструмент Moira list, который только читает данные, и показать доступные процессы. Сохранённая конфигурация сама по себе не подтверждает подключение.
Официальная документация клиентаВыполните команду в проекте; добавьте --scope user для всех проектов. Ручную альтернативу можно объединить с .gemini/settings.json или ~/.gemini/settings.json. Для Streamable HTTP используется httpUrl: поле url в Gemini выбирает устаревший SSE.
gemini mcp add --transport http moira 'https://moira-mcp.com/mcp'В сессии Gemini CLI при необходимости выполните команду авторизации и завершите OAuth в браузере. Если браузерный callback недоступен, используйте альтернативу с токеном.
/mcp auth moiraРучная настройка
{
"mcpServers": {
"moira": {
"httpUrl": "https://moira-mcp.com/mcp"
}
}
}Альтернатива: API-токен
Используйте статический API-токен, если выбираете этот способ вместо OAuth через браузер. Храните токен в секрете.
Войдите в Moira → Настройки → API Токены и создайте токен. Замените moira_YOUR_TOKEN ниже на этот токен. Объедините альтернативу с конфигурацией клиента, не добавляя вторую запись Moira.
{
"mcpServers": {
"moira": {
"httpUrl": "https://moira-mcp.com/mcp",
"headers": {
"Authorization": "Bearer moira_YOUR_TOKEN"
}
}
}
}Выполните gemini mcp list в терминале или /mcp list в сессии для проверки состояния подключения и ошибок. Затем попросите агента вызвать инструмент Moira list, который только читает данные, и показать доступные процессы. Сохранённая конфигурация сама по себе не подтверждает подключение.
Официальная документация клиентаВыполните команду регистрации HTTP-сервера или объедините TOML-альтернативу с ~/.codex/config.toml. Для уровня проекта используется .codex/config.toml в доверенном проекте. Конфигурация общая для локальных Codex CLI, приложения и IDE; не предполагайте, что её получает каждый удалённый или облачный исполнитель.
codex mcp add moira --url 'https://moira-mcp.com/mcp'Если предложена авторизация, следуйте приглашению. Если сервер ещё требует входа, выполните codex mcp login moira и завершите вход в браузере. Уже авторизованное подключение не требует повторного входа.
codex mcp login moiraРучная настройка
[mcp_servers.moira]
url = "https://moira-mcp.com/mcp"Альтернатива: API-токен
Используйте статический API-токен, если выбираете этот способ вместо OAuth через браузер. Храните токен в секрете.
Создайте токен в Moira → Настройки → API Токены. Задайте MOIRA_API_TOKEN в окружении процесса, запускающего Codex. Поле TOML ниже содержит имя переменной окружения, а не сам токен.
[mcp_servers.moira]
url = "https://moira-mcp.com/mcp"
bearer_token_env_var = "MOIRA_API_TOKEN"Выполните codex mcp list и откройте /mcp в активной сессии Codex для проверки состояния Moira и доступных инструментов. Затем попросите агента вызвать инструмент Moira list, который только читает данные, и показать доступные процессы. Сохранённая конфигурация сама по себе не подтверждает подключение.
Официальная документация клиентаОбъедините прямую конфигурацию ниже с ~/.kimi-code/mcp.json или .kimi-code/mcp.json для проекта, затем выполните перезагрузку или начните новую сессию. Прямая конфигурация использует выбранный здесь сервер. Проектная конфигурация требует доверия рабочей области; фоновый запуск не может ответить на этот запрос за вас.
{
"mcpServers": {
"moira": {
"url": "https://moira-mcp.com/mcp"
}
}
}В Kimi Code при необходимости выполните /mcp-config login moira и завершите вход. Конфигурация с токеном — альтернативный вариант.
/mcp-config login moiraНеобязательно: плагин для hosted Moira
Этот плагин подключается к фиксированному адресу https://moira-mcp.com/mcp, а не к выбранному вами собственному серверу. Для своего сервера используйте прямую конфигурацию выше. Установите плагин из дерева репозитория ниже, затем выполните /reload или начните новую сессию.
/plugins install https://github.com/moira-mcp/moira/tree/master
/reloadАльтернатива: API-токен
Используйте статический API-токен, если выбираете этот способ вместо OAuth через браузер. Храните токен в секрете.
Войдите в Moira → Настройки → API Токены и создайте токен. Замените moira_YOUR_TOKEN ниже на этот токен. Объедините альтернативу с конфигурацией клиента, не добавляя вторую запись Moira.
{
"mcpServers": {
"moira": {
"url": "https://moira-mcp.com/mcp",
"headers": {
"Authorization": "Bearer moira_YOUR_TOKEN"
}
}
}
}Используйте /mcp для проверки фактического состояния сервера. При использовании необязательного hosted-плагина команда /plugins info moira показывает сведения об установке. Затем попросите агента вызвать инструмент Moira list, который только читает данные, и показать доступные процессы. Сохранённая конфигурация сама по себе не подтверждает подключение.
Официальная документация клиента-
Авторизуйте MCP сервер
Проверьте состояние подключения по инструкции выбранного клиента выше. Если Moira уже работает, сохраните это подключение. Иначе завершите поддерживаемый клиентом вход: браузерный OAuth, если он предложен, либо настройку API-токена в его родном формате. Сохранение конфигурации само по себе не подтверждает авторизацию.
OAuth не поддерживается?
Если ваш клиент не может открыть браузер для OAuth, создайте API-токен:
- Войдите в веб-интерфейс Moira → Настройки → Приложения и токены → API-токены
- Создайте токен и скопируйте его (начинается с
moira_) - Используйте пример токена выбранного клиента выше: расположение заголовка зависит от клиента, а Codex ссылается на переменную окружения. Не сохраняйте токен в Git или логах.
Подробнее: MCP клиенты → API-токены
-
Проверьте подключение
Попросите AI-клиент вывести список воркфлоу Moira:
Покажи доступные воркфлоу MoiraВы должны увидеть список доступных воркфлоу.
-
Запустите первый флоу
Попросите агента обычными словами запустить первый учебный пример на любой небольшой задаче:
Запусти в 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 Ваша следующая задача: Создать план реализации... Критерий успеха: План охватывает все требования...
[... воркфлоу продолжается до завершения]Следующие шаги
- Туториал: первые флоу — Три крошечных учебных флоу
- Какой готовый флоу выбрать — Повседневные задачи без сборки флоу
- Воркфлоу — Понимание структуры воркфлоу
- Интеграция с Claude Code — Детальная настройка Claude Code
- MCP клиенты — Другие интеграции MCP клиентов