Codex Jira Stories MCP

Локальный MCP-сервер, который позволяет Codex CLI обращаться к Jira Cloud и публиковать уже проверенные истории. Он предназначен для работы с локальным skill jira-stories: skill составляет историю; этот сервер запрашивает данные проекта и создаёт или обновляет issue.

Безопасность процесса

• Учётные данные не хранятся в репозитории: они считываются из JIRA_BASE_URL, JIRA_EMAIL и JIRA_API_TOKEN.

• Инструменты записи требуют confirmPublish: true.

• Инструмента удаления не существует.

• Перед публикацией используйте jira_preview_issue и проверьте результат.

Related MCP server: JIRA MCP Server

Подготовка

1. Скопируйте .env.example в безопасное место и экспортируйте переменные в терминале. Не создавайте и не версионируйте файл .env с учётными данными.

2. Убедитесь, что у учётной записи есть права Browse projects и Create issues в нужном проекте Jira.

3. Зарегистрируйте сервер в Codex CLI:

codex mcp add jira-stories \
  --env JIRA_BASE_URL="$JIRA_BASE_URL" \
  --env JIRA_EMAIL="$JIRA_EMAIL" \
  --env JIRA_API_TOKEN="$JIRA_API_TOKEN" \
  -- node /Users/emenezes/projetos/codex-jira-stories-mcp/src/server.mjs

Затем откройте новый сеанс Codex и выполните /mcp, чтобы убедиться, что jira-stories активен.

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

Пример диалога

Напишите функциональную историю, чтобы обеспечить экспорт отчёта в PDF. Получите список доступных проектов Jira, сформируйте предварительный просмотр для проекта AGR и публикуйте только после моего одобрения.

Чтобы опубликовать одобренный предварительный просмотр, явно попросите Codex использовать jira_create_issue с confirmPublish: true. Описание преобразуется из обычного текста или базового Markdown в формат документа, принимаемый Jira Cloud.

Локальная проверка

npm test

Текущие ограничения

Эта первая версия поддерживает Jira Cloud через API-токен. Для сред с обязательным SSO или требованием делегированной авторизации следующим шагом является замена аутентификации на OAuth 2.0 в MCP-сервере, сохранив те же инструменты.