MCP Atlassian

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

示例用法

要求你的人工智能助手：

📝 自动 Jira 更新- “从我们的会议记录更新 Jira”
🔍 人工智能驱动的 Confluence 搜索- “在 Confluence 中查找我们的 OKR 指南并进行总结”
🐛 智能 Jira 问题过滤- “显示上周 PROJ 项目中的紧急错误”
📄 内容创建和管理- “为 XYZ 功能创建技术设计文档”

功能演示

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

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

兼容性

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

快速入门指南

1.身份验证设置

首先，为 Confluence 和 Jira 生成必要的身份验证令牌：

对于云

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

对于服务器/数据中心

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

2.安装

使用 MCP Atlassian 的主要方式是通过 IDE 集成：

选项 1：使用 uvx（推荐）

首先安装uv：

macOS/Linux：

# Using the official installer
curl -LsSf https://astral.sh/uv/install.sh | sh

# Alternatively, on macOS you can use Homebrew
brew install uv

视窗：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

安装uv后，您可以在 IDE 配置中直接使用uvx mcp-atlassian而无需单独安装该包。

选项 2：使用 pip

pip install mcp-atlassian

选项 3：使用 Smithery

npx -y @smithery/cli install mcp-atlassian --client claude

选项 4：使用 Docker

克隆存储库：
git clone https://github.com/sooperset/mcp-atlassian.git cd mcp-atlassian
构建 Docker 镜像：
docker build -t mcp/atlassian .

3. 关键配置选项

在 IDE 中进行配置时，您可以使用以下可选环境变量：

CONFLUENCE_SPACES_FILTER ：按空格键过滤（例如“DEV、TEAM、DOC”）
JIRA_PROJECTS_FILTER ：按项目键过滤（例如“PROJ、DEV、SUPPORT”）
READ_ONLY_MODE ：设置为“true”以禁用写入操作
MCP_VERBOSE ：设置为“true”以获得更详细的日志记录

**注意：**您可以仅配置 Confluence、仅配置 Jira 或仅包含所需服务的变量来配置这两项服务。

请参阅.env.example文件以了解所有可用选项。

IDE 集成

MCP Atlassian 旨在通过 IDE 集成与 AI 助手一起使用。

注意：要在 Claude Desktop 中应用配置：
方法 1（推荐） ：点击汉堡菜单 (☰) > 设置 > 开发者 > “编辑配置”按钮
方法二：直接找到并编辑配置文件：
Windows ： %APPDATA%\Claude\claude_desktop_config.json
macOS ： ~/Library/Application Support/Claude/claude_desktop_config.json
Linux ： ~/.config/Claude/claude_desktop_config.json
对于光标：打开设置 → 功能 → MCP 服务器 → + 添加新的全局 MCP 服务器

根据您的安装方法，设置方法如下：

使用 uvx（推荐）

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token",
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "JIRA_API_TOKEN": "your_api_token"
      }
    }
  }
}

对于服务器/数据中心部署，请改用以下环境变量：

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "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：

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token"
      }
    }
  }
}

仅适用于 Jira：

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

您还可以使用命令行参数代替环境变量：

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

如果您已经使用 pip 安装了 mcp-atlassian，请使用此配置：

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "mcp-atlassian",
      "env": {
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token",
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "JIRA_API_TOKEN": "your_api_token"
      }
    }
  }
}

如果您已经构建了 Docker 镜像，请使用以下配置：

方法 1：使用环境变量

{
  "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：使用环境文件

根据存储库中的.env.example模板创建一个.env文件，并用您的变量填充它，然后使用：

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

SSE 传输配置

使用以下命令启动服务器：

uvx mcp-atlassian --transport sse --port 9000 \
  --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

在您的IDE中配置：

{
  "mcpServers": {
    "mcp-atlassian-sse": {
      "url": "http://localhost:9000/sse"
    }
  }
}

资源和工具

资源

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

注意： MCP 服务器会根据用户的贡献和任务过滤资源，仅显示用户正在积极交互的 Confluence 空间和 Jira 项目。

关键工具

Confluence 工具

confluence_search ：使用 CQL 搜索 Confluence 内容
confluence_get_page ：获取特定页面的内容
confluence_create_page ：创建新页面
confluence_update_page ：更新现有页面

Jira 工具

jira_get_issue ：获取特定问题的详细信息
jira_search ：使用 JQL 搜索问题
jira_create_issue ：创建新问题
jira_update_issue ：更新现有问题
jira_transition_issue ：将问题转换为新状态
jira_add_comment ：向问题添加评论

Confluence 工具	Jira 工具
`confluence_search`	`jira_get_issue`
`confluence_get_page`	`jira_search`
`confluence_get_page_children`	`jira_get_project_issues`
`confluence_get_page_ancestors`	`jira_get_epic_issues`
`confluence_get_comments`	`jira_create_issue`
`confluence_create_page`	`jira_batch_create_issues`
`confluence_update_page`	`jira_update_issue`
`confluence_delete_page`	`jira_delete_issue`
	`jira_get_transitions`
	`jira_transition_issue`
	`jira_add_comment`
	`jira_add_worklog`
	`jira_get_worklog`
	`jira_download_attachments`
	`jira_link_to_epic`
	`jira_get_agile_boards`
	`jira_get_board_issues`
	`jira_get_sprints_from_board`
	`jira_get_sprint_issues`
	`jira_create_issue_link`
	`jira_remove_issue_link`

故障排除和调试

常见问题

身份验证失败：
- 对于云：检查您的 API 令牌（而不是您的帐户密码）
- 对于服务器/数据中心：验证您的个人访问令牌是否有效且未过期
- 对于较旧的 Confluence 服务器：某些旧版本需要使用CONFLUENCE_USERNAME和CONFLUENCE_API_TOKEN进行基本身份验证（其中 token 是您的密码）
SSL 证书问题：如果使用服务器/数据中心并遇到 SSL 错误，请设置CONFLUENCE_SSL_VERIFY=false或JIRA_SSL_VERIFY=false
权限错误：确保您的 Atlassian 帐户具有足够的权限来访问空间/项目

调试工具

# Using MCP Inspector for testing
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
# macOS
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
# Windows
type %APPDATA%\Claude\logs\mcp*.log | more

安全

切勿共享 API 令牌
确保 .env 文件的安全性和私密性
请参阅SECURITY.md了解最佳实践

贡献

欢迎为 MCP Atlassian 做出贡献！如果您想贡献：

查看我们的CONTRIBUTING.md指南
设置您的开发环境：
uv sync --frozen --all-extras --dev pre-commit install
进行更改并提交拉取请求

我们使用预提交钩子来保证代码质量，并遵循语义版本控制来发布。

执照

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

MCP Atlassian

Integrations

MCP Atlassian

示例用法

功能演示

兼容性

快速入门指南

1.身份验证设置

对于云

对于服务器/数据中心

2.安装

3. 关键配置选项

IDE 集成

使用 uvx（推荐）

SSE 传输配置

资源和工具

资源

关键工具

Confluence 工具

Jira 工具

故障排除和调试

常见问题

调试工具

安全

贡献

执照

Tools

Appeared in Searches