【技术文档摘要】：

Atlassian 数据中心 MCP

此项目提供了 Atlassian 数据中心产品的 Model Context Protocol (MCP) 集成，包括 Jira、Confluence 和 Bitbucket。

Claude 桌面配置

官方 Anthropic 快速入门指南

要使用这些 MCP 连接器与 Claude 桌面，需在您的 Claude 桌面配置中添加以下内容。

仅设置 *_HOST 变量为域名加端口，不带协议（例如：your-instance.atlassian.net）。默认假设使用 https 协议。

或者，您可以使用 *_API_BASE_PATH 变量代替 *_HOST 来指定完整的 API 基础 URL 包括协议（例如：https://your-instance.atlassian.net/rest）。请注意，/api/latest/ 部分是静态的，并且会在代码中自动添加，因此您不需要在 *_API_BASE_PATH 值中包含它。

您可以在配置中只留下需要的服务。

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "atlassian-jira-dc": {
      "command": "npx",
      "args": ["-y", "@atlassian-dc-mcp/jira"],
      "env": {
        "JIRA_HOST": "your-jira-host",
        "JIRA_API_TOKEN": "your-token"
      }
    },
    "atlassian-confluence-dc": {
      "command": "npx",
      "args": ["-y", "@atlassian-dc-mcp/confluence"],
      "env": {
        "CONFLUENCE_HOST": "your-confluence-host",
        "CONFLUENCE_API_TOKEN": "your-token"
      }
    },
    "atlassian-bitbucket-dc": {
      "command": "npx",
      "args": ["-y", "@atlassian-dc-mcp/bitbucket"],
      "env": {
        "BITBUCKET_HOST": "your-bitbucket-host",
        "BITBUCKET_API_TOKEN": "your-token"
      }
    }
  }
}

您也可以使用替代的 API 基础路径配置：

{
  "mcpServers": {
    "atlassian-jira-dc": {
      "command": "npx",
      "args": ["-y", "@atlassian-dc-mcp/jira"],
      "env": {
        "JIRA_API_BASE_PATH": "https://your-jira-host/rest",
        "JIRA_API_TOKEN": "your-token"
      }
    },
    "atlassian-confluence-dc": {
      "command": "npx",
      "args": ["-y", "@atlassian-dc-mcp/confluence"],
      "env": {
        "CONFLUENCE_API_BASE_PATH": "https://your-confluence-host/rest",
        "CONFLUENCE_API_TOKEN": "your-token"
      }
    },
    "atlassian-bitbucket-dc": {
      "command": "npx",
      "args": ["-y", "@atlassian-dc-mcp/bitbucket"],
      "env": {
        "BITBUCKET_API_BASE_PATH": "https://your-bitbucket-host/rest",
        "BITBUCKET_API_TOKEN": "your-token"
      }
    }
  }
}

生成 API 令牌

对于数据中心安装，您需要为每个服务生成个人访问令牌（PAT）：

Jira 数据中心

1. 登录到您的 Jira 实例
2. 转到个人资料 > 个人访问令牌
3. 点击“创建令牌”
4. 给它一个有意义的名字并设置适当的权限
5. 立即复制生成的令牌（它不会再次显示）

Confluence 数据中心

1. 登录到您的 Confluence 实例
2. 转到设置 > 个人访问令牌
3. 点击“创建令牌”
4. 命名您的令牌并设置所需权限
5. 保存并复制令牌（仅显示一次）

Bitbucket 数据中心

1. 登录到 Bitbucket
2. 转到管理账户 > HTTP 访问令牌
3. 点击“创建令牌”
4. 设置名称和权限
5. 生成并立即复制令牌

安全存储这些令牌，并如上所示在您的 Claude 桌面配置中使用它们。

概览

Atlassian DC MCP 允许 AI 助手通过标准化接口与 Atlassian 产品进行交互。它提供了工具用于：

• Jira：搜索、查看和创建问题
• Confluence：访问和管理内容
• Bitbucket：与仓库和代码进行交互

预备条件

• Node.js 18 或更高版本
• npm 7 或更高版本（支持工作区）
• Atlassian 数据中心实例或云实例
• 您想要使用的 Atlassian 产品的 API 令牌

安装

克隆仓库：

git clone https://github.com/b1ff/atlassian-dc-mcp.git
cd atlassian-dc-mcp

开发

该项目作为一个 npm 单一仓库使用工作区。工作区组织在 packages/ 目录下，每个 Atlassian 产品集成都有单独的包。

安装依赖项

要安装单一仓库中所有包的所有依赖项：

npm install

这将安装：

• 在根目录定义的根级依赖项
• 工作区中每个包的所有依赖项

要为特定包安装依赖项：

npm install <package-name> --workspace=@atlassian-dc-mcp/jira

要在根级别安装依赖项：

npm install <package-name> -W

构建项目

要构建所有包：

npm run build

要构建特定包：

npm run build --workspace=@atlassian-dc-mcp/jira

开发模式运行

要在开发模式下运行特定包：

npm run dev:jira     # 对于 Jira
npm run dev:confluence  # 对于 Confluence
npm run dev:bitbucket   # 对于 Bitbucket

配置

在根目录创建一个 .env 文件，包含以下变量：

# Jira 配置 - 选择以下选项之一：
JIRA_HOST=your-instance.atlassian.net
# 或者
JIRA_API_BASE_PATH=https://your-instance.atlassian.net/rest
# 注意：部分 /api/2/search/ 会自动添加，不要包含它
JIRA_API_TOKEN=your-api-token

# Confluence 配置 - 选择以下选项之一：
CONFLUENCE_HOST=your-instance.atlassian.net
# 或者
CONFLUENCE_API_BASE_PATH=https://your-instance.atlassian.net/confluence
# 注意：部分 /rest/api 会自动添加，不要包含它
CONFLUENCE_API_TOKEN=your-api-token

# Bitbucket 配置 - 选择以下选项之一：
BITBUCKET_HOST=your-instance.atlassian.net
# 或者
BITBUCKET_API_BASE_PATH=https://your-instance.atlassian.net/rest
# 注意：部分 /api/latest/ 会自动添加，不要包含它
BITBUCKET_API_TOKEN=your-api-token

许可证

MIT