MCP Atlassian

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

功能演示

兼容性

产品	部署类型	支持状态
合流	云	✅ 完全支持
合流	服务器/数据中心	✅ 支持（版本 7.9+）
吉拉	云	✅ 完全支持
吉拉	服务器/数据中心	✅ 支持（版本 8.14+）

设置指南

1.身份验证设置

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

对于 Atlassian Cloud

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

对于服务器/数据中心

前往您的个人资料（头像）→个人资料→个人访问令牌
单击创建令牌，命名，设置有效期
立即复制令牌

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 Server/DC 的 SSL 验证
--[no-]jira-ssl-verify ：切换 Jira Server/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"
      ]
    }
  }
}

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

注意：以下示例使用的是 Atlassian Cloud 配置。对于服务器/数据中心，请使用上面“配置”部分中所示的相应参数（--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"
      ]
    }
  }
}

注意：以下示例使用的是 Atlassian Cloud 配置。对于服务器/数据中心，请使用上面“配置”部分中所示的相应参数（--confluence-personal-token、--jira-personal-token）。

配置Docker环境有两种方法：

直接在配置中使用 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"
      ]
    }
  }
}

使用环境文件：

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

光标 IDE 设置

打开游标设置
导航至Features > MCP Servers
点击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

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} ：访问 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"
      ]
    }
  }
}

调试工具

# 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 文件的安全性和私密性
请参阅SECURITY.md了解最佳实践

执照

采用 MIT 许可 - 请参阅LICENSE文件。本产品非 Atlassian 官方产品。

MCP Atlassian

Integrations

MCP Atlassian

功能演示

兼容性

设置指南

1.身份验证设置

对于 Atlassian Cloud

对于服务器/数据中心

2.安装

3.配置和使用

必需参数

可选参数

IDE 集成

Claude 桌面设置

光标 IDE 设置

资源

可用工具

开发与调试

本地开发设置

调试工具

安全

执照

Appeared in Searches