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

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

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

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

Настройка

Получите MCP endpoint
Для Moira Cloud: https://moira.witqq.ru/mcp
Для self-hosted используйте endpoint вашего сервера.

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

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

Terminal

claude mcp add --transport http moira https://moira.witqq.ru/mcp

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

OAuth Flow

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

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

# Альтернатива: ручная настройка JSON
# ~/.config/claude/mcp.json
{
  "mcpServers": {
    "moira": {
      "type": "http",
      "url": "https://moira.witqq.ru/mcp"
    }
  }
}

# Затем: /mcp → Authenticate

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

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

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

~/.config/claude/mcp.json

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

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

~/.copilot/mcp-config.json

# ~/.copilot/mcp-config.json
{
  "mcpServers": {
    "moira": {
      "type": "http",
      "url": "https://moira.witqq.ru/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.

~/.copilot/mcp-config.json

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

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

Добавить в Cursor

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

OAuth Flow

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

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

~/.cursor/mcp.json

# ~/.cursor/mcp.json
{
  "mcpServers": {
    "moira": {
      "url": "https://moira.witqq.ru/mcp"
    }
  }
}

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

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

~/.cursor/mcp.json

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

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

Settings → Connectors

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

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

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

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

Добавить в VS Code

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

OAuth Flow

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

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

settings.json

# Установите расширение MCP:
# ext install mcp-connector

# Затем в settings.json:
{
  "mcp.servers": {
    "moira": {
      "url": "https://moira.witqq.ru/mcp",
      "transport": "http"
    }
  }
}

# Или: Command Palette → "MCP: Add Server"

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

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

settings.json

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

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

Settings → Connectors

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

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

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

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.witqq.ru/mcp
# 5. Завершите OAuth-аутентификацию
# 6. Инструменты доступны в чате

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

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.witqq.ru/mcp
# 4. Завершите OAuth-аутентификацию
# 5. Попросите Perplexity использовать инструменты MCP Moira

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

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

config.yaml

# Расширение Continue в VS Code:

# 1. Установите расширение Continue
# 2. Откройте конфигурацию: Ctrl+Shift+P → "Continue: Open config"
# 3. Добавьте в config.yaml:
#
# mcp:
#   servers:
#     moira:
#       url: https://moira.witqq.ru/mcp
#       transport: http
#
# 4. Перезапустите VS Code
# 5. Авторизуйтесь по запросу

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

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

config.yaml

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

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

~/.config/zed/settings.json

# Zed editor:

# 1. Откройте Настройки (⌘+,)
# 2. Добавьте в settings.json в context_servers:
#
# "context_servers": {
#   "moira": {
#     "url": "https://moira.witqq.ru/mcp"
#   }
# }
#
# 3. Перезапустите Zed
# 4. Авторизуйтесь

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

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

~/.config/zed/settings.json

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

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

~/.gemini/settings.json

# Gemini CLI:

# 1. Отредактируйте ~/.gemini/settings.json:
#
# "mcpServers": {
#   "moira": {
#     "httpUrl": "https://moira.witqq.ru/mcp"
#   }
# }
#
# 2. Выполните: gemini auth
# 3. Завершите OAuth авторизацию

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

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

~/.gemini/settings.json

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

Авторизуйте MCP сервер
После добавления конфигурации сервера завершите OAuth-аутентификацию. Большинство клиентов запросят авторизацию автоматически или имеют кнопку “Authenticate”.
OAuth не поддерживается?
Если ваш клиент не может открыть браузер для OAuth, создайте API-токен:
1. Войдите в веб-интерфейс Moira → Settings → API Tokens
2. Создайте токен и скопируйте его (начинается с moira_)
3. Добавьте его как Authorization: Bearer moira_... заголовок в конфигурации клиента
Подробнее: MCP клиенты → API-токены
Проверьте подключение
Попросите AI-клиент вывести список воркфлоу Moira:
```
Покажи доступные воркфлоу Moira
```
Вы должны увидеть список доступных воркфлоу.
Начните с онбординга
Теперь просто напишите в чате:
```
Запусти воркфлоу "user-onboarding" в Moira
```
Агент проведет вас через интерактивный онбординг, который:
- Объяснит Moira, демонстрируя воркфлоу в действии
- Покажет ключевые доступные воркфлоу
- Поможет начать работу с первой реальной задачей
Это рекомендуемый способ изучения Moira!

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

После подключения AI-клиент имеет доступ к этим инструментам Moira:

Инструмент	Описание
`list_workflows`	Список доступных воркфлоу
`start_workflow`	Запустить новое выполнение воркфлоу
`execute_step`	Отправить результат шага и получить следующую директиву
`get_help`	Получить документацию и помощь
`manage_settings`	Управление пользовательскими настройками

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

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

Агент: Запускаю воркфлоу разработки.
       [вызывает start_workflow с workflowId: "development-flow"]

Moira: Process ID: abc-123
       Ваша следующая задача: Проанализировать документ требований...
       Критерий успеха: Требования задокументированы...

Агент: [анализирует требования, создает вывод]
       [вызывает execute_step с processId: "abc-123" и результатом]

Moira: Process ID: abc-123
       Ваша следующая задача: Создать план реализации...
       Критерий успеха: План охватывает все требования...

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

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

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