MCP Atlassian

MCP Atlassian

集成Confluence和Jira的MCP Server。

PyPI Version PyPI - Downloads

用于 Atlassian 产品的 Model Context Protocol (MCP) 服务器,支持 Confluence 和 Jira 的 Cloud 和 Server/Data Center 部署。

支持的产品

产品部署类型支持状态
ConfluenceCloud✅ 完全支持
ConfluenceServer/Data Center✅ 支持 (7.9+)
JiraCloud✅ 完全支持
JiraServer/Data Center✅ 支持 (8.14+)

设置步骤

1. 获取认证令牌

Cloud 部署:

  1. 访问 https://id.atlassian.com/manage-profile/security/api-tokens
  2. 创建并复制 API 令牌

Server/Data Center 部署:

  1. 个人资料 → 个人访问令牌
  2. 创建并复制令牌

2. 安装

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

# 或使用 pip
pip install mcp-atlassian

3. 配置和运行

Cloud 部署:

uvx mcp-atlassian \
  --confluence-url https://your-company.atlassian.net/wiki \
  --confluence-username your-email@example.com \
  --confluence-token your_api_token \
  --jira-url https://your-company.atlassian.net \
  --jira-username your-email@example.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-spaces-filter: 以逗号分隔的空间键列表 (例如: "DEV,TEAM,DOC")
  • --jira-projects-filter: 以逗号分隔的项目键列表 (例如: "PROJ,DEV,SUPPORT")
  • --read-only: 以只读模式运行
  • --verbose-v: 增加日志详细程度

IDE 集成

Claude Desktop 配置

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

Cursor IDE 设置

  1. 打开 Cursor 设置
  2. 导航到 Features > MCP Servers
  3. 点击 + 添加新的全局 MCP 服务器
  4. 添加与上面类似的配置

完整文档和高级配置请参阅 GitHub 仓库