Skip to main content
Glama

MCP Atlassian

PyPI Version PyPI - Downloads PePy - Total Downloads Run Tests License Docs

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

渐进式分支配置

此分支保留上游直接的 Atlassian MCP 表面,并添加由 MCP_PROFILE=progressive 控制的本地渐进式配置。在渐进式模式下,服务器仅暴露发现/模式/执行包装器,如 jira_discover、jira_capability_schema、jira_execute_read 和 jira_execute_write_guarded,而不是完整的直接工具表面。

上游 sooperset/mcp-atlassian 目前不包含此渐进式层,因此必须选择性地协调上游更新。不要盲目合并上游,否则渐进式包/测试可能会被移除。参见 FORK_WORKFLOW.md。

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

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

Related MCP server: MCP Atlassian

快速开始

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。详情参见 身份验证。

Autohand Code

使用相同的 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

在 add 后添加 --scope project 以将配置保留在当前项目中。有关当前安装和 CLI 详细信息,请参见 Autohand Code。

3. 开始使用

让你的 AI 助手:

  • "查找 PROJ 项目中分配给我的问题"

  • "在 Confluence 中搜索入职文档"

  • "为登录问题创建错误工单"

  • "将 PROJ-123 的状态更新为“已完成”"

文档

完整文档可在 mcp-atlassian.soomiles.com 获取。

文档还提供 llms.txt 格式,LLM 可以轻松使用:

主题

描述

安装

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 - 添加评论

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

安全

切勿共享 API 令牌。确保 .env 文件安全。参见 SECURITY.md。

贡献

开发设置参见 CONTRIBUTING.md。

许可证

MIT - 参见 LICENSE。非 Atlassian 官方产品。

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      An MCP server that enables AI assistants to interact with Atlassian Jira and Confluence across Cloud and Server/Data Center environments. It supports tasks like searching and summarizing documentation, managing Jira issues, and creating content through natural language.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      An MCP server that integrates with Jira and Confluence to enable AI-powered issue management, content search, and document creation. It supports both Cloud and on-premise deployments, allowing users to automate workspace tasks through natural language.
      MIT