Atlassian (browser SSO)

atlassian-browser-mcp

一个 MCP 服务，使用 Playwright 通过浏览器 Cookie 身份验证封装上游 mcp-atlassian 工具集，适用于位于企业 SSO（Okta、SAML 等）之后、无法使用 API 令牌的 Atlassian Server/Data Center 实例。它通过 stdio 在本地运行：使用捆绑的 CLI 登录一次，服务便会重复使用 Cookie。

功能

• 提供 mcp-atlassian 的所有 Jira 和 Confluence 工具，使用 SSO 浏览器会话而非 API 令牌进行身份验证，同时保留上游自身的网络加固措施（SSRF 重定向检查、DNS 固定、重试、速率限制、代理和 TLS 设置）。
• 每项服务只需通过 CLI 登录一次；服务本身不会打开浏览器，因此不会因等待浏览器而卡住。
• atlassian_auth_status 会告知 Agent 哪项服务需要登录，避免任务执行到一半才失败。
• 可选择性地从实际 Chrome 配置文件一次性预填自动化配置文件（ATLASSIAN_SEED_FROM_CHROME_PROFILE），因此首次登录通常只需点击一次。
• 在 macOS 上，可在不打开窗口的情况下重复使用已安装的 Chromium 系浏览器（Arc、Brave、Edge、Chrome 等）中的有效会话。它会读取该浏览器的 Keychain 密钥，并在 stderr 中说明这一点；此功能也可以关闭。
• Jira 和 Confluence 使用独立的 Cookie 存储，仅保存对应主机的 Cookie，权限模式为 0600。仅使用 Jira 或仅使用 Confluence 的配置也可正常工作。
• 提供命令行前端（atlassian-cli），供脚本和 Agent 使用：获取和搜索问题及页面。
• 设置 ATLASSIAN_BROWSER_AUTH_ENABLED=false 时，会回退到令牌身份验证。

快速开始

从 PyPI 安装，需先安装 uv：

JIRA_URL=https://jira.example.com uvx --from atlassian-browser-mcp atlassian-cli login jira   # once per service, opens your browser
CONFLUENCE_URL=https://confluence.example.com uvx --from atlassian-browser-mcp atlassian-cli login confluence
JIRA_URL=https://jira.example.com CONFLUENCE_URL=https://confluence.example.com uvx atlassian-browser-mcp

从代码检出版本安装，使用 uv.lock 中的准确版本：

git clone https://github.com/GeiserX/atlassian-browser-mcp.git && cd atlassian-browser-mcp
UV_PROJECT_ENVIRONMENT=.venv-atlassian-browser uv sync --frozen   # installs the versions in uv.lock
JIRA_URL=https://jira.example.com CONFLUENCE_URL=https://confluence.example.com ./atlassian-cli login jira   # once per service

需要 Python 3.11+、uv、Google Chrome，以及登录时使用的显示器。服务不会打开浏览器窗口，而是读取已保存的 Cookie；如果 Cookie 缺失或已过期，它会返回 AuthRequiredError，提示你重新登录。在 macOS 上，它还会在后台查找已安装浏览器中的有效会话，因此几秒后重试时可能已经可以使用。Chrome 预填功能及所有设置均见入门指南。

将其添加到客户端

每个客户端都通过 stdio 运行服务。只需设置你使用的服务的 URL。示例使用 PyPI 软件包，通过 uvx 运行；如果从代码检出目录运行，请将 uvx atlassian-browser-mcp 替换为 /path/to/atlassian-browser-mcp/run-atlassian-browser-mcp.sh。

Claude Code

claude mcp add --transport stdio atlassian \
  --env JIRA_URL=https://jira.example.com \
  --env CONFLUENCE_URL=https://confluence.example.com \
  -- uvx atlassian-browser-mcp

Claude Desktop（claude_desktop_config.json）和 Cursor（~/.cursor/mcp.json 或 .cursor/mcp.json）

{
  "mcpServers": {
    "atlassian": {
      "command": "uvx",
      "args": ["atlassian-browser-mcp"],
      "env": {
        "JIRA_URL": "https://jira.example.com",
        "CONFLUENCE_URL": "https://confluence.example.com"
      }
    }
  }
}

VS Code（.vscode/mcp.json）

{
  "servers": {
    "atlassian": {
      "type": "stdio",
      "command": "uvx",
      "args": ["atlassian-browser-mcp"],
      "env": {
        "JIRA_URL": "https://jira.example.com",
        "CONFLUENCE_URL": "https://confluence.example.com"
      }
    }
  }
}

Codex（~/.codex/config.toml）

[mcp_servers.atlassian]
command = "uvx"
args = ["atlassian-browser-mcp"]
env = { JIRA_URL = "https://jira.example.com", CONFLUENCE_URL = "https://confluence.example.com" }

协议。 通过 stdio 支持 MCP 2025-11-25、2025-06-18、2025-03-26 和 2024-11-05，适用于通过 initialize 握手启动的客户端（目前包括 Claude Code、Claude Desktop、Cursor 和 VS Code）。目前尚不支持 MCP 2026-07-28：上游 mcp-atlassian 固定使用 mcp<2 和 fastmcp<4（https://github.com/sooperset/mcp-atlassian/issues/1541），此服务会在上游升级后跟进。此服务仅通过 stdio 运行，且拒绝使用任何其他 FASTMCP_TRANSPORT 启动。

只读模式

写入工具会以你的身份（使用你的 SSO 身份）执行。要隐藏所有写入工具（创建、更新、删除、转换、上传、限制），请在服务的 env 中设置 READ_ONLY_MODE=true。上游会在列出工具和调用工具时强制执行此设置。ENABLED_TOOLS（以逗号分隔的工具名称允许列表）和 TOOLSETS 会进一步缩小列表范围；请参阅配置。

工具

工具	功能	提示
atlassian_auth_status	检查每个服务是否存在可用的已保存会话：会话文件年龄、Cookie 过期时间、实时检查结果、下一步操作	只读
atlassian_login	向用户显示准确的 atlassian-cli login <service> 命令	只读
jira_*（63 个）	所有上游 Jira 工具：问题、搜索、评论、转换、冲刺、看板、版本、链接、工时记录、附件、服务台、表单	38 个只读，25 个写入
confluence_*（35 个）	所有上游 Confluence 工具：页面、搜索、评论、标签、附件、历史记录、模板、限制	20 个只读，15 个写入

每个工具都包含标题和全部四种注释提示（只读、破坏性、幂等、开放世界），因此客户端可以自动批准读取操作，并在写入操作前进行确认。完整列表和 CLI 说明请参阅用法。

文档

• 入门指南：要求、安装、首次登录、从 Chrome 导入，以及 MCP 客户端配置
• 配置：所有环境变量及其默认值
• 用法：MCP 工具和 CLI 命令
• 工作原理：为何登录和服务运行是分开的进程，以及相关文件
• 故障排除：症状、原因、解决方法，以及错误报告应包含的内容

许可证

GPL-3.0-or-later