Skip to main content
Glama

Atlassian MCP

一个自定义的 Model Context Protocol 服务器,可让 AI 代理与 Atlassian Cloud 上的 Jira 和 Confluence 进行交互。它在后台使用 Jira REST API v3 和 Confluence REST API v2 发起纯 REST 调用。

设置

  1. 安装依赖并构建:

    npm install
    npm run build
  2. 将服务器暴露为全局命令,以便可以从任何工作区启动(使用 package.json 中的 bin 入口):

    npm link

    这会将 atlassian-mcp 命令加入你的 PATH。代码更改后重新运行 npm run build;链接的命令始终指向当前的 dist。

  3. 在 https://id.atlassian.com/manage-profile/security/api-tokens 创建 API 令牌。

  4. 通过环境变量提供凭据(参见 .env.example):

Variable

描述

ATLASSIAN_SITE_URL

你的站点,例如 https://your-domain.atlassian.net

ATLASSIAN_EMAIL

你的 Atlassian 账户的电子邮件地址

ATLASSIAN_API_TOKEN

上面创建的 API 令牌

Related MCP server: jira-mcp

连接客户端

VS Code(推荐)

此仓库附带一个标准的 .vscode/mcp.json。它通过登录 + 交互式 zsh(zsh -lic)启动服务器,从而继承你在 ~/.zshrc(或 ~/.zshenv)中导出的 Atlassian 凭据——配置中不包含任何机密——并调用全局链接的 atlassian-mcp 命令,因此无论打开哪个仓库都能正常工作:

{
  "servers": {
    "atlassian": {
      "type": "stdio",
      "command": "zsh",
      "args": ["-lic", "exec atlassian-mcp"]
    }
  }
}

此处避免使用 ${workspaceFolder}:它会解析为当前打开的任何仓库,因此当服务器从其他工作区使用时会被破坏。相反,npm link 命令名称是从你的 shell PATH 中解析的。

要使服务器在每个工作区中都可用,请将相同的 servers 块添加到你的用户级 MCP 配置中(命令面板 → MCP: Open User Configuration)。

备选方案:使用绝对路径运行 node

如果你不希望 npm link,可以直接使用绝对路径(不是 ${workspaceFolder},它会随工作区变化)将 node 指向构建后的入口文件。VS Code 的 ${userHome} 变量使其在跨机器时保持可移植:

{
  "servers": {
    "atlassian": {
      "type": "stdio",
      "command": "zsh",
      "args": ["-lic", "exec node \"${userHome}/Sites/atlassian-mcp/dist/index.js\""]
    }
  }
}

如果你将仓库克隆到其他位置,请调整路径。zsh -lic 包装器仍会从你的 shell 配置文件中提供凭据。

在你的 shell 配置文件中导出变量,而不是在配置文件中:

export ATLASSIAN_SITE_URL="https://your-domain.atlassian.net"
export ATLASSIAN_EMAIL="you@example.com"
export ATLASSIAN_API_TOKEN="your-api-token"

更改 shell 配置文件后,重新加载 VS Code 窗口,以便新值生效。

其他客户端(Claude Desktop、Cline、Cursor)

不通过你的 shell 运行的客户端可以使用相同的 zsh -lic 包装器,也可以显式设置变量:

{
  "mcpServers": {
    "atlassian": {
      "command": "atlassian-mcp",
      "env": {
        "ATLASSIAN_SITE_URL": "https://your-domain.atlassian.net",
        "ATLASSIAN_EMAIL": "you@example.com",
        "ATLASSIAN_API_TOKEN": "your-api-token"
      }
    }
  }
}

如果没有 npm link,请使用 node 并携带指向构建入口文件的绝对路径:

{
  "mcpServers": {
    "atlassian": {
      "command": "node",
      "args": ["/absolute/path/to/atlassian-mcp/dist/index.js"],
      "env": {
        "ATLASSIAN_SITE_URL": "https://your-domain.atlassian.net",
        "ATLASSIAN_EMAIL": "you@example.com",
        "ATLASSIAN_API_TOKEN": "your-api-token"
      }
    }
  }
}

对于本地开发,你可以直接用 npm run dev 运行服务器。

工具

Jira

Tool

描述

jira_search_issues

使用 JQL 搜索问题

jira_get_issue

按 key/id 获取单个问题

jira_create_issue

创建问题

jira_update_issue

更新问题上的字段

jira_add_comment

向问题添加评论

jira_list_transitions

列出可用的工作流转换

jira_transition_issue

将问题移到新状态

jira_list_projects

列出/搜索项目

jira_get_current_user

获取已认证用户(包括 accountId)

Confluence

Tool

描述

confluence_search

使用 CQL 搜索内容

confluence_list_spaces

列出空间

confluence_get_page

获取页面(含正文)

confluence_list_pages

列出页面(可选按空间)

confluence_get_child_pages

列出直接子页面

confluence_create_page

创建页面(存储格式正文)

confluence_update_page

更新页面(需要新版本)

confluence_delete_page

删除页面

confluence_get_page_comments

列出页面上的页脚评论

confluence_add_comment

向页面添加页脚评论

说明

  • Jira 富文本字段(描述、评论)接受纯文本,并会自动转换为 Atlassian Document Format (ADF)。

  • Confluence 页面/评论正文使用存储格式(XHTML),例如 <p>Hi</p>。

  • 你的 API 令牌继承你账户的所有权限。请保密,切勿提交。

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers