AI导哈

Atlassian集成协议服务器

为Atlassian产品（Confluence、Jira）提供AI辅助的文档管理、搜索和导出功能的集成协议服务器。

  • by dunz
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 dunz/mcp-atlassian

使用说明

MCP Atlassian服务器

用于与Atlassian产品（Confluence，Jira）集成的Model Context Protocol（MCP）服务器。AI助手可以与Atlassian Cloud API交互以使用文档管理、搜索和导出功能。

📋 目录

主要功能

🔵 Confluence集成

  • 阅读和搜索：访问页面、空间和内容
  • 内容管理：创建页面、修改页面、撰写评论
  • 页面层次结构：浏览父/子页面关系
  • 导出：导出为包含图像的HTML或Markdown
  • 附件：附件列表，下载，上传
  • 标签：管理页面标签
  • 用户：搜索用户并跟踪个人活动
  • 个人仪表板：查看最近的页面和评论

🟢 Jira集成

  • 话题：阅读、搜索、查看个人任务
  • 项目：项目列表和导航
  • 板&冲刺：电路板列表、打印视图、活动任务跟踪
  • 评论：向问题添加评论
  • 创建问题：创建包含自定义字段的新问题
  • 用户管理：查看当前用户信息
  • 个人仪表板：检查打开的问题和打印作业

快速入门

1.发放Atlassian API令牌

  1. Atlassian安全设置转到
  2. 单击“创建API令牌”
  3. 输入令牌标签（例如“MCP集成”）
  4. 复制生成的令牌（仅显示一次！）

⚠️ 重要：请像密码一样安全地保存API令牌。

2.查找MCP配置文件

克劳德桌面

  • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
  • 窗户： %APPDATA%\Claude\claude_desktop_config.json
  • Linux： ~/.config/Claude/claude_desktop_config.json

光标

  • 所有操作系统： ~/.cursor/mcp.json

3.修改配置文件

打开配置文件并添加以下内容：

{
  "mcpServers": {
    "atlassian": {
      "command": "npx",
      "args": ["-y", "mcp-atlassian"],
      "env": {
        "ATLASSIAN_BASE_URL": "https://your-company.atlassian.net",
        "ATLASSIAN_EMAIL": "your-email@company.com",
        "ATLASSIAN_API_TOKEN": "YOUR_API_TOKEN_HERE"
      }
    }
  }
}

设置说明：

  • ATLASSIAN_BASE_URL：公司的Atlassian URL（末尾 / 删除）
  • ATLASSIAN_EMAIL：Atlassian帐户电子邮件
  • ATLASSIAN_API_TOKEN：在步骤1中创建的API令牌

4.重新启动应用程序

  • 克劳德桌面：完全关闭应用程序并重新启动
  • 光标: ⌘+Q （或 Ctrl+Q）然后重新运行

5.确认连接

问AI助手：

"Atlassian MCP 서버가 연결되었는지 확인해줘"

可用工具

Confluence工具（23个）

工具 说明
get_confluence_current_user 查看认证用户信息
get_confluence_user 查询特定用户信息
search_pages_by_user_involvement 通过用户活动搜索页面
list_pages_created_by_user 用户创建的页面列表
list_attachments_uploaded_by_user 用户上传的附件列表
read_confluence_page 按ID或标题读取页面
search_confluence_pages 使用CQL搜索页面
list_confluence_spaces 可用空间列表
get_confluence_space 查询特定空间信息
create_confluence_page 创建新页面
update_confluence_page 修改现有页面
list_confluence_page_children 子页面列表
list_confluence_page_ancestors 浏览父页面层次结构
export_confluence_page 导出包含图像的HTML/Markdown
list_attachments_on_page 页面附件列表
download_confluence_attachment 下载特定附件
upload_confluence_attachment 将文件上传到页面
get_page_with_attachments 下载所有内容的页面
add_confluence_comment 在页面上添加评论
list_confluence_page_labels 查看页面标签
add_confluence_page_label 将标签添加到页面
find_confluence_users 用户搜索
get_my_recent_confluence_pages 我最近的页面列表
get_confluence_pages_mentioning_me 寻找一页关于我的评论

Jira工具（16个）

工具 说明
get_jira_current_user 查看认证用户信息
get_jira_user 查询特定用户信息
search_issues_by_user_involvement 搜索与用户相关的问题
list_issues_by_user_role 按角色列出用户问题（日期筛选）
get_user_activity_history 跟踪用户活动，包括评论和状态更改
get_user_time_tracking 查看时间跟踪项目和总计
read_jira_issue 通过密钥读取热点详细信息
search_jira_issues 通过JQL搜索问题
list_jira_projects 可访问项目列表
create_jira_issue 创建新问题
add_jira_comment 向问题添加评论
list_agile_boards 屏幕/键盘列表
list_sprints_for_board 板上的打印列表
get_sprint_details 查询Sprint详细信息
get_my_current_sprint_issues 查看活动Sprint中的“我的工作”
get_my_unresolved_issues 查看所有未解决的问题

使用示例

搜索Confluence页面

"내가 작성한 Confluence 페이지 중 최근 5개를 보여줘"

"'API 문서'라는 제목이 포함된 페이지를 검색해줘"

阅读Confluence页面

"페이지 ID 882573681의 내용을 마크다운으로 보여줘"

查看Jira问题

"나한테 할당된 미해결 이슈를 모두 보여줘"

"현재 스프린트에서 내 작업 목록을 보여줘"

浏览项目和电路板

"접근 가능한 Jira 프로젝트 목록을 보여줘"

"스크럼 보드 목록을 보여줘"

使用CQL进行高级搜索

"type = page AND creator = currentUser() 조건으로 Confluence 페이지를 검색해줘"

故障排除

无法连接时

  1. 重新验证API令牌

    • Base URL格式： https://your-company.atlassian.net （最后 / 删除）
    • 验证电子邮件和令牌是否正确
    • 验证您是否具有令牌所需的权限

  2. 完全重新启动应用程序

    • Claude Desktop:完全退出并重新启动应用程序
    • 光标： ⌘+Q 后重新运行

  3. 验证配置文件

    • 检查JSON格式是否正确（逗号、大括号等）
    • 验证环境变量名称是否正确

性能较慢时

缩小搜索范围可以加快搜索速度：

"최대 10개의 결과만 보여줘"
"DEV 스페이스에서만 검색해줘"
"최근 1주일 이내의 이슈만 보여줘"

其他问题

限制

  • 仅支持Atlassian Cloud（不支持Server/Data Center）
  • 为了安全起见，不支持删除操作
  • 某些Confluence宏在Markdown转换时有限
  • 适用Atlassian Cloud API速度限制

许可证

MIT许可证

由以下材料制成❤️ 为了更好地集成Atlassian

相关 MCP