MCP Jira Server
接入你的智能体
發布者自己的指令。不是 PlugMCP 端點。
用我們的金鑰與日誌託管一份副本。
npx -y [email protected]Claude Code 沒有本機指令的安裝連結。複製下方指令並在終端機中執行。
JIRA_BASE_URL=<value> JIRA_EMAIL=<value> JIRA_API_TOKEN=<secret> MCP_REDACT_SENSITIVE=<value> LOG_LEVEL=<value> claude mcp add freema-mcp-jira-stdio -- npx -y mcp-jira-stdio@1.12.2在終端機中執行。
{ "mcpServers": { "freema-mcp-jira-stdio": { "command": "npx", "args": [ "-y", "[email protected]" ], "env": { "JIRA_BASE_URL": "<value>", "JIRA_EMAIL": "<value>", "JIRA_API_TOKEN": "<secret>", "MCP_REDACT_SENSITIVE": "<value>", "LOG_LEVEL": "<value>" } } }}claude_desktop_config.json
遠端 URL 還是本機指令? 兩種安裝方式的差異
A Model Context Protocol (MCP) server for Jira API integration. Enables reading, writing, and managing Jira issues and projects directly from your MCP client (e.g., Claude Desktop).
The fastest way to add this MCP server to Claude Code:
claude mcp add jira npx mcp-jira-stdio@latest \
--env JIRA_BASE_URL=https://yourcompany.atlassian.net \
--env [email protected] \
--env JIRA_API_TOKEN=your-api-token
Replace the values with your actual Jira credentials:
https://yourcompany.atlassian.net)That's it! The server will be automatically configured and ready to use.
If you prefer to configure manually or use Claude Desktop, see the Configuration section below.
# Install from npm
npm install -g mcp-jira-stdio
# Or install locally in your project
npm install mcp-jira-stdio
# Clone the repository
git clone https://github.com/freema/mcp-jira-stdio.git
cd mcp-jira-stdio
# Install dependencies
npm install
# or using Task runner
task install
# Build the project
npm run build
# or
task build
https://yourcompany.atlassian.net)Create a .env file from the provided example:
# Copy the example environment file
cp .env.example .env
# Edit .env with your actual Jira credentials
# Or use Task runner:
task env
Example .env contents:
JIRA_BASE_URL=https://your-instance.atlassian.net
[email protected]
JIRA_API_TOKEN=your-api-token
Note: Generate your API token at https://id.atlassian.com/manage-profile/security/api-tokens
# Test Jira connection
task jira:test
# List visible projects
task jira:projects
Use the quick install command (recommended):
claude mcp add jira npx mcp-jira-stdio@latest \
--env JIRA_BASE_URL=https://yourcompany.atlassian.net \
--env [email protected] \
--env JIRA_API_TOKEN=your-api-token
Add to your Claude Desktop config:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json~/.config/claude/claude_desktop_config.json{
"mcpServers": {
"jira": {
"command": "mcp-jira-stdio",
"env": {
"JIRA_BASE_URL": "https://your-instance.atlassian.net",
"JIRA_EMAIL": "[email protected]",
"JIRA_API_TOKEN": "your-api-token"
}
}
}
}
{
"mcpServers": {
"jira": {
"command": "npx",
"args": ["mcp-jira-stdio"],
"env": {
"JIRA_BASE_URL": "https://your-instance.atlassian.net",
"JIRA_EMAIL": "[email protected]",
"JIRA_API_TOKEN": "your-api-token"
}
}
}
}
Restart Claude Desktop after adding the configuration.
jira_get_visible_projects: Retrieves all projects visible to the user.jira_get_project_info: Retrieves detailed information about a project (components, versions, roles, insights).jira_get_issue: Retrieve issue details by key (supports optional fields/expand).jira_search_issues: Search for Jira issues using JQL with pagination and fields.jira_create_issue: Create a new issue in a project (type, priority, assignee, labels, components).jira_update_issue: Update an existing issue (summary, description, priority, assignee, labels, components, fix versions).jira_create_subtask: Create a subtask under a parent issue (auto-detects subtask type).jira_add_comment: Add a comment to an issue (optional visibility by group/role).jira_get_create_meta: Get create metadata for a project showing all available fields (including custom fields) with their allowed values. Essential for discovering required fields before creating issues.jira_get_issue_types: List issue types (optionally per project).jira_get_users: Search for users (by query, username, or accountId).jira_get_priorities: List available priorities.jira_get_statuses: List available statuses (global or project-specific).jira_get_custom_fields: List all custom fields in Jira with their types and schemas.jira_get_my_issues: Retrieve issues assigned to the current user (sorted by updated).# Development mode with hot reload
npm run dev
task dev
# Build for production
npm run build
task build
# Type checking
npm run typecheck
task typecheck
# Linting
npm run lint
task lint
# Format code
npm run format
task fmt
# Run all checks
npm run check
task check
Debug your MCP server using the inspector:
# Run inspector (production build)
npm run inspector
task inspector
# Run inspector (development mode)
npm run inspector:dev
task inspector:dev
Notes:
JIRA_BASE_URL, JIRA_EMAIL, and JIRA_API_TOKEN.NODE_ENV=development or test). Failures are logged but do not terminate the server, so the inspector can still display tools.# Run tests
npm test
task test
# Run tests with coverage
npm run test:coverage
task test:coverage
# Watch mode
npm run test:watch
task test:watch
src/
├── index.ts # Entry point & MCP server setup
├── config/
│ └── constants.ts # API configuration & constants
├── tools/
│ ├── index.ts # Tool exports
│ └── get-visible-projects.ts # Get visible projects tool
├── types/
│ ├── common.ts # Common types & interfaces
│ ├── jira.ts # Jira API types
│ └── tools.ts # Tool input/output schemas
└── utils/
├── jira-auth.ts # Jira authentication & client
├── validators.ts # Input validation with Zod
├── formatters.ts # Response formatting
├── error-handler.ts # Error handling
└── api-helpers.ts # Jira API helpers
// List all projects
jira_get_visible_projects({});
// List projects with additional details
jira_get_visible_projects({
expand: ['description', 'lead', 'issueTypes'],
});
// List recent projects only
jira_get_visible_projects({
recent: 10,
});
"Authentication failed"
"Connection failed"
"Permission denied"
MCP Connection Issues
dist/index.js)task inspector to debugTimeout when running multiple instances with npx
If you're running multiple Claude Code sessions simultaneously and experience timeouts, this is caused by npx cache/registry locking — not the MCP server itself. Each instance tries to verify the package, causing conflicts. To fix this, install the package globally instead:
npm install -g mcp-jira-stdio
claude mcp add jira mcp-jira-stdio \
--env JIRA_BASE_URL=... \
--env JIRA_EMAIL=... \
--env JIRA_API_TOKEN=...
# Test Jira connection
task jira:test
# List projects (test API connectivity)
task jira:projects
# Run MCP inspector for debugging
task inspector:dev
# Check all configuration
task check
If the inspector shows an SSE error and the server exits immediately, ensure you are not forcing an early exit with invalid credentials. With the current behavior, the server should not exit on missing credentials; export your Jira vars to exercise the tools:
export JIRA_BASE_URL="https://your-instance.atlassian.net"
export JIRA_EMAIL="[email protected]"
export JIRA_API_TOKEN="your-api-token"
npm run inspector
git checkout -b feature/amazing-feature)task check)git commit -m 'Add some amazing feature')git push origin feature/amazing-feature)This project is licensed under the MIT License — see the LICENSE file for details.
Configure Claude Desktop to use this MCP server interactively:
npm run setup:mcp
The script will:
JIRA_BASE_URL, JIRA_EMAIL, JIRA_API_TOKENjira entry into your Claude Desktop config or print the JSON.env for developmentMCP server for Jira integration with stdio transport. Issue management, project tracking, and workflow automation via Model Context Protocol.
{ "mcpServers": { "freema-mcp-jira-stdio": { "command": "npx", "args": [ "-y", "[email protected]" ], "env": { "JIRA_BASE_URL": "<value>", "JIRA_EMAIL": "<value>", "JIRA_API_TOKEN": "<secret>", "MCP_REDACT_SENSITIVE": "<value>", "LOG_LEVEL": "<value>" } } }}工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
發布者列出了以下環境變數:JIRA_BASE_URL, JIRA_EMAIL, JIRA_API_TOKEN, MCP_REDACT_SENSITIVE, LOG_LEVEL。
MCP Jira Stdio 透過 stdio 在本機執行。
上次檢查時間:2026-10-27。 MCP server for Jira integration with stdio transport. Issue management, project tracking, and workflow automation via Model Context Protocol.