Перейти к содержимому

Интеграция с Claude Code

Claude Code — официальный CLI и расширение VS Code для Claude от Anthropic. Это руководство описывает интеграцию Moira с Claude Code.

  • Установленный и настроенный Claude Code
  • Доступ к серверу Moira (облако или self-hosted)
  • Действующие учетные данные Moira
  1. Откройте настройки Claude Code

    В VS Code откройте Command Palette и выполните:

    Claude Code: Open Settings

    Или отредактируйте напрямую:

    • Директория~/.claude/
      • settings.json
  2. Добавьте MCP сервер Moira

    Добавьте в settings.json с URL: https://moiraqq.com/mcp

  3. Перезапустите Claude Code

    Перезагрузите окно или перезапустите VS Code для применения изменений.

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

    При первом использовании инструментов Moira вам будет предложено аутентифицироваться. Следуйте OAuth-потоку в браузере.

Проверьте подключение, попросив Claude:

Покажи доступные воркфлоу Moira

Вы должны увидеть список ваших воркфлоу.

Запусти воркфлоу "development-flow" в Moira

Claude:

  1. Вызовет start_workflow с ID воркфлоу
  2. Получит директиву первого шага
  3. Выполнит директиву
  4. Отправит результаты через execute_step
  5. Продолжит до завершения воркфлоу

Если сессия была прервана, продолжите с:

Продолжи мой воркфлоу Moira с process ID abc-123
Покажи документацию Moira по узлам

Claude вызовет get_help с темой.

Для воркфлоу, специфичных для проекта, добавьте в CLAUDE.md:

## Воркфлоу Moira
Этот проект использует Moira для воркфлоу разработки.
### Доступные воркфлоу
- `dev-flow` - Основной воркфлоу разработки
- `review-flow` - Воркфлоу код-ревью
### Начало разработки
Чтобы начать задачу, запустите воркфлоу разработки:
1. Запустите воркфлоу `dev-flow`
2. Следуйте каждой директиве шага
3. Отправьте результаты перед переходом к следующему шагу

После подключения доступны эти инструменты:

ИнструментОписание
list_workflowsСписок доступных воркфлоу
start_workflowЗапуск воркфлоу, возврат первой директивы
execute_stepОтправка результата, получение следующей директивы
get_helpПолучение документации
manage_settingsУправление пользовательскими настройками
get_session_infoИнформация о сессии и выполнениях
  1. Проверьте правильность URL MCP сервера
  2. Проверьте сетевое подключение
  3. Убедитесь в действительности аутентификации
  4. Проверьте логи Claude Code на наличие ошибок
  1. Проверьте существование ID воркфлоу: list_workflows
  2. Проверьте права доступа к воркфлоу
  3. Убедитесь, что у вас есть доступ к воркфлоу

Если process ID потерян:

  1. Проверьте get_session_info для активных выполнений
  2. Возобновите с правильным process ID
  3. Рассмотрите добавление process ID в CLAUDE.md для сохранения
  1. Сохраняйте Process ID — Храните в CLAUDE.md для непрерывности сессии
  2. Следуйте директивам — Выполняйте именно то, что говорит директива
  3. Выполняйте условия завершения — Проверяйте перед отправкой
  4. Проверяйте помощь — Используйте get_help при неуверенности