Подключите Spexus к вашему AI-агенту

Spexus интегрируется с AI-агентами через MCP и передаёт эпики, user stories, требования, критерии приёмки и управляющие документы без ручного копирования.

Шаг 1: Скачайте Spexus MCP

Скачайте архив со страницы релизов и распакуйте бинарник в удобную директорию, например `/usr/local/bin/`.

ОС Файл
macOS (Apple Silicon) rms-ai-darwin-arm64.tar.gz
macOS (Intel) rms-ai-darwin-amd64.tar.gz
Linux (x64) rms-ai-linux-amd64.tar.gz
Windows rms-ai-windows-amd64.zip
tar -xzf rms-ai-darwin-arm64.tar.gz
mv spexus-mcp /usr/local/bin/spexus-mcp

Шаг 2: Инициализируйте клиент

При первом запуске выполните инициализацию и укажите адрес сервера `https://app.spexus.ai`, имя пользователя и пароль.

/usr/local/bin/spexus-mcp -i

Шаг 3: Подключите к вашему AI-агенту

Claude Code
claude mcp add spexus /usr/local/bin/spexus-mcp

Проверка: попросите агента показать список эпиков.

OpenAI Codex CLI
codex mcp add spexus /usr/local/bin/spexus-mcp

Проверка: попросите codex показать список эпиков.

OpenCode
opencode mcp add

Следуйте мастеру и укажите команду `/usr/local/bin/spexus-mcp`.

Другие AI-агенты
{
  "mcpServers": {
    "spexus": {
      "command": "/usr/local/bin/spexus-mcp",
      "args": [],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Cursor: `.cursor/mcp.json`, Windsurf: `.windsurf/mcp.json`.

Шаг 4: Проверьте подключение

Запустите вашего AI-агента и спросите: «Покажи эпики из spexus». Если всё настроено правильно, агент обратится к MCP-серверу и вернёт список эпиков.

Шаг 5: Поставьте первую задачу агенту

Теперь можно сразу использовать подключение в реальной работе. Спросите агента: «Создай новый эпик на тему ...» и дальше опишите, что именно хотите сделать, какой результат нужен и какой контекст важно учесть.

Создай новый эпик на тему ...

Если MCP-подключение настроено правильно, агент сможет создать новый эпик прямо в Spexus и начать проработку требований в диалоге.

Что получает AI-агент после подключения

Возможность Описание
Читать эпики и user stories Полный контекст продукта — что строим и зачем
Читать требования и критерии приёмки Детальные спецификации для генерации кода
Читать управляющие документы Архитектура, code style, стандарты команды
Создавать и обновлять сущности Проработка требований прямо в диалоге с AI
Искать по всей базе Быстрый поиск нужного контекста
Просматривать иерархию Полная картина эпика: stories -> requirements -> acceptance criteria

Примеры использования

«Создай user story для функции экспорта отчётов в PDF в рамках эпика EP-093»

«Посмотри требования US-354 и напиши компонент Hero-секции для главной страницы»

«Проверь текущий код на соответствие критериям приёмки AC-1160»

Troubleshooting

Проблема Решение
Сервер не запускается Проверьте права на исполнение: `chmod +x /usr/local/bin/spexus-mcp`
Агент не видит инструменты Перезапустите агент после добавления конфигурации
Ошибка подключения Проверьте путь к `spexus-mcp` или добавьте файл в PATH