Atlassian MCP

MCP办公协作

提供方 samwang0723

办公协作 HTTP · 远程 OAuth 授权 社区 / 第三方 Cursor

一个提供与Atlassian产品(Confluence和Jira)交互的标准化接口的MCP服务器,支持全面的CRUD操作、内容搜索、空间管理等功能。

一句话选型结论

按资料字段整理

Atlassian MCP 属于办公协作类 MCP 服务器,HTTP · 远程,OAuth 授权,可直接接入 Cursor,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类办公协作 传输方式HTTP · 远程 鉴权OAuth 授权 部署方式支持远程部署
GitHub 星标 6 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

办公协作
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

Atlassian集成TypeScript本地部署Confluence工具Jira工具API接口团队协作

安装与配置

HTTP · 远程 OAuth 授权
连远程 HTTPS 端点,通常为 Streamable HTTP
  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
日程与消息

查日程、发消息、约会议。

表单与审批

填表单、走审批流。

团队协作

同步任务、汇总进展。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 已适配 Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • 远程端点依赖网络与服务方可用性,注意密钥与调用额度。
  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在办公协作场景里让模型直接调用外部能力的人。
  • 已经在用 Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Atlassian MCP当前 未标注 HTTP · 远程 支持远程部署 无 2026-05-17
CowAgent 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Karakeep MCP 未标注 未标注 未标注 无 2026-05-17
agentscope 未标注 stdio · 本地进程 本地部署 有 2026-04-11
note-gen 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Everywhere 未标注 stdio · 本地进程 本地部署 有 2026-04-12

服务器档案

办公协作
字段来自项目仓库与公开索引,中文说明由本站标注
提供方samwang0723上游标注的维护方 samwang0723
分类办公协作本站按上游分类展示
连接方式HTTP · 远程连远程 HTTPS 端点,通常为 Streamable HTTP
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型支持远程部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

10.8 KB
来自项目仓库与上游目录的原文,未做删改

MCP Atlassian

一个模型上下文协议(MCP)服务器,为与Atlassian产品(Confluence和Jira)交互提供了全面的工具。

概述

此MCP服务器允许AI代理通过标准化接口与Atlassian产品进行交互。它为以下方面提供了广泛的工具:

  • 汇流:使用v2 REST API进行完整的CRUD操作、内容搜索、空间管理、页面管理、注释、标签等
  • Jira:问题管理、项目运营、过渡、评论和全面的工作流程支持

主要特点

  • 现代API支持:使用Confluence v2 REST API并回退到v1以实现搜索功能
  • 综合工具集:18+Confluence工具和8+Jira工具,涵盖所有主要业务
  • 安全与隐私:内置PII过滤和SSL验证控制
  • 灵活的配置:支持单独的服务URL、身份验证方法和工具过滤
  • 分页支持:v2 API的基于光标的分页和v1 API的偏移/限制
  • 错误处理:具有详细错误消息的全面错误处理
  • 类型安全:具有正确类型定义的完整TypeScript实现

先决条件

  • Node.js(v16或更高版本)
  • npm或纱线
  • 带有API令牌的Atlassian帐户
  • Docker(可选,用于容器化部署)

安装

标准安装

  1. 克隆存储库:```bash
    git clone https://github.com/yourusername/mcp-atlassian.git
    cd mcp-atlassian

1. 安装依赖项:```bash
npm install
# or using make
make install
  1. 创建一个 .env 根目录中的文件,其中包含您的Atlassian凭据:```
    ATLASSIAN_HOST=https://your-domain.atlassian.net
    ATLASSIAN_EMAIL=your-email@example.com
    ATLASSIAN_API_TOKEN=your-api-token

### Docker安装

1. 克隆存储库:```bash
git clone https://github.com/yourusername/mcp-atlassian.git
cd mcp-atlassian
  1. 创建一个 .env 如上所述的文件。

  2. 构建并运行Docker容器:```bash

Build the Docker image

make docker-build

Run the Docker container

make docker-run

Or use Docker Compose

make docker-compose


## 用法

### 启动服务器```bash
# Using npm
npm start

# Using make
make start

# Using Docker
make docker-run

这将启动MCP服务器,它将在可流式传输的HTTP上进行监听和响应。

MCP配置```json

"mcp-searchapi": {
"name": "mcp-searchapi",
"type": "streamable-http",
"streamable": true,
"url": "http://localhost:3007/mcp"
}


### 可用工具

#### 汇流工具

**搜索与发现:**

- **搜索影响**:使用带CQL的v1 API搜索Confluence中的内容

- 参数: `searchText` (字符串), `spaceKey` (字符串,可选), `limit` (数字), `start` (编号)

- **搜索_影响_页面_标题**:使用v2 API按标题搜索页面

- 参数: `title` (字符串,可选), `spaceId` (字符串,可选), `limit` (数字), `cursor` (字符串,可选)

**空间管理:**

- **get_conference_space_by_id_or_key**:获取特定Confluence空间的信息

- 参数: `spaceIdOrKey` (字符串)

- **get_conference_spaces**:获取所有可用空间

- 参数: `limit` (数字,可选), `cursor` (字符串,可选)

**页面管理:**

- **获取影响内容**:按ID获取特定页面内容

- 参数: `pageId` (字符串), `bodyFormat` (枚举:存储/atlas_doc_format/wiki,可选)

- **get_conference_pages**:获取空间中的所有页面

- 参数: `spaceId` (字符串), `limit` (数字,可选), `cursor` (字符串,可选)

- **get_conference_child_pages**:获取特定页面的子页面

- 参数: `pageId` (字符串), `limit` (数字,可选), `cursor` (字符串,可选)

- **conference_create_page**:创建新的Confluence页面

- 参数: `spaceId` (字符串), `title` (字符串), `content` (字符串), `status` (枚举,可选), `representation` (枚举,可选), `parentId` (字符串,可选)

- **conference_update_page**:更新现有页面

- 参数: `pageId` (字符串), `title` (字符串), `content` (字符串), `version` (数字), `status` (枚举,可选), `representation` (枚举,可选), `versionMessage` (字符串,可选)

- **update_confluence_page_title**:仅更新页面标题

- 参数: `pageId` (字符串), `title` (字符串), `status` (枚举,可选)

- **conference_delete_page**:删除Confluence页面

- 参数: `pageId` (字符串)

**标签管理:**

- **get_confluence_pages_by_label**:查找具有特定标签的页面

- 参数: `label` (字符串), `spaceId` (字符串,可选), `limit` (数字,可选), `cursor` (字符串,可选)

- **get_conference_page_labels**:获取特定页面的标签

- 参数: `pageId` (字符串), `limit` (数字,可选), `cursor` (字符串,可选)

- **add_confluence_page_labels**:向页面添加标签

- 参数: `pageId` (字符串), `labels` (字符串数组)

**评论:**

- **get_conference_page_comments**:在页面上获得定期评论

- 参数: `pageId` (字符串), `limit` (数字,可选), `cursor` (字符串,可选)

- **add_confluence_page_comment**:向页面添加评论

- 参数: `pageId` (字符串), `content` (字符串), `representation` (枚举,可选)

- **get_conference_page_inline_comments**:获取页面上的内联评论

- 参数: `pageId` (字符串), `limit` (数字,可选), `cursor` (字符串,可选)

- **create_confluence_footer_comment**:创建页脚注释

- 参数: `pageId` (字符串,可选), `blogPostId` (字符串,可选), `parentCommentId` (字符串,可选), `attachmentId` (字符串,可选), `customContentId` (字符串,可选), `content` (字符串), `representation` (枚举,可选)

#### Jira工具

- **search_jira_issues**:使用JQL(Jira查询语言)搜索问题

- 参数: `jql` (字符串), `maxResults` (数字,可选)

- **get_jira_issue**:获取有关特定问题的详细信息

- 参数: `issueKey` (字符串)

- **jira_get_all_项目**:获取所有可访问的项目

- 参数:无

- **jira_create_issue**:创建新的Jira问题

- 参数: `projectKey` (字符串), `issueType` (字符串), `summary` (字符串), `description` (字符串,可选),其他字段

- **jira_update_issue**:更新现有问题

- 参数: `issueKey` (字符串), `fields` (具有更新数据的对象)

- **jira_add_注释**:向问题添加评论

- 参数: `issueKey` (字符串), `comment` (字符串)

- **jira_get_转换**:获取问题的可用转换

- 参数: `issueKey` (字符串)

- **jira_transition问题**:将问题转变为另一种状态

- 参数: `issueKey` (字符串), `transitionId` (字符串), `comment` (字符串,可选)

## 架构说明

### 汇流API迁移

此服务器主要使用 **Confluence v2 REST API** 对于大多数操作,必要时可战略性回退到v1 API:

- **v2 API**:用于空格、页面、注释、标签-提供更好的性能和现代的基于光标的分页
- **v1 API**:用于通过CQL进行内容搜索-提供更强大的搜索功能
- **SSL支持**:自托管实例的可配置SSL验证旁路
- **认证**:支持基本身份验证、OAuth 2.0(计划中)和PAT令牌

### 工具过滤和安全

- **只读模式**:禁用所有写入操作以进行安全探索
- **工具白名单**:仅通过启用特定工具 `ENABLED_TOOLS` 环境变量
- **PII过滤**:自动检测和屏蔽响应中的敏感信息
- **错误上下文**:详细的错误消息,不暴露敏感配置

## 发展

### 项目结构```
src/
├── config/         # Configuration files
│   └── env.ts      # Environment configuration with validation
├── services/       # Service classes for Atlassian APIs
│   ├── confluencev2.ts    # Confluence v2 REST API service (primary)
│   ├── confluence.ts      # Legacy Confluence service (deprecated)
│   └── jira.ts           # Jira REST API service
├── tools/          # MCP tool implementations
│   ├── search-confluence.ts                    # Content search (v1 API)
│   ├── search-confluence-pages-by-title.ts     # Title search (v2 API)
│   ├── get-confluence-space.ts                 # Single space info
│   ├── get-confluence-spaces.ts                # All spaces list
│   ├── get-confluence-content.ts               # Page content by ID
│   ├── get-confluence-pages.ts                 # Pages in space
│   ├── get-confluence-child-pages.ts           # Child pages
│   ├── get-confluence-pages-by-label.ts        # Pages by label
│   ├── get-confluence-page-labels.ts           # Page labels
│   ├── add-confluence-page-labels.ts           # Add labels
│   ├── get-confluence-page-comments.ts         # Page comments
│   ├── add-confluence-page-comment.ts          # Add comment
│   ├── get-confluence-page-inline-comments.ts  # Inline comments
│   ├── confluence-create-page.ts               # Create page
│   ├── confluence-update-page.ts               # Update page
│   ├── update-confluence-page-title.ts         # Update title only
│   ├── confluence-delete-page.ts               # Delete page
│   ├── create-confluence-footer-comment.ts     # Footer comments
│   ├── search-jira-issues.ts                   # Jira search
│   ├── get-jira-issue.ts                       # Single issue
│   ├── jira-create-issue.ts                    # Create issue
│   ├── jira-update-issue.ts                    # Update issue
│   ├── jira-add-comment.ts                     # Add comment
│   ├── jira-get-transitions.ts                 # Get transitions
│   ├── jira-transition-issue.ts                # Transition issue
│   ├── jira-get-all-projects.ts                # All projects
│   ├── utils.ts                                 # Utility functions & PII filtering
│   └── index.ts                                # Tool exports
├── utils/          # Utility modules
│   └── tool-filter.ts      # Tool filtering and access control
└── index.ts        # Main entry point and server setup

建筑```bash

Using npm

npm run build

Using make

make build


### 测试```bash
# Using npm
npm test

# Using make
make test

Makefile命令

该项目包括一个Makefile来简化常见操作:```bash

Display available commands

make help
```

许可证

麻省理工学院

贡献

  1. 分叉存储库
  2. 创建功能分支(git checkout -b feature/amazing-feature)
  3. 提交您的更改(git commit -m 'Add some amazing feature')
  4. 推到分支(git push origin feature/amazing-feature)
  5. 打开拉取请求

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Atlassian MCP 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Atlassian MCP 怎么在 Cursor 里配置?

它的传输方式是HTTP · 远程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Atlassian MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Atlassian MCP 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

Atlassian MCP 支持哪些客户端?

资料标注支持 Cursor;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Atlassian MCP 能提供哪些能力?

资料显示能力标签包括 团队协作、TypeScript、Cursor、API接口。具体工具清单以官方文档为准。

Atlassian MCP 需要什么运行环境?

属于远程端点,不需要在本地装运行时。

Atlassian MCP 是本地还是远程?

它是远程端点,连服务地址即可。传输方式为HTTP · 远程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。