Интеграция MCP клиентов
Moira работает с любым клиентом, поддерживающим Model Context Protocol (MCP). Это руководство описывает настройку распространённых MCP-клиентов.
Обзор протокола MCP
Moira предоставляет инструменты через MCP Streamable HTTP:
- Endpoint:
https://moira-mcp.com/mcp - Транспорт: Streamable HTTP; успешные ответы могут передаваться потоком SSE
- Аутентификация: OAuth 2.1 или API-токен
Конфигурация клиентов
Выполните команду в своём проекте. По умолчанию подключение доступно только вам в этом проекте; добавьте --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-клиентов используйте MCP SDK с URL: https://moira-mcp.com/mcp
Доступные инструменты
Используйте workflow с action: "list", затем execution с действиями prepare, execute и повторными step. Та же группа execution служит для
просмотра и возобновления выполнений, а help — для runtime-документации.
Справочник MCP-инструментов является источником полного
актуального каталога, точных входных схем, действий и примеров.
Аутентификация
Moira поддерживает два метода аутентификации:
OAuth 2.1 (по умолчанию)
- Клиент подключается к MCP endpoint.
- Сервер запрашивает аутентификацию.
- Клиент открывает OAuth в браузере.
- Пользователь входит в Moira.
- Клиент получает токен доступа.
- Последующие запросы передают этот токен.
Обновление OAuth-токена обрабатывается автоматически и сохраняет состояние каталога, принятое предыдущим токеном доступа. Обновление каталога после изменения серверного контракта — отдельная MCP-инициализация, описанная ниже. При истечении учётных данных может потребоваться повторная аутентификация.
API-токены
Для MCP-клиентов, которые не поддерживают OAuth (пользовательские скрипты, CI/CD пайплайны, headless-окружения), используйте API-токены:
- Войдите в веб-интерфейс Moira.
- Откройте Настройки → Приложения и токены → API-токены.
- Выберите Create Token, задайте имя и срок действия.
- Скопируйте токен: он показывается один раз и начинается с
moira_. - Настройте Bearer-авторизацию клиента; токен не должен попадать в Git или логи.
Используйте пример токена выбранного клиента выше. JSON-, YAML- и TOML-клиенты размещают
авторизацию по-разному; не копируйте формат другого клиента. В собственном SDK-клиенте задайте
Authorization: Bearer moira_... в HTTP-транспорте для https://moira-mcp.com/mcp.
API-токены полностью обходят OAuth. Используйте выбранный endpoint https://moira-mcp.com/mcp и сохраняйте
другие серверы при объединении конфигурации с токеном. Уже работающее подключение не требует
нового токена или входа.
Обновление статического каталога
Описания и схемы инструментов входят в статический каталог, поставляемый с сервером Moira. Клиент
принимает этот каталог во время MCP-handshake initialize. Это правило одинаково для OAuth-токенов
доступа и API-токенов.
После изменения каталога обычный запрос с учётными данными, которые ещё не инициализировали текущий
каталог, получает HTTP 426 с upgrade_required. Переподключите или повторно инициализируйте MCP-сервер
с теми же учётными данными. Успешный initialize обновляет каталог для этих учётных данных; создавать
новый API-токен не требуется. OAuth-токены доступа могут независимо заменяться при автоматическом
обновлении, сохраняя актуальное, устаревшее или ещё не инициализированное состояние каталога.
Клиент может сначала отправить server/discover. После проверки авторизации этот запрос
достигает SDK до принятия каталога. SDK Moira обслуживает прежний протокол и возвращает ответ
о неподдерживаемом методе или версии, чтобы совместимый клиент перешёл к initialize.
Само обнаружение не принимает каталог и не разрешает вызовы инструментов. Поддержка stateless-протокола
2026 года этим не объявляется.
Проверки аутентификации и состояния учётной записи выполняются до обновления каталога. Отозванные или истёкшие учётные данные и учётная запись без доступа к MCP по-прежнему получают обычную ошибку аутентификации или доступа.
Примеры вызова инструментов
Список воркфлоу
{ "method": "tools/call", "params": { "name": "workflow", "arguments": { "action": "list" } }}Подготовка запуска воркфлоу
{ "method": "tools/call", "params": { "name": "execution", "arguments": { "action": "prepare", "workflowId": "moira/software-development-flow", "parentExecutionId": "none" } }}Подготовка возвращает startAttemptId, не создавая execution. Выполните его вторым вызовом:
{ "method": "tools/call", "params": { "name": "execution", "arguments": { "action": "execute", "startAttemptId": "start-attempt-current" } }}Выполнение шага
{ "method": "tools/call", "params": { "name": "execution", "arguments": { "action": "step", "processId": "abc-123", "attemptId": "attempt-current", "input": { "result": "Задача выполнена успешно", "details": { "files": ["main.ts", "utils.ts"] } } } }}Обработка ошибок
Типичные ответы об ошибках:
| Ошибка | Причина | Решение |
|---|---|---|
UNAUTHORIZED | Недействительный/истекший токен | Повторная аутентификация |
NOT_FOUND | Недействительный ID воркфлоу/процесса | Проверьте ID |
FORBIDDEN | Нет доступа к ресурсу | Проверьте права |
upgrade_required | Требуется обновить каталог MCP | Переподключитесь с теми же учётными данными |
VALIDATION_ERROR | Недействительный ввод | Проверьте input schema |
ATTEMPT_PROCESSING | Дубликат ещё выполняется | Повторите ту же попытку и ввод |
ATTEMPT_STALE | Предъявление больше не текущее | Прочитайте current_step; согласуйте намерение до отправки |
ATTEMPT_CONFLICT | Попытка связана с другим вводом | Прочитайте current_step; отбросьте старый ввод |
ATTEMPT_INVALID_OR_EXPIRED (шаг) | Попытка недоступна | Прочитайте current_step; отбросьте попытку |
ATTEMPT_OUTCOME_UNKNOWN | Эффект мог уже произойти | Найдите возвращённый Process ID |
Настройка self-hosted
Полные различия восстановления приведены в Решении проблем. Новое предъявление не разрешает переносить старый ответ в другой шаг; неизвестный исход читается, а не повторяется автоматически.
Для self-hosted Moira:
- Разверните сервер Moira
- Настройте URL MCP endpoint
- Настройте аутентификацию и доступ учётной записи
- Обновите конфигурацию клиента с вашим endpoint
Устранение неполадок
Таймаут подключения
- Проверьте сетевое подключение
- Проверьте URL endpoint
- Убедитесь, что SSE не блокируется файрволом
Инструменты не появляются
- Переподключите MCP-сервер Moira, чтобы клиент снова выполнил
initialize - Сохраните текущий OAuth- или API-токен, если он не отозван и не истёк
- Проверьте формат конфигурации и диагностику выбранного клиента по его официальной инструкции выше
- Проверьте логи клиента на наличие ошибок
Цикл аутентификации
- Проверьте выбранный URL сервера, аккаунт и состояние клиента до изменения учётных данных
- Отличайте отказ авторизации от HTTP 426: последний требует инициализации с теми же учётными данными
- Изучите диагностику клиента и официальную инструкцию OAuth, включая требования к redirect
- Повторяйте вход, только если текущие учётные данные недействительны или истекли и refresh не восстанавливает доступ; не очищайте другие подключения
Связанное
- Claude Code — Специфичная настройка Claude Code
- Быстрый старт — Общее начало работы