Atlassian Dc MCP

](https://mseep.ai/app/b1ff-atlassian-dc-mcp)


Atlassian数据中心MCP

注： 这是一个由社区维护的项目 不隶属于Atlassian、不受Atlassian认可或支持. 请自行决定使用。

该项目为Atlassian数据中心产品（包括Jira、Confluence和Bitbucket）提供了模型上下文协议（MCP）集成。

快速设置

每个包裹都附带一个互动 setup 将凭据存储在操作系统上最安全的位置的子命令。每个产品运行一次：

npx @atlassian-dc-mcp/jira setup
npx @atlassian-dc-mcp/confluence setup
npx @atlassian-dc-mcp/bitbucket setup

设置CLI提示输入主机、API基本路径、默认页面大小和API令牌。在保存之前，它会验证明显的输入错误，并对选定的Atlassian产品执行定时身份验证请求，因此在设置过程中会捕获错误的主机、基本路径或令牌。

CLI标志和非交互模式

安装程序接受标志，因此您可以预先填充值或完全跳过提示（对脚本引导、CI或远程会话有用）。跑 npx @atlassian-dc-mcp/ setup --help 查看完整列表。

在交互模式下，您传递的任何标志都会预先填充其提示（例如。 --host 跳过主机提示，但仍要求执行其余操作）。在 --non-interactive 模式，setup解决了现有配置中缺少的任何问题（进程环境， ~/.atlassian-dc-mcp/ .env，或macOS Keychain），如果是主机（或完整URL），则退出非零 --api-base-path)找不到令牌。在以下情况下重用现有令牌 --token 省略。

# Scripted, no prompts, write everything from flags
npx @atlassian-dc-mcp/jira setup --non-interactive \
  --host jira.example.com \
  --token "$JIRA_TOKEN"

# Re-validate the existing token without re-entering it
npx @atlassian-dc-mcp/jira setup --non-interactive --host jira.example.com

凭据验证在不同模式下的行为不同：交互模式在失败时提供重试/保存提示，而 --non-interactive 在第一次验证失败时以代码1退出，因此它可以用作CI门。

令牌存储：

• macOS --通过以下方式写入登录密钥链 /usr/bin/security （服务 atlassian-dc-mcp账户 `

-token`).

• Linux --写信给 `~/.atlassian-dc-mcp/

.env 使用POSIX模式 0600` （仅为您的用户读/写；其他本地用户帐户无法读取）。

• 视窗 --写信给 `%USERPROFILE%\.atlassian-dc-mcp\

.env`.Node传递模式位，但Windows忽略它们，因此该文件继承了用户配置文件目录的ACL——通常只能由用户、SYSTEM和管理员读取。

非机密字段（主机、API基本路径、默认页面大小）始终写入主文件- ~/.atlassian-dc-mcp/ .env 在macOS/Linux上， %USERPROFILE%\.atlassian-dc-mcp\ .env 在Windows上。成功写入Keychain后，令牌行将从主文件中清除，因此在不太安全的地方永远不会有第二个副本。

安装程序运行后，MCP服务器可以在完全没有环境变量的情况下启动：

{
  "mcpServers": {
    "atlassian-jira-dc": { "command": "npx", "args": ["-y", "@atlassian-dc-mcp/jira"] },
    "atlassian-confluence-dc": { "command": "npx", "args": ["-y", "@atlassian-dc-mcp/confluence"] },
    "atlassian-bitbucket-dc": { "command": "npx", "args": ["-y", "@atlassian-dc-mcp/bitbucket"] }
  }
}

您仍然可以通过环境变量传递凭据，或者 ATLASSIAN_DC_MCP_CONFIG_FILE 如下面部分所示，它们优先于安装程序保存的值。

配置源和优先级

在启动时，每个MCP服务器通过按此顺序遍历源并取第一个非空值来解析每个配置键：

.env 在macOS/Linux上， %USERPROFILE%\.atlassian-dc-mcp\ .env 在Windows上（模式 0600 在POSIX上；Windows继承用户配置文件ACL）|所有键|主机、apiBasePath、defaultPageSize（始终）；令牌（非达尔文或密钥链回退）| |40|macOS钥匙串服务 atlassian-dc-mcp账户 -token` |仅标记|标记（仅达尔文）|

笔记：

• Process env胜过一切，因此您始终可以覆盖一个会话的存储凭据。
• ATLASSIAN_DC_MCP_CONFIG_FILE 必须是绝对路径；如果设置并丢失，服务器将很快发生故障。
• 钥匙链读取被缓存在init（1 execFileSync 每个产品令牌），因此工具调用永远不会耗尽。
• 如果一个更高优先级的源遮挡了安装程序即将保存的值，安装程序会打印一条警告，命名env-var，以便您可以取消设置它。
• Atlassian API请求在默认情况下30秒后超时。集 ATLASSIAN_DC_MCP_REQUEST_TIMEOUT_MS 设置为正毫秒值以覆盖它。

Claude桌面配置

Anthropic官方快速入门指南

要将这些MCP连接器与Claude Desktop一起使用，请将以下内容添加到您的Claude Desktop配置中。

集 *_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

窗户：

%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"
      }
    }
  }
}

共享外部配置文件

如果您希望一台计算机上的多个MCP主机或工具重用相同的Atlassian凭据，请将现有的 JIRA_*, CONFLUENCE_*，以及 BITBUCKET_* 将变量放入一个dotenv样式的文件中，并将每个MCP服务器指向该文件 ATLASSIAN_DC_MCP_CONFIG_FILE.

路径必须是绝对的。直接环境变量仍然覆盖共享文件中的值。

共享文件示例：

JIRA_HOST=your-jira-host
JIRA_API_TOKEN=your-jira-token
JIRA_DEFAULT_PAGE_SIZE=50

CONFLUENCE_HOST=your-confluence-host
CONFLUENCE_API_TOKEN=your-confluence-token

BITBUCKET_HOST=your-bitbucket-host
BITBUCKET_API_TOKEN=your-bitbucket-token
BITBUCKET_DEFAULT_PAGE_SIZE=50

使用一个共享文件的Claude Desktop示例：

{
  "mcpServers": {
    "atlassian-jira-dc": {
      "command": "npx",
      "args": ["-y", "@atlassian-dc-mcp/jira"],
      "env": {
        "ATLASSIAN_DC_MCP_CONFIG_FILE": "/Users/your-user/.config/atlassian-dc-mcp.env"
      }
    },
    "atlassian-confluence-dc": {
      "command": "npx",
      "args": ["-y", "@atlassian-dc-mcp/confluence"],
      "env": {
        "ATLASSIAN_DC_MCP_CONFIG_FILE": "/Users/your-user/.config/atlassian-dc-mcp.env"
      }
    },
    "atlassian-bitbucket-dc": {
      "command": "npx",
      "args": ["-y", "@atlassian-dc-mcp/bitbucket"],
      "env": {
        "ATLASSIAN_DC_MCP_CONFIG_FILE": "/Users/your-user/.config/atlassian-dc-mcp.env"
      }
    }
  }
}

Windows示例路径：

{
  "mcpServers": {
    "atlassian-jira-dc": {
      "command": "npx",
      "args": ["-y", "@atlassian-dc-mcp/jira"],
      "env": {
        "ATLASSIAN_DC_MCP_CONFIG_FILE": "C:\\\\Users\\\\your-user\\\\AppData\\\\Roaming\\\\atlassian-dc-mcp.env"
      }
    }
  }
}

Claude代码CLI配置

使用这些MCP连接器 克劳德代码，使用添加MCP服务器 claude mcp add 命令。

您可以在项目范围内添加服务器（存储在 .mcp.json)或用户范围(-s user).根据您的需求调整范围和包含的服务。

# Jira
claude mcp add atlassian-jira-dc \
  -e JIRA_HOST=your-jira-host \
  -e JIRA_API_TOKEN=your-token \
  -- npx -y @atlassian-dc-mcp/jira

# Confluence
claude mcp add atlassian-confluence-dc \
  -e CONFLUENCE_HOST=your-confluence-host \
  -e CONFLUENCE_API_TOKEN=your-token \
  -- npx -y @atlassian-dc-mcp/confluence

# Bitbucket
claude mcp add atlassian-bitbucket-dc \
  -e BITBUCKET_HOST=your-bitbucket-host \
  -e BITBUCKET_API_TOKEN=your-token \
  -- npx -y @atlassian-dc-mcp/bitbucket

你也可以使用 *_API_BASE_PATH 而不是 *_HOST （与上述Claude Desktop示例相同）：

claude mcp add atlassian-jira-dc \
  -e JIRA_API_BASE_PATH=https://your-jira-host/rest \
  -e JIRA_API_TOKEN=your-token \
  -- npx -y @atlassian-dc-mcp/jira

要在用户范围内添加服务器（适用于所有项目）：

claude mcp add -s user atlassian-jira-dc \
  -e JIRA_HOST=your-jira-host \
  -e JIRA_API_TOKEN=your-token \
  -- npx -y @atlassian-dc-mcp/jira

要使用共享配置文件而不是内联传递凭据，请执行以下操作：

claude mcp add atlassian-jira-dc \
  -e ATLASSIAN_DC_MCP_CONFIG_FILE=/Users/your-user/.config/atlassian-dc-mcp.env \
  -- npx -y @atlassian-dc-mcp/jira

Windows PowerShell示例：

claude mcp add atlassian-jira-dc `
  -e ATLASSIAN_DC_MCP_CONFIG_FILE=C:\Users\your-user\AppData\Roaming\atlassian-dc-mcp.env `
  -- npx -y @atlassian-dc-mcp/jira

生成API令牌

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

Jira数据中心

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

汇流数据中心

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

比特桶数据中心

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

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

概述

Atlassian DC MCP允许AI助手通过标准化的界面与Atlassian产品进行交互。它提供了以下工具：

• Jira：搜索、查看和创建问题
• 汇流：访问和管理内容
• 比特桶：与存储库和代码交互

先决条件

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

安装

克隆存储库：

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

发展

这个项目是使用工作区构建的npm monorepo。工作空间按以下方式组织 packages/ 目录，每个Atlassian产品集成都有单独的包。

安装依赖项

要安装monorepo中所有包的所有依赖项，请执行以下操作：

npm install

这将安装：

• 根中定义的根级依赖关系 package.json
• 工作区中每个包的所有依赖关系

要安装特定软件包的依赖项，请执行以下操作：

npm install 
 --workspace=@atlassian-dc-mcp/jira

要在根级别安装依赖项，请执行以下操作：

npm install 
 -W

建设项目

要构建所有包，请执行以下操作：

npm run build

要构建特定的包，请执行以下操作：

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

以开发模式运行

要在开发模式下运行特定包，请执行以下操作：

npm run dev:jira     # For Jira
npm run dev:confluence  # For Confluence
npm run dev:bitbucket   # For Bitbucket

配置

对于生产用途，首选 快速设置 上面的CLI——它写入macOS Keychain（用于令牌）和非机密字段的主文件(~/.atlassian-dc-mcp/ .env 在macOS/Linux上， %USERPROFILE%\.atlassian-dc-mcp\ .env 在Windows上）自动。

为了地方发展，创建一个 .env 根目录中的文件，或磁盘和点上任何位置的共享dotenv样式文件 ATLASSIAN_DC_MCP_CONFIG_FILE 它具有以下变量：

# Jira configuration - choose one of these options:
JIRA_HOST=your-instance.atlassian.net
# OR
JIRA_API_BASE_PATH=https://your-instance.atlassian.net/rest
# Note: part /api/2/search/ is added automatically, do not include it
JIRA_API_TOKEN=your-api-token

# Confluence configuration - choose one of these options:
CONFLUENCE_HOST=your-instance.atlassian.net
# OR
CONFLUENCE_API_BASE_PATH=https://your-instance.atlassian.net/confluence
# Note: part /rest/api is added automatically, do not include it
CONFLUENCE_API_TOKEN=your-api-token

# Bitbucket configuration - choose one of these options:
BITBUCKET_HOST=your-instance.atlassian.net
# OR
BITBUCKET_API_BASE_PATH=https://your-instance.atlassian.net/rest
# Note: part /api/latest/ is added automatically, do not include it
BITBUCKET_API_TOKEN=your-api-token

每个密钥的解析顺序为 process.env → ATLASSIAN_DC_MCP_CONFIG_FILE （或 ./.env) → 主文件(~/.atlassian-dc-mcp/ .env 在macOS/Linux上， %USERPROFILE%\.atlassian-dc-mcp\ .env 在Windows上）→ macOS钥匙链。看 配置源和优先级 上面。

许可证

麻省理工学院