R4J Data Center MCP Server

MCP server for R4J (Requirements for Jira) — Data Center / Server only. Manage the R4J folder tree, add/move/remove issues, and query the hierarchy. Uses the official R4J REST API 1.0.

Jira Cloud is not supported. The R4J Cloud product exposes a different API shape; this server targets Data Center / Server endpoints only.

Tools

Compatibility

Verified against:

• Jira Data Center 10.3.13 (Atlassian Jira Project Management Software)
• R4J (easeRequirements Data Center) 5.3.1-10-jira10

Other Jira DC / Server and R4J versions are likely to work but are not tested. r4j_move_folder requires R4J 4.2.2+.

Installation

With uvx (recommended)

uvx mcp-server-r4j

With pip

pip install mcp-server-r4j
mcp-server-r4j

Configuration

Set these environment variables before starting the server. The server fails fast at startup if required vars are missing or malformed.

export R4J_JIRA_URL="https://jira.example.com/jira"
export R4J_JIRA_PAT="your-personal-access-token"
export R4J_PROJECT_KEY="PROJ"  # optional default

After starting the server, call r4j_healthcheck first to verify auth, R4J license, and project reachability.

Claude Desktop Setup

Edit %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/.config/claude/claude_desktop_config.json (Linux):

{
  "mcpServers": {
    "r4j": {
      "command": "uvx",
      "args": ["mcp-server-r4j"],
      "env": {
        "R4J_JIRA_URL": "https://jira.example.com/jira",
        "R4J_JIRA_PAT": "your-pat-here",
        "R4J_PROJECT_KEY": "PROJ"
      }
    }
  }
}

Claude Code Setup

claude mcp add r4j -- uvx mcp-server-r4j

To pass env vars so they persist in the Claude Code config:

claude mcp add r4j \
  -e R4J_JIRA_URL=https://jira.example.com/jira \
  -e R4J_JIRA_PAT=your-pat-here \
  -e R4J_PROJECT_KEY=PROJ \
  -- uvx mcp-server-r4j

Claude Code stores this configuration in ~/.claude.json (on Linux / WSL). Use claude mcp list to inspect what's registered.

Example Workflows

Create a folder and add issues:

1. r4j_ensure_folder_path → path="Sprint 42"
2. r4j_add_issue → issue_key="PROJ-123", folder_path="Sprint 42"

Move an issue between folders:

• r4j_move_issue → issue_key="PROJ-123", from_folder_path="Sprint 42", to_folder_path="Sprint 43"

Browse folder structure:

1. r4j_get_folder_context → folder_path="Sprint 42" (structured: child folders, issues, counts)
2. r4j_get_tree → folder_path="Sprint 42" (raw tree for deeper inspection)