Elevance MCP Atlassian - 独立包

用于将 Jira 和 Confluence 与 AI 助手集成的 Model Context Protocol 服务器。

提供的功能

共 72 个工具：

• 48 个 Jira 工具（搜索、创建、更新、状态转换、评论等）

• 24 个 Confluence 工具（搜索、页面、评论、附件等）

Related MCP server: Jira Cloud MCP Server

快速设置（5 分钟）

1. 获取个人访问令牌（PAT）

Jira 与 Confluence：

1. 登录 https://jira.elevancehealth.com

2. 点击个人资料图标 → 个人资料

3. 导航到"个人访问令牌"

4. 点击"创建令牌"

   • 名称：MCP Atlassian Integration

   • 有效期：1 年

5. 复制该令牌（仅显示一次！）

2. 配置环境

# Copy template
copy .env.template .env

# Edit .env and paste your PAT tokens
notepad .env

将 YOUR_JIRA_PAT_TOKEN_HERE 和 YOUR_CONFLUENCE_PAT_TOKEN_HERE 替换为你自己的实际令牌。

3. 安装依赖

# Option A: Using pip
pip install -r requirements.txt

# Option B: Install as package
pip install -e .

4. 配置你的 IDE

对于 Claude Desktop：

编辑 %APPDATA%\Claude\claude_desktop_config.json：

{
  "mcpServers": {
    "elevance-atlassian": {
      "command": "python",
      "args": ["-m", "mcp_atlassian"],
      "cwd": "C:\\path\\to\\elevance-mcp-atlassian-standalone",
      "env": {
        "JIRA_URL": "https://jira.elevancehealth.com",
        "JIRA_PERSONAL_TOKEN": "YOUR_PAT_HERE",
        "CONFLUENCE_URL": "https://confluence.elevancehealth.com/",
        "CONFLUENCE_PERSONAL_TOKEN": "YOUR_PAT_HERE"
      }
    }
  }
}

对于 Windsurf：

添加到你的 MCP 设置中，或使用 .env 文件方式（推荐）。

对于 Cursor：

在设置中添加 MCP 配置，格式与 Claude Desktop 类似。

5. 测试连接

python validate_setup.py

你应当看到所有检查均通过，并带有 ✅ 符号。

6. 开始使用！

重启你的 IDE，并向你的 AI 助手询问：

• "查找分配给我的 Jira 问题"

• "在 Confluence 中搜索入职文档"

• "在项目 XYZ 中创建一个缺陷"

• "将 PROJ-123 的状态更新为 In Progress"

• "显示当前冲刺中的问题"

• "获取 Confluence 空间 DEV 中的页面内容"

可用工具

Jira 工具（48 个）

搜索与发现：

• jira_search - 使用 JQL 搜索问题

• jira_search_fields - 查找自定义字段定义

• jira_get_all_projects - 列出可访问的项目

• jira_get_project_issues - 获取项目中的所有问题

问题管理：

• jira_get_issue - 获取问题详情

• jira_create_issue - 创建新问题

• jira_update_issue - 更新现有问题

• jira_delete_issue - 删除问题

• jira_batch_create_issues - 批量创建多个问题

状态与工作流：

• jira_transition_issue - 转换问题状态

• jira_get_transitions - 获取可用的状态转换

评论：

• jira_add_comment - 向问题添加评论

• jira_edit_comment - 编辑现有评论

链接：

• jira_create_issue_link - 关联两个问题

• jira_remove_issue_link - 移除链接

• jira_create_remote_issue_link - 创建网页链接

• jira_link_to_epic - 将问题关联到史诗

• jira_get_link_types - 获取可用的链接类型

附件：

• jira_download_attachments - 下载问题附件

• jira_get_issue_images - 以内联内容形式获取图片

关注者：

• jira_add_watcher - 向问题添加关注者

• jira_remove_watcher - 移除关注者

• jira_get_issue_watchers - 列出关注者

时间跟踪：

• jira_add_worklog - 记录工作日志

• jira_get_worklog - 获取工作日志条目

敏捷/冲刺：

• jira_get_agile_boards - 列出看板

• jira_get_board_issues - 获取看板上的问题

• jira_get_sprints_from_board - 列出冲刺

• jira_get_sprint_issues - 获取冲刺中的问题

• jira_create_sprint - 创建新的冲刺

• jira_update_sprint - 更新冲刺

• jira_add_issues_to_sprint - 将问题添加到冲刺

版本：

• jira_get_project_versions - 列出版本

• jira_create_version - 创建新版本

• jira_batch_create_versions - 批量创建多个版本

组件：

• jira_get_project_components - 列出项目组件

分析：

• jira_get_issue_dates - 获取日期信息

• jira_get_issue_sla - 计算 SLA 指标

• jira_batch_get_changelogs - 获取变更历史

开发信息：

• jira_get_issue_development_info - 获取 PR、提交和分支

• jira_get_issues_development_info - 批量获取开发信息

高级：

• jira_get_user_profile - 获取用户信息

• jira_get_field_options - 获取自定义字段选项

• jira_get_issue_proforma_forms - 获取 ProForma 表单

• jira_get_proforma_form_details - 获取表单详情

• jira_update_proforma_form_answers - 更新表单答案

服务台（仅限 Server/DC）：

• jira_get_service_desk_for_project - 获取项目对应的服务台

• jira_get_service_desk_queues - 列出队列

• jira_get_queue_issues - 获取队列中的问题

Confluence 工具（24 个）

搜索：

• confluence_search - 使用 CQL 搜索内容

• confluence_search_user - 搜索用户

页面：

• confluence_get_page - 获取页面内容

• confluence_create_page - 创建新页面

• confluence_update_page - 更新页面

• confluence_delete_page - 删除页面

• confluence_move_page - 移动页面

• confluence_get_page_children - 获取子页面

• confluence_get_page_history - 获取页面版本

• confluence_get_page_diff - 比较版本

评论：

• confluence_add_comment - 添加评论

• confluence_reply_to_comment - 回复评论

• confluence_get_comments - 获取页面评论

附件：

• confluence_get_attachments - 列出附件

• confluence_upload_attachment - 上传文件

• confluence_upload_attachments - 上传多个文件

• confluence_download_attachment - 下载文件

• confluence_download_content_attachments - 下载所有附件

• confluence_delete_attachment - 删除附件

图片：

• confluence_get_page_images - 以内联内容形式获取图片

标签：

• confluence_get_labels - 获取内容标签

• confluence_add_label - 添加标签

分析：

• confluence_get_page_views - 获取浏览量统计

故障排除

"Module not found" 错误

pip install -e .

"Authentication failed"

• 验证 PAT 令牌有效且未过期

• 检查令牌是否已被撤销

• 确保 URL 正确（https://jira.elevancehealth.com）

• 尝试重新生成令牌

SSL 证书错误

添加到 .env 文件：

JIRA_SSL_VERIFY=false
CONFLUENCE_SSL_VERIFY=false

连接测试失败

# Test if Python can import the module
python -c "import mcp_atlassian; print('OK')"

# Check MCP version
python -m mcp_atlassian --version

运行验证时出现 "No such file or directory"

确保你位于正确的目录中：

cd C:\path\to\elevance-mcp-atlassian-standalone
python validate_setup.py

IDE 中不显示工具

1. 验证 IDE 配置中包含正确的路径

2. 完全重启 IDE

3. 检查 IDE 日志中的 MCP 连接错误

4. 确保 .env 或 IDE 配置中包含 TOOLSETS=all

安全最佳实践

• ✅ 保持 .env 文件的私密性

• ✅ 绝不共享 PAT 令牌

• ✅ 每 6-12 个月轮换一次令牌

• ✅ 不要将 .env 提交到版本控制

• ✅ 使用明确的令牌名称以便跟踪

• ✅ 不再需要时撤销令牌

高级配置

筛选特定项目

在 .env 中：

JIRA_PROJECTS_FILTER=PROJ1,PROJ2,PROJ3
CONFLUENCE_SPACES_FILTER=SPACE1,SPACE2,SPACE3

启用详细日志

在 .env 中：

MCP_VERBOSE=true
MCP_VERY_VERBOSE=true  # Debug level

只读模式（测试）

在 .env 中：

READ_ONLY_MODE=true

这将阻止任何写操作（创建、更新、删除）。

自定义工具集

在 .env 中：

# Only core tools
TOOLSETS=default

# Specific toolsets
TOOLSETS=default,jira_agile,jira_analytics

# Specific tools only
ENABLED_TOOLS=jira_search,jira_get_issue,confluence_search

系统要求

• Python： 3.10 或更高版本

• 操作系统： Windows、macOS 或 Linux

• 网络： 可访问 jira.elevancehealth.com

• IDE： 支持 MCP 的 Claude Desktop、Cursor 或 Windsurf

包内容

elevance-mcp-atlassian-standalone/
├── src/mcp_atlassian/       # Complete MCP implementation
│   ├── jira/                # 48 Jira tools
│   ├── confluence/          # 24 Confluence tools
│   ├── models/              # Data models
│   ├── servers/             # MCP server logic
│   └── utils/               # Utilities
├── .env.template            # Configuration template
├── requirements.txt         # Python dependencies
├── pyproject.toml          # Package metadata
├── validate_setup.py       # Setup validation script
├── README.md               # This file
├── SETUP-GUIDE.md          # Detailed setup instructions
└── LICENSE                 # MIT License

支持

如有问题或疑问，请联系：

• 开发者： Mohamed Wasim

• 邮箱： <Mohamed.Wasim@carelon.com>

下一步

1. ✅ 使用上述步骤完成设置

2. ✅ 运行验证：python validate_setup.py

3. ✅ 配置你的 IDE

4. ✅ 重启 IDE

5. ✅ 开始将 AI 助手与 Jira/Confluence 结合使用

其他资源

• SETUP-GUIDE.md - 带有截图说明的详细分步指南

• 原始文档 - https://mcp-atlassian.soomiles.com

许可证

MIT License - 仅供 Elevance Health/Carelon 内部使用

版本： 1.0
最后更新： 2026 年 3 月
维护方： Carelon Global Solutions