Интеграция с 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

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

   {/* prettier-ignore */}

• ~/.claude/
  • settings.json

2. Добавьте MCP сервер Moira

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

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

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

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

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

   Альтернатива: API-токен

   Если OAuth недоступен, создайте API-токен в веб-интерфейсе Moira (Settings → API Tokens) и добавьте его в конфигурацию MCP как Bearer-токен в заголовке. Подробнее: MCP-клиенты → API-токены.

Проверка подключения

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

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

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

Использование Moira в Claude Code

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

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

Claude:

1. Вызовет start с action: "prepare" и ID воркфлоу
2. Вызовет start с action: "execute" и полученным Start attempt ID
3. Получит Process ID, Step attempt ID и директиву первого шага
4. Выполнит директиву
5. Отправит результаты через step
6. Продолжит до завершения воркфлоу

Продолжение сессии

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

Продолжи мой воркфлоу Moira с process ID abc-123

Получение помощи

Покажи документацию Moira по узлам

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

Интеграция с CLAUDE.md

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

## Воркфлоу Moira

Этот проект использует Moira для воркфлоу разработки.

### Доступные воркфлоу

- `dev-flow` - Основной воркфлоу разработки
- `review-flow` - Воркфлоу код-ревью

### Начало разработки

Чтобы начать задачу, запустите воркфлоу разработки:

1. Подготовьте и выполните запуск воркфлоу `dev-flow`
2. Следуйте каждой директиве шага
3. Отправьте результаты перед переходом к следующему шагу

Добавляйте process ID воркфлоу в CLAUDE.md для легкого возобновления после прерывания сессии.

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

Основной цикл workflow использует следующие инструменты:

Инструмент	Описание
list	Список доступных воркфлоу
start	Подготовка или выполнение защищённого от повторов запуска
step	Отправка результата, получение следующей директивы
help	Получение документации
settings	Управление пользовательскими настройками
session	Информация о сессии и выполнениях

Полный актуальный каталог, входные схемы, действия и примеры находятся в справочнике MCP-инструментов.

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

Проблемы с подключением

1. Проверьте правильность URL MCP сервера
2. Проверьте сетевое подключение
3. Убедитесь в действительности аутентификации
4. Проверьте логи Claude Code на наличие ошибок

Воркфлоу не запускается

1. Проверьте существование ID воркфлоу: list
2. Проверьте права доступа к воркфлоу
3. Убедитесь, что у вас есть доступ к воркфлоу

Потеря сессии

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

1. Проверьте session({ action: "executions" }) для активных выполнений
2. Возобновите с правильным process ID
3. Рассмотрите добавление process ID в CLAUDE.md для сохранения

Лучшие практики

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

Связанное

• Быстрый старт — Общее руководство по настройке
• MCP клиенты — Другие интеграции клиентов