MCP Atlassian Sprint

MCP Atlassian

Atlassian产品（Confluence和Jira）的模型上下文协议（MCP）服务器。此集成支持Atlassian Cloud和服务器/数据中心部署。

功能演示

Confluence Demo

兼容性

安装指南

1.身份验证设置

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

适用于Atlassian Cloud

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

用于服务器/数据中心

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

2.安装

选择以下安装方法之一：

# Using uv (recommended)
brew install uv
uvx mcp-atlassian

# Using pip
pip install mcp-atlassian

# Using 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

对于服务器/数据中心：

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服务器/DC的SSL验证
• --[no-]jira-ssl-verify：切换Jira服务器/DC的SSL验证
• --verbose：增加日志记录的详细程度（可以多次使用）
• --read-only：以只读模式运行（禁用所有写入操作）

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

IDE集成

Claude桌面设置

使用uvx（推荐）-云：

{
  "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"
      ]
    }
  }
}

Using uvx (recommended) - Server/Data Center

{
  "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"
      ]
    }
  }
}

Using pip

注意：以下示例使用Atlassian Cloud配置。对于Server/Data Center，使用相应的参数（--convergence个人令牌、--jira个人令牌），如上面的配置部分所示。

{
  "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"
      ]
    }
  }
}

Using docker

注意：以下示例使用Atlassian Cloud配置。对于Server/Data Center，使用相应的参数（--convergence个人令牌、--jira个人令牌），如上面的配置部分所示。

有两种方法可以配置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"
      ]
    }
  }
}

1. 使用环境文件：

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

光标IDE设置

1. 打开光标设置
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

Server/Data Center Configuration

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

对于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}：进入汇流空间
• jira://{project_key}：访问Jira项目

可用工具

开发与调试

地方发展设置

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

{
  "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"
      ]
    }
  }
}

调试工具

# Using MCP Inspector
# For installed package
npx @modelcontextprotocol/inspector uvx mcp-atlassian ...

# For local development version
npx @modelcontextprotocol/inspector uv --directory /path/to/your/mcp-atlassian run mcp-atlassian ...

# View logs
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

安全

• 永远不要共享API令牌
• 确保.env文件的安全性和私密性
• 看 安全.md 最佳实践

许可证

麻省理工学院授权-见 许可证 文件。这不是Atlassian的官方产品。