Интеграция MCP клиентов

Moira работает с любым клиентом, поддерживающим Model Context Protocol (MCP). Это руководство описывает настройку для 11 популярных MCP-клиентов.

Обзор протокола MCP

Moira предоставляет инструменты через MCP поверх HTTP/SSE:

Endpoint: https://moira.witqq.ru/mcp
Транспорт: HTTP со streaming через SSE
Аутентификация: OAuth 2.0 или API-токен

Конфигурация клиентов

Рекомендуется: используйте 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-клиентов используйте MCP SDK с URL: https://moira.witqq.ru/mcp

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

Все MCP-клиенты имеют доступ к этим инструментам:

Управление воркфлоу

Инструмент	Параметры	Описание
`list_workflows`	-	Список доступных воркфлоу
`start_workflow`	`workflowId`	Запуск выполнения воркфлоу
`execute_step`	`processId`, `input`	Отправка результата шага

Управление сессией

Инструмент	Параметры	Описание
`get_session_info`	`action`	Информация о сессии/выполнении
`get_execution_context`	`executionId`	Контекст выполнения

Помощь и настройки

Инструмент	Параметры	Описание
`get_help`	`topic` (опционально)	Документация
`manage_settings`	`action`, `key`, `value`	Управление настройками

Аутентификация

Moira поддерживает два метода аутентификации:

OAuth 2.0 (по умолчанию)

Клиент инициирует подключение к MCP endpoint 2. Сервер возвращает ответ о необходимости аутентификации 3. Клиент открывает браузер для OAuth-потока 4. Пользователь аутентифицируется в Moira 5. Клиент получает токен доступа 6. Последующие запросы включают токен

API-токены

Для MCP-клиентов, которые не поддерживают OAuth (пользовательские скрипты, CI/CD пайплайны, headless-окружения), используйте API-токены:

Войдите в веб-интерфейс Moira 2. Перейдите в Settings → API Tokens 3. Нажмите Create Token, введите имя и срок действия 4. Скопируйте токен (показывается один раз, начинается с moira_) 5. Настройте клиент с токеном в качестве Bearer-авторизации

Пример конфигурации для пользовательского MCP-клиента:

{
  "mcpServers": {
    "moira": {
      "url": "YOUR_MCP_ENDPOINT",
      "headers": {
        "Authorization": "Bearer moira_your_token_here"
      }
    }
  }
}

Примеры вызова инструментов

Список воркфлоу

{
  "method": "tools/call",
  "params": {
    "name": "list_workflows",
    "arguments": {}
  }
}

Запуск воркфлоу

{
  "method": "tools/call",
  "params": {
    "name": "start_workflow",
    "arguments": {
      "workflowId": "development-flow"
    }
  }
}

Выполнение шага

{
  "method": "tools/call",
  "params": {
    "name": "execute_step",
    "arguments": {
      "processId": "abc-123",
      "input": {
        "result": "Задача выполнена успешно",
        "details": { "files": ["main.ts", "utils.ts"] }
      }
    }
  }
}

Обработка ошибок

Типичные ответы об ошибках:

Ошибка	Причина	Решение
`UNAUTHORIZED`	Недействительный/истекший токен	Повторная аутентификация
`NOT_FOUND`	Недействительный ID воркфлоу/процесса	Проверьте ID
`FORBIDDEN`	Нет доступа к ресурсу	Проверьте права
`VALIDATION_ERROR`	Недействительный ввод	Проверьте input schema

Настройка self-hosted

Для self-hosted Moira:

Разверните сервер Moira
Настройте URL MCP endpoint
Настройте аутентификацию (опционально)
Обновите конфигурацию клиента с вашим endpoint

{
  "mcpServers": {
    "moira": {
      "url": "https://your-server.com/mcp",
      "transport": "sse"
    }
  }
}

Устранение неполадок

Таймаут подключения

Проверьте сетевое подключение
Проверьте URL endpoint
Убедитесь, что SSE не блокируется файрволом

Инструменты не появляются

Перезапустите клиент после настройки
Проверьте синтаксис JSON в конфигурации
Проверьте логи клиента на наличие ошибок

Цикл аутентификации

Очистите сохраненные токены
Проверьте конфигурацию OAuth
Проверьте redirect URI

Связанное

Claude Code — Специфичная настройка Claude Code
Быстрый старт — Общее начало работы