MCP Atlassian

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

功能演示

<details> <summary>Confluence 演示</summary>

</details>

兼容性

产品	部署类型	支持状态
Confluence	Cloud	✅ 完全支持
Confluence	Server/Data Center	✅ 支持 (版本 7.9+)
Jira	Cloud	✅ 完全支持
Jira	Server/Data Center	✅ 支持 (版本 8.14+)

安装指南

1. 身份验证设置

首先，生成必要的身份验证令牌：

对于 Atlassian Cloud

1. 前往 https://id.atlassian.com/manage-profile/security/api-tokens
2. 点击 创建 API 令牌，命名它
3. 立即复制令牌

对于 Server/Data Center

1. 前往您的个人资料（头像）→ 个人资料 → 个人访问令牌
2. 点击 创建令牌，命名它，设置过期时间
3. 立即复制令牌

2. 安装

选择以下安装方法之一：

# 使用 uv (推荐)
brew install uv
uvx mcp-atlassian

# 使用 pip
pip install mcp-atlassian

# 使用 Docker
git clone https://github.com/sooperset/mcp-atlassian.git
cd mcp-atlassian
docker build -t mcp/atlassian .

3. 配置和使用

您可以使用命令行参数配置 MCP 服务器。该服务器支持使用 Confluence、Jira 或同时使用这两种服务 - 仅包含您用例所需的参数。

必需参数

对于 Atlassian Cloud：

uvx mcp-atlassian \
  --confluence-url https://your-company.atlassian.net/wiki \
  --confluence-username your.email@company.com \
  --confluence-token your_api_token \
  --jira-url https://your-company.atlassian.net \
  --jira-username your.email@company.com \
  --jira-token your_api_token

对于 Server/Data Center：

uvx mcp-atlassian \
  --confluence-url https://confluence.your-company.com \
  --confluence-personal-token your_token \
  --jira-url https://jira.your-company.com \
  --jira-personal-token your_token

注意： 您可以仅配置 Confluence、仅配置 Jira 或同时配置这两种服务。只需包含您要使用的服务所需的参数即可。例如，要仅使用 Confluence Cloud，您只需要 --confluence-url、--confluence-username 和 --confluence-token。

可选参数

• --transport: 选择传输类型 (stdio [默认] 或 sse)
• --port: SSE 传输的端口号 (默认: 8000)
• --[no-]confluence-ssl-verify: 切换 Confluence Server/DC 的 SSL 验证
• --[no-]jira-ssl-verify: 切换 Jira Server/DC 的 SSL 验证
• --verbose: 增加日志记录详细程度（可以多次使用）
• --read-only: 以只读模式运行（禁用所有写入操作）

注意： 所有配置选项也可以通过环境变量设置。有关可用环境变量的完整列表，请参阅存储库中的 .env.example 文件。

IDE 集成

Claude Desktop 设置

使用 uvx (推荐) - Cloud:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": [
        "mcp-atlassian",
        "--confluence-url=https://your-company.atlassian.net/wiki",
        "--confluence-username=your.email@company.com",
        "--confluence-token=your_api_token",
        "--jira-url=https://your-company.atlassian.net",
        "--jira-username=your.email@company.com",
        "--jira-token=your_api_token"
      ]
    }
  }
}

<details> <summary>使用 uvx (推荐) - Server/Data Center </summary>

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": [
        "mcp-atlassian",
        "--confluence-url=https://confluence.your-company.com",
        "--confluence-personal-token=your_token",
        "--jira-url=https://jira.your-company.com",
        "--jira-personal-token=your_token"
      ]
    }
  }
}

</details>

<details> <summary>使用 pip</summary>

注意：以下示例使用 Atlassian Cloud 配置。对于 Server/Data Center，请使用上面配置部分中显示的相应参数（--confluence-personal-token，--jira-personal-token）。

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "python",
      "args": [
        "-m",
        "mcp-atlassian",
        "--confluence-url=https://your-company.atlassian.net/wiki",
        "--confluence-username=your.email@company.com",
        "--confluence-token=your_api_token",
        "--jira-url=https://your-company.atlassian.net",
        "--jira-username=your.email@company.com",
        "--jira-token=your_api_token"
      ]
    }
  }
}

</details>

<details> <summary>使用 docker</summary>

注意：以下示例使用 Atlassian Cloud 配置。对于 Server/Data Center，请使用上面配置部分中显示的相应参数（--confluence-personal-token，--jira-personal-token）。

有两种方法可以配置 Docker 环境：

1. 直接在配置中使用 cli 参数：

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "mcp/atlassian",
        "--confluence-url=https://your-company.atlassian.net/wiki",
        "--confluence-username=your.email@company.com",
        "--confluence-token=your_api_token",
        "--jira-url=https://your-company.atlassian.net",
        "--jira-username=your.email@company.com",
        "--jira-token=your_api_token"
      ]
    }
  }
}

2. 使用环境变量文件：

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--env-file",
        "/path/to/your/.env",
        "mcp/atlassian"
      ]
    }
  }
}

</details>

Cursor IDE 设置

1. 打开 Cursor 设置
2. 导航到 Features > MCP Servers
3. 点击 Add new MCP server

对于 stdio 传输：

name: mcp-atlassian
type: command
command: uvx mcp-atlassian --confluence-url=https://your-company.atlassian.net/wiki --confluence-username=your.email@company.com --confluence-token=your_api_token --jira-url=https://your-company.atlassian.net --jira-username=your.email@company.com --jira-token=your_api_token

<details> <summary>Server/Data Center 配置</summary>

name: mcp-atlassian
type: command
command: uvx mcp-atlassian --confluence-url=https://confluence.your-company.com --confluence-personal-token=your_token --jira-url=https://jira.your-company.com --jira-personal-token=your_token

</details>

对于 SSE 传输，首先启动服务器：

uvx mcp-atlassian ... --transport sse --port 8000

然后在 Cursor 中配置：

name: mcp-atlassian
type: sse
Server URL: http://localhost:8000/sse

资源

注意： MCP 服务器会过滤资源，仅显示用户正在积极交互的 Confluence 空间和 Jira 项目，基于他们的贡献和分配。

• confluence://{space_key}: 访问 Confluence 空间
• jira://{project_key}: 访问 Jira 项目

可用工具

工具	描述
confluence_search	使用 CQL 搜索 Confluence 内容
confluence_get_page	获取特定 Confluence 页面的内容
confluence_get_page_children	获取特定 Confluence 页面的子页面
confluence_get_page_ancestors	获取特定 Confluence 页面的父页面
confluence_get_comments	获取特定 Confluence 页面的评论
confluence_create_page	创建新的 Confluence 页面
confluence_update_page	更新现有的 Confluence 页面
confluence_delete_page	删除现有的 Confluence 页面
jira_get_issue	获取特定 Jira 问题的详细信息
jira_search	使用 JQL 搜索 Jira 问题
jira_get_project_issues	获取特定 Jira 项目的所有问题
jira_create_issue	在 Jira 中创建新问题
jira_update_issue	更新现有的 Jira 问题
jira_delete_issue	删除现有的 Jira 问题
jira_get_transitions	获取 Jira 问题的可用状态转换
jira_transition_issue	将 Jira 问题转换为新状态
jira_add_worklog	向 Jira 问题添加工作日志条目
jira_get_worklog	获取 Jira 问题的工作日志条目
jira_link_to_epic	将问题链接到 Epic
jira_get_epic_issues	获取链接到特定 Epic 的所有问题

开发 & 调试

本地开发设置

如果您已克隆存储库并想要运行本地版本：

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/your/mcp-atlassian",
        "run", "mcp-atlassian",
        "--confluence-url=https://your-domain.atlassian.net/wiki",
        "--confluence-username=your.email@domain.com",
        "--confluence-token=your_api_token",
        "--jira-url=https://your-domain.atlassian.net",
        "--jira-username=your.email@domain.com",
        "--jira-token=your_api_token"
      ]
    }
  }
}

调试工具

# 使用 MCP Inspector
# 对于已安装的软件包
npx @modelcontextprotocol/inspector uvx mcp-atlassian ...

# 对于本地开发版本
npx @modelcontextprotocol/inspector uv --directory /path/to/your/mcp-atlassian run mcp-atlassian ...

# 查看日志
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

安全

• 永远不要分享 API 令牌
• 保持 .env 文件安全和私密
• 有关最佳实践，请参阅 SECURITY.md

许可证

在 MIT 许可下获得许可 - 请参阅 LICENSE 文件。这不是 Atlassian 的官方产品。