Codex Jira Stories MCP

Codex CLI가 Jira Cloud를 조회하고 이미 검토된 스토리를 게시할 수 있게 해주는 로컬 MCP 서버입니다. 로컬 스킬 jira-stories와 함께 작동하도록 설계되었습니다. 스킬은 스토리를 작성하고, 이 서버는 프로젝트를 조회하고 이슈를 생성하거나 업데이트합니다.

흐름 보안

• 자격 증명은 저장소에 저장되지 않습니다. JIRA_BASE_URL, JIRA_EMAIL, JIRA_API_TOKEN에서 읽습니다.

• 쓰기 도구는 confirmPublish: true를 요구합니다.

• 삭제 도구는 없습니다.

• 게시하기 전에 jira_preview_issue를 사용하고 결과를 확인하세요.

Related MCP server: JIRA MCP Server

준비

1. .env.example을 안전한 위치에 복사하고 터미널에서 변수를 내보내세요. 자격 증명이 포함된 .env 파일을 만들거나 버전 관리하지 마세요.

2. 계정에 원하는 Jira 프로젝트에 대한 Browse projects 및 Create issues 권한이 있는지 확인하세요.

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에 confirmPublish: true와 함께 jira_create_issue를 사용하도록 명시적으로 요청하세요. 설명은 일반 텍스트 또는 기본 Markdown에서 Jira Cloud가 허용하는 문서 형식으로 변환됩니다.

로컬 확인

npm test

현재 제한 사항

이 첫 번째 버전은 API 토큰을 통해 Jira Cloud를 지원합니다. SSO가 필수이거나 위임된 권한 부여 요구 사항이 있는 환경의 경우, 다음 단계는 동일한 도구를 유지하면서 MCP 서버에서 인증을 OAuth 2.0으로 전환하는 것입니다.