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配置中：

JSON``` 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16{ “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`。参见 [认证](https://mcp-atlassian.soomiles.com/docs/authentication) 了解详情。


### 3.开始使用


让你的AI助手：


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


## 文档


完整文档可在 **[mcp-atlasian.soomiles.com](https://mcp-atlassian.soomiles.com)**.


文档也可在 [llms.txt格式](https://llmstxt.org/)，LLM可以轻松使用：


- [`llms.txt`](https://mcp-atlassian.soomiles.com/llms.txt) --文档站点地图
- [`llms-full.txt`](https://mcp-atlassian.soomiles.com/llms-full.txt) --完整的文件


| 主题 | 描述 |
| --- | --- |
| [安装](https://mcp-atlassian.soomiles.com/docs/installation) | uvx、Docker、pip，源代码 |
| [认证](https://mcp-atlassian.soomiles.com/docs/authentication) | API令牌、PAT、OAuth 2.0 |
| [配置](https://mcp-atlassian.soomiles.com/docs/configuration) | IDE设置、环境变量 |
| [HTTP传输](https://mcp-atlassian.soomiles.com/docs/http-transport) | SSE，流式http，多用户 |
| [工具参考](https://mcp-atlassian.soomiles.com/docs/tools-reference) | 所有Jira和Confluence工具 |
| [故障排除](https://mcp-atlassian.soomiles.com/docs/troubleshooting) | 常见问题与调试 |


## 兼容性


| 产品 | 部署 | 支持 |
| --- | --- | --- |
| 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` -添加评论 |


**总共72个工具** --请参阅 [工具参考](https://mcp-atlassian.soomiles.com/docs/tools-reference) 查看完整列表。


## 安全


切勿共享API令牌。保持 `.env` 文件安全。看 安全.md.


## 贡献


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


## 许可证


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