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）：

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

Confluence

说明

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

• Confluence 页面/评论正文使用存储格式（XHTML），例如 <p>Hi</p>。

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