MCP Atlassian
Atlassian产品(Confluence和Jira)的模型上下文协议(MCP)服务器。支持云部署和服务器/数据中心部署。
https://github.com/user-attachments/assets/35303504-14c6-4ae4-913b-7c25ea511c3e
快速入门
1. 获取您的API令牌
前往 https://id.atlassian.com/manage-profile/security/api-tokens 创建一个令牌。
对于服务器/数据中心,请使用个人访问令牌。请参阅 认证。
2. 配置您的IDE
将以下内容添加到您的Claude桌面或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。请参阅 认证 了解详细信息。
3. 开始使用
让您的AI助手执行以下操作:
- "查找分配给我的PROJ项目的任务"
- "在Confluence中搜索入职文档"
- "为登录问题创建一个bug工单"
- "将PROJ-123的状态更新为Done"
文档
完整文档可在 mcp-atlassian.soomiles.com 获取。
文档也以 llms.txt格式 提供,LLM可以轻松消费:
llms.txt— 文档站点地图llms-full.txt— 完整文档
| 主题 | 描述 |
|---|---|
| 安装 | uvx、Docker、pip、源码安装 |
| 认证 | API令牌、PAT、OAuth 2.0 |
| 配置 | IDE设置、环境变量 |
| HTTP传输 | SSE、streamable-http、多用户 |
| 工具参考 | 所有Jira & Confluence工具 |
| 故障排除 | 常见问题和调试 |
兼容性
| 产品 | 部署方式 | 支持 |
|---|---|---|
| Confluence | 云 | 完全支持 |
| Confluence | 服务器/数据中心 | 支持(v6.0+) |
| Jira | 云 | 完全支持 |
| Jira | 服务器/数据中心 | 支持(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 - 添加评论 |
共72个工具 — 请参阅 工具参考 获取完整列表。
安全
切勿共享API令牌。确保 .env 文件安全。请参阅 SECURITY.md。
贡献
开发环境设置请参阅 CONTRIBUTING.md。
许可证
MIT - 请参阅 LICENSE。非官方Atlassian产品。