MCP Atlassian

MCP Atlassian

适用于 Atlassian 产品（Confluence 和 Jira）的模型上下文协议（MCP）服务。支持 Cloud 和 Server/Data Center 部署。

https://github.com/user-attachments/assets/35303504-14c6-4ae4-913b-7c25ea511c3e

Confluence 演示

https://github.com/user-attachments/assets/7fe9c488-ad0c-4876-9b54-120b666bb785

快速开始

1. 获取 API 令牌

前往 https://id.atlassian.com/manage-profile/security/api-tokens 并创建令牌。

对于 Server/Data Center，请改用个人访问令牌。请参阅身份验证。

2. 配置 IDE

将以下内容添加到 Claude Desktop 或 Cursor 的 MCP 配置中：

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_API_TOKEN": "your_api_token",
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "[email protected]",
        "CONFLUENCE_API_TOKEN": "your_api_token"
      }
    }
  }
}

Server/Data Center 用户：请使用 JIRA_PERSONAL_TOKEN，而不是 JIRA_USERNAME + JIRA_API_TOKEN。详情请参阅身份验证。

Autohand Code

使用相同的 uvx 服务和 Atlassian 凭据：

autohand mcp add mcp-atlassian env \
  JIRA_URL=https://your-company.atlassian.net \
  [email protected] \
  JIRA_API_TOKEN=your_api_token \
  CONFLUENCE_URL=https://your-company.atlassian.net/wiki \
  [email protected] \
  CONFLUENCE_API_TOKEN=your_api_token \
  uvx mcp-atlassian

在 add 后添加 --scope project，即可将配置保存在当前项目中。有关最新的安装和 CLI 详情，请参阅 Autohand Code。

3. 开始使用

向 AI 助手提出以下请求：

• “查找 PROJ 项目中分配给我的问题”
• “在 Confluence 中搜索入职文档”
• “为登录问题创建一个 Bug 工单”
• “将 PROJ-123 的状态更新为 Done”

文档

完整文档请访问 mcp-atlassian.soomiles.com。

文档也提供 llms.txt 格式，方便大模型读取：

• llms.txt — 文档站点地图
• llms-full.txt — 完整文档

主题	描述
安装	uvx、Docker、pip、从源代码安装
身份验证	API 令牌、PAT、OAuth 2.0
配置	IDE 设置、环境变量
HTTP 传输	SSE、streamable-http、多用户
工具参考	所有 Jira 和 Confluence 工具
故障排除	常见问题和调试

兼容性

产品	部署方式	支持情况
Confluence	Cloud	完全支持
Confluence	Server/Data Center	支持（v6.0+）
Jira	Cloud	完全支持
Jira	Server/Data Center	支持（v8.14+）

主要工具

Jira	Confluence
jira_search - 使用 JQL 搜索	confluence_search - 使用 CQL 搜索
jira_get_issue - 获取问题详情	confluence_get_page - 获取页面内容
jira_create_issue - 创建问题	confluence_create_page - 创建页面
jira_update_issue - 更新问题	confluence_update_page - 更新页面
jira_transition_issue - 更改状态	confluence_add_comment - 添加评论

共 98 个工具 — 完整列表请参阅 工具参考。

安全

切勿分享 API 令牌。请妥善保护 .env 文件。请参阅 SECURITY.md。

贡献

开发环境设置请参阅 CONTRIBUTING.md。

许可证

MIT - 请参阅 LICENSE。这不是 Atlassian 官方产品。