什么是Atlassian MCP 服务器？
Atlassian MCP 服务器是一个模型上下文协议（MCP）服务器，旨在将Atlassian产品（Confluence和Jira，云端和服务器/数据中心）与人工智能助手和开发工具集成。它通过MCP接口将Jira和Confluence的功能作为可执行函数（"工具"）公开。这允许大型语言模型（LLMs）和代理以编程方式自动化、搜索和互动Atlassian内容。它充当你的Atlassian实例与MCP主机应用之间的安全桥梁。
如何配置Atlassian MCP 服务器
- 认证设置：根据部署类型选择首选的认证方法：
- 对于Jira/Confluence云：使用API令牌（推荐）或OAuth 2.0
- 对于服务器/数据中心：使用个人访问令牌（PAT）
- 环境变量：准备Atlassian URL、令牌及其他选项（如项目/空间过滤器，只读模式，日志）等环境变量。
- 安装：将Docker镜像（
ghcr.io/sooperset/mcp-atlassian:latest）拉取到本地环境或服务器上。 - 在IDE或助手中配置：
- 直接通过IDE的MCP服务器设置传递环境变量（例如，在
claude_desktop_config.json或Cursor的MCP设置中）。 - 或者，创建一个环境文件并使用Docker的
--env-file标志。
- 直接通过IDE的MCP服务器设置传递环境变量（例如，在
- 传输设置：服务器可以作为使用
stdio的进程运行，或作为持久的HTTP服务（使用SSE或可流式传输HTTP传输）运行，以支持多用户或网络部署。 - 代理支持：根据需要使用相应的环境变量配置HTTP(S)/SOCKS代理。
- 工具控制：使用
ENABLED_TOOLS限制或允许对特定操作的访问，使用READ_ONLY_MODE提高安全性。
如何使用Atlassian MCP 服务器
- 启动服务器：通过Docker启动服务器，使用配置，选择启用的工具、日志或传输类型（可选）。
- 通过IDE或AI助手连接：在IDE/助手设置中将运行中的服务器添加为MCP服务器，提供适当的命令或HTTP端点。
- 调用工具：使用自然语言或自定义流程请求助手进行Jira和Confluence操作（例如，搜索、创建、更新、总结）。
- 控制访问：过滤可用工具，启用/禁用写操作，并根据需要选择每用户或全服务器认证。
- 监控和调试：查看日志，使用调试工具，并监控交互以确保平稳运行。
主要特性
- 支持Jira和Confluence（云和服务器/DC），实现单一集成
- 可执行工具：将Atlassian API公开为可通过MCP调用的工具，以供LLMs和代理使用
- 无缝的IDE/助手集成：可在Claude Desktop、Cursor等平台中配置
- 多认证支持：支持OAuth 2.0、API令牌和PAT，支持单用户和多用户认证
- 安全的内部部署：将凭据和数据保留在您的环境内
- 工具过滤和只读模式：精细控制可用的操作和权限
- 代理和日志支持：企业级支持自定义代理、日志和详细调试选项
- 可扩展的HTTP传输：可作为持久的HTTP服务运行，适用于共享或自动化用例
使用案例
- AI驱动的搜索：使用自然语言查询快速查找和总结项目文档和问题
- 自动化Jira更新：根据会议记录或聊天命令创建、更新、转换和评论Jira问题
- 文档生成：通过AI助手或IDE直接创建和更新Confluence页面或Jira票据
- 报告与过滤：自动获取和总结紧急错误、状态更新和项目指标
- 多用户工作流程：允许全组织访问Atlassian操作，遵循每个用户自己的权限，使用每用户令牌
常见问题
问：支持哪些认证方法？
答：服务器支持Atlassian API令牌（云）、个人访问令牌（服务器/DC），和OAuth 2.0（云，用于高级场景和多用户支持）。
问：我可以限制MCP服务器提供给我助手的操作吗？
答：可以，您可以通过ENABLED_TOOLS环境变量或命令行标志指定启用的工具，并设置READ_ONLY_MODE来禁用所有写操作。
问：如何处理我的服务器/数据中心部署上的SSL证书问题？
答：如果您的Atlassian实例使用自签名证书，请在配置中设置CONFLUENCE_SSL_VERIFY=false或JIRA_SSL_VERIFY=false。
问：是否可以为多个用户运行服务器，每个用户使用自己的凭据？
答：可以，使用HTTP传输（SSE或可流式HTTP），让每个客户端提供用户特定的令牌（云使用OAuth，服务器/DC使用PAT）。
问：如果我的助手无法连接到Jira或Confluence怎么办？
答：检查认证凭据、网络/代理设置、URL准确性，以及您在Atlassian实例中的用户权限。