21  连接 Jira 和 Confluence

将 Atlassian Cloud 连接到 Claude Tag,使其可以读取和更新 Jira Issue 以及搜索 Confluence 页面。

export const BetaNote = () => Claude Tag is in public beta. Features and behavior described here may change before general availability.;

连接在 Access bundle 中添加。在 claude.ai/admin-settings/claude-tag 打开左侧导航的 Access bundles,点击进入一个包(或 Create 一个),转到其 Credentials 标签。

连接 Atlassian Cloud 让 Claude 从包作用域下的任何频道读取和搜索 Confluence 页面,以及读取、评论和更新 Jira Issue。一个凭据覆盖同一 Atlassian 站点上的两个产品。

这是 HTTP API 连接,不是 MCP 服务器或个人 claude.ai 连接器。将其与涵盖 Jira 和 Confluence 的插件配对,让 Claude 知道如何调用 API;参见附加插件

21.1 在 Atlassian 中创建凭据

为 Claude 创建专用 Atlassian 账号(例如 claude@yourcompany.example.com),并将其添加到它应访问的 Jira 项目和 Confluence 空间。连接可以读取此账号能读取的所有内容,因此专用账号让 Claude 的范围恰好是你授予的。

以该账号登录并在 id.atlassian.com/manage-profile/security/api-tokens 创建 API Token。Atlassian 仅显示一次令牌;将其存储在你可以检索的地方。Atlassian API Token 会过期,最长生命周期为一年,因此请在旧令牌过期前创建新令牌并更新连接。

21.2 将连接添加到包

在包的 Credentials 标签上,点击 Jira & Confluence 旁边的 Connect

表单要求填写专用账号的邮箱地址和来自 Atlassian 的 API Token。在主机字段中,将预填的 *.atlassian.net 替换为你自己站点的域名,例如 your-domain.atlassian.net。表单拒绝通配符,因为它会让凭据能访问任何 Atlassian 站点而非仅你的。

Agent Proxy 在网络边界注入凭据;模型和沙箱不会获得密钥。参见 Agent Proxy 的工作原理

Atlassian Data Center(自托管)不被预设覆盖,因为它使用作为 Bearer Header 发送的个人访问令牌认证。将 Data Center 实例作为自定义连接添加,凭据类型选择 Bearer,在 Allowed websites 下添加你实例的主机名。实例必须可从公共互联网访问。

21.3 验证连接

在包作用域下的频道中,开启新话题,要求 Claude 通过键或 URL 获取一个 Issue 或页面。调用在 Atlassian 的审计日志中落在专用账号下。

text wrap theme={null} @Claude can you read PROJ-123 from Jira?

新话题会自动获取连接;在已有话题中,通过名称要求 Claude 使用该服务。

21.4 相关资源