AI导哈

Atlassian协议服务器

为Atlassian产品（Confluence和Jira）提供模型上下文协议（MCP）服务，支持云端和服务器/数据中心部署。

  • by sooperset
  • Python
  • 本地部署
  • 6062 星标
  • 更新于
在 GitHub 查看 sooperset/mcp-atlassian

使用说明

MCP Atlassian

Atlassian产品（Confluence和Jira）的模型上下文协议（MCP）服务器。支持云和服务器/数据中心部署。

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

Confluence Demo

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

快速开始

1.获取您的API代币

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

对于服务器/数据中心，请改用个人访问令牌。看 认证.

2.配置IDE

添加到您的Claude Desktop或Cursor MCP配置中：

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

服务器/数据中心用户：使用 JIRA_PERSONAL_TOKEN 而不是 JIRA_USERNAME + JIRA_API_TOKEN。参见 认证 了解详情。

自动手代码

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

autohand mcp add mcp-atlassian env \
  JIRA_URL=https://your-company.atlassian.net \
  JIRA_USERNAME=your.email@company.com \
  JIRA_API_TOKEN=your_api_token \
  CONFLUENCE_URL=https://your-company.atlassian.net/wiki \
  CONFLUENCE_USERNAME=your.email@company.com \
  CONFLUENCE_API_TOKEN=your_api_token \
  uvx mcp-atlassian

添加 --scope project 之后 add 保持当前配置 项目。看 自动手代码 对于当前 安装和CLI详细信息。

3.开始使用

让你的AI助手：

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

文档

完整文档可在 mcp-atlasian.soomiles.com.

文档也可在 llms.txt格式，LLM可以轻松使用：

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

兼容性

产品 部署 支持
Confluence 云 完全支持
汇流 服务器/数据中心 支持（v6.0+）
Jira 云 完全支持
Jira 服务器/数据中心 支持（v8.14+）

关键工具

Jira 汇流
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 文件安全。看 安全.md.

贡献

看 贡献.md 用于开发设置。

许可证

麻省理工学院-参见 许可证不是Atlassian的官方产品。

相关 MCP