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

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

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

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

Endpoint: https://moiraqq.com/mcp
Транспорт: HTTP со streaming через SSE
Аутентификация: OAuth 2.0

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

Настройка Claude Web (claude.ai)

Требуется план Pro, Max, Team или Enterprise.

Перейдите в Settings → Connectors
Нажмите “Add custom connector”
Введите Server URL: https://moiraqq.com/mcp
Нажмите “Connect”
Завершите OAuth-аутентификацию в браузере

Инструменты появятся в чате после аутентификации.

Настройка ChatGPT (chat.openai.com)

Требуется план Plus или Pro.

Перейдите в Profile → Settings
Найдите раздел “Connectors” или “Integrations”
Нажмите “Add connector”
Введите Name: MCP Moira, URL: https://moiraqq.com/mcp
Завершите OAuth-аутентификацию

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

Десктопные и CLI клиенты

Настройка Claude Code

Рекомендуется: CLI команда

Выполните: claude mcp add --transport http moira https://moiraqq.com/mcp

Затем аутентификация:

/mcp
# → Выберите "moira"
# → Нажмите "Authenticate"
# → Браузер откроется для OAuth

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

Отредактируйте ~/.config/claude/mcp.json с URL: https://moiraqq.com/mcp

Настройка Claude Desktop

Откройте Settings (⌘+,)
Перейдите на вкладку “Connectors”
Нажмите “Add custom connector”
Введите Server URL: https://moiraqq.com/mcp
Нажмите “Connect”
Браузер откроется → OAuth → Готово

Редактирование файлов не требуется.

Настройка Gemini CLI (Экспериментальный)

Отредактируйте ~/.gemini/settings.json с URL: https://moiraqq.com/mcp

После сохранения выполните gemini auth для OAuth.

Интеграции с IDE

Настройка Cursor

Установка в один клик доступна на главной странице, или ручная настройка:

Откройте настройки Cursor
Перейдите в раздел MCP Servers
Добавьте новый сервер с Name: moira, URL: https://moiraqq.com/mcp
Нажмите “Authenticate” → Браузер откроется для OAuth

Ручная настройка (~/.cursor/mcp.json) с URL: https://moiraqq.com/mcp

Настройка VS Code

Требуется MCP расширение.

Установите MCP расширение: ext install mcp-connector
Добавьте в settings.json с URL: https://moiraqq.com/mcp

Или используйте Command Palette → “MCP: Add Server”.

Настройка Continue

Continue — открытый AI-ассистент для VS Code.

Установите расширение Continue
Откройте конфиг: Ctrl+Shift+P → “Continue: Open config”
Добавьте в config.yaml с URL: https://moiraqq.com/mcp

Перезапустите VS Code и пройдите аутентификацию.

Настройка Zed

Отредактируйте ~/.config/zed/settings.json с URL: https://moiraqq.com/mcp

Перезапустите Zed и пройдите аутентификацию.

Настройка Perplexity (Mac App)

Требуется PerplexityXPC helper.

Settings → Connectors → Install Helper
Нажмите “Add Connector”
Введите Server Name: moira, Command: npx, Args: -y mcp-remote https://moiraqq.com/mcp
Завершите OAuth-аутентификацию

Рекомендуется платный план.

Собственный клиент

Для собственных MCP-клиентов используйте MCP SDK с URL: https://moiraqq.com/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`	Управление настройками

Поток аутентификации

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

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

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

{
  "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
Быстрый старт — Общее начало работы