MCP Atlassian

MCP Atlassian 是一款专为 Atlassian 产品（如 Confluence 和 Jira）设计的模型上下文协议（MCP）服务器，支持云和本地部署，通过 AI 助手实现内容管理、任务自动化和智能交互。该工具提供 Confluence 和 Jira 的搜索、更新、创建等功能，适用于需要高效协作和自动化流程的团队。

核心功能

MCP Atlassian 提供以下核心功能，帮助用户在 Confluence 和 Jira 中实现智能化操作：

• Confluence 搜索：通过 CQL（Confluence 查询语言）搜索内容，快速定位所需信息。
• Jira 搜索：通过 JQL（Jira 查询语言）搜索问题，支持复杂查询条件。
• 页面创建：在 Confluence 中创建新页面，支持内容附加和更新。
• 问题更新：在 Jira 中更新现有问题，包括添加评论、修改字段等。
• 问题状态转换：将 Jira 问题转移到新的状态，支持自动化流程。

安装方法

MCP Atlassian 可通过 uvx 或 pip 安装，支持多种操作系统平台。

pip install mcp-atlassian

针对不同平台的安装命令如下：

• macOS：

uvx mcp-atlassian install --platform=darwin

• Windows：

uvx mcp-atlassian install --platform=windows

• Linux（支持主流发行版）：

uvx mcp-atlassian install --platform=linux

配置说明

安装完成后，需要配置环境变量以确保服务器正常运行。

export C>

对于云用户，还需设置 API 令牌：

export C>

对于服务器/数据中心用户，需设置用户名和密码：

export C
export C>

使用方法

安装并配置完成后，可以通过命令行或 IDE 启动 MCP Atlassian 服务器。

uvx mcp-atlassian

以下是几个常用命令示例：

• Confluence 搜索：

confluence_search 'CQL query'

• Jira 搜索：

jira_search 'JQL query'

使用示例

MCP Atlassian 提供了多种使用场景，以下是两个典型示例：

• 自动更新 Jira 问题：

更新Jira中的任务状态。

预期结果：成功更新任务状态并记录日志。

• 在 Confluence 中查找文档：

查找我们的OKR指南并生成摘要。

预期结果：返回 OKR 指南的摘要和相关链接。

适用场景

MCP Atlassian 适用于以下场景：

• 需要自动化更新 Jira 任务状态的团队。
• 需要在 Confluence 中快速查找并生成文档摘要的用户。
• 希望提升内容管理效率的组织。
• 需要集成 AI 助手进行智能交互的开发或运维团队。

注意事项

使用 MCP Atlassian 时需注意以下事项：

• 需要 API 令牌进行身份验证。
• 对旧版 Confluence 的支持有限。
• 某些高级功能可能需要额外权限。
• 建议定期更换 API 令牌以增强安全性。

调试与故障排除

如果服务器无响应或认证失败，可尝试以下方法：

• 检查环境变量是否正确设置。
• 验证 API 令牌或用户名密码是否准确。
• 使用调试命令启动服务器：

uvx mcp-atlassian debug

在 IDE 中配置调试参数：

{
  "mcpServers": {
    "mcp-atlassian-debug": {
      "command": "uvx mcp-atlassian debug",
      "args": []
    }
  }
}

安全建议

为确保安全，建议采取以下措施：

• 避免在代码中明文存储 API 令牌。
• 确保环境变量不被泄露。
• 定期更换 API 令牌。

MCP Atlassian 通过 AI 助手与 Atlassian 产品的深度集成，为团队提供高效、智能的内容管理与任务自动化解决方案。