Orangescrum MCP Server

Orangescrum MCP 服务

Orangescrum 官方模型上下文协议（MCP）服务：这是一个托管在云端的桥接服务，可让你的 AI 工具安全、实时地访问 Orangescrum 工作区中的项目、任务、用户、冲刺、测试用例管理、发布、规模化敏捷、风险、资源、考勤和请假管理、知识库（Wiki）以及文档。

快速入门 · 支持的工具 · 安全与管理 · 故障排查

---

官方 Orangescrum MCP 服务是连接 Orangescrum 工作区与兼容 AI 工具的云端桥梁。连接后，这些工具即可实时处理项目、任务、用户、史诗、功能和用户故事层级、冲刺、工时记录、测试用例管理、版本和发布、规模化敏捷、风险管理、资源管理、考勤、休假、检查清单、知识库（Wiki）页面、已保存的项目上下文以及上传的文档。身份验证采用 OAuth 2.1 with PKCE，因此每项操作都会以已登录用户的身份执行，并遵循其现有的 Orangescrum 角色和权限。

使用 Orangescrum MCP 服务，你可以：

• 汇总和搜索项目、任务、冲刺、缺陷、发布、Wiki 页面和文档，无需切换工具。
• 使用自然语言创建和更新任务、用户故事、缺陷、测试用例、工时记录、发布和知识库页面。
• 使用实时数据规划和跟踪冲刺、项目增量和发布准备情况。
• 自动处理重复性工作，例如将会议记录转化为任务，或将规格说明转化为待办事项。

只需连接一次，然后描述你的需求。无需切换标签页或复制粘贴：你的 AI 会选择并执行合适的操作。

它专为项目经理、开发人员、QA 团队和交付负责人打造，适用于使用 AI 助手或 IDE 并希望使用 Orangescrum 数据、无需不断切换上下文的场景。

重要

**推荐的端点是 https://mcp.orangescrum.com/mcp/partner。**它使用 OAuth 2.1，因此你无需将 API 密钥粘贴到配置文件中。客户端会自行注册、打开浏览器供你登录，并提示你选择一个工作区。设置步骤请参阅快速入门。

一键设置

在下方选择你的 AI 客户端，以添加官方 Orangescrum MCP 服务。一键安装按钮会为你添加服务，无需手动编辑任何 JSON 配置。其他选项会打开该客户端的分步指南。

Claude Custom connector	Claude Code One command	Codex One command	ChatGPT Custom connector	VS Code One-click install
OpenCode One command	Gemini Custom app	Antigravity IDE and CLI	Perplexity Custom connector	Cursor One-click install
Muse Chat prompt	Hermes Agent config.yaml	OpenClaw One command	GitHub Copilot CLI and IDE	Grok Custom connector
Kiro One-click install	Devin Desktop Settings	Zed Settings	LM Studio mcp.json	n8n Workflow node

_{客户端指南涵盖了 70 多种客户端。}

让你的 Agent 完成设置

大多数 AI Agent 都能自行添加服务并启动登录。将此提示词粘贴到你的 Agent（Claude Code、Codex、OpenCode、Cursor、Copilot、Antigravity 等）中：

Set up the Orangescrum MCP Server for the AI client you are running in.
Read https://raw.githubusercontent.com/Orangescrum/orangescrum-mcp-server/main/INSTALL.md
and follow it exactly: add the server https://mcp.orangescrum.com/mcp/partner
using my client's own method, keep my existing MCP servers, walk me through
the browser sign-in, then call get_current_user to confirm it works.

INSTALL.md 会告诉 Agent 如何查找对应客户端的操作步骤、添加服务而不更改其他设置、将登录步骤交给你，并检查连接。

或者自行添加服务：

客户端	命令或配置
Claude Code	claude mcp add --transport http orangescrum https://mcp.orangescrum.com/mcp/partner，然后输入 /mcp 登录
Codex CLI	codex mcp add orangescrum --url https://mcp.orangescrum.com/mcp/partner，然后运行 codex mcp login orangescrum
OpenCode	将 {"mcp": {"orangescrum": {"type": "remote", "url": "https://mcp.orangescrum.com/mcp/partner"}}} 添加到 opencode.json，然后运行 opencode mcp auth orangescrum
GitHub Copilot CLI	copilot mcp add --transport http orangescrum https://mcp.orangescrum.com/mcp/partner，然后输入 /mcp auth
Cursor	将 {"mcpServers": {"orangescrum": {"url": "https://mcp.orangescrum.com/mcp/partner"}}} 添加到 ~/.cursor/mcp.json
VS Code	将 {"servers": {"orangescrum": {"type": "http", "url": "https://mcp.orangescrum.com/mcp/partner"}}} 添加到 .vscode/mcp.json
Google Antigravity	将 {"mcpServers": {"orangescrum": {"serverUrl": "https://mcp.orangescrum.com/mcp/partner"}}} 添加到 ~/.gemini/config/mcp_config.json
Claude.ai / Claude Desktop	依次选择 Customize → Connectors → + Add → Add custom connector，将名称设为 Orangescrum，并粘贴服务 URL
ChatGPT	前往 chatgpt.com/plugins → + → Add custom MCP server，粘贴服务 URL，并选择 OAuth
Gemini app	前往 Settings → Connected Apps → Custom apps，粘贴服务 URL 并登录
Grok	前往 grok.com/connectors → New Connector → Custom，粘贴服务 URL 并登录
Perplexity	依次选择 Plugins → Add custom → Add MCP connector → Remote，粘贴服务 URL，并选择 OAuth 2.0
Orca、T3 Code 和其他 Agent 编排器	将服务添加到它们运行的每个 Agent 中（参见 Agent 编排器）
n8n、Zapier、Make、Dify 和 Agent SDK	参见编排工具和 SDK
其他任何 MCP 客户端	使用服务 URL https://mcp.orangescrum.com/mcp/partner，或参见 INSTALL.md

目录

• 一键设置
• 支持的客户端
• 插件打包与兼容性
• 支持的模块和工具
• 服务如何提供工具
• MCP 网关
• 开始之前
• 数据与安全
• 工作原理
• 工作流示例
• 提示与技巧
• 管理员须知：管理访问权限
• 安全
• 支持与反馈
• 免责声明

---

支持的客户端

Orangescrum MCP Server 适用于任何通过带 OAuth 的 Streamable HTTP 使用远程 MCP 的客户端。我们提供适用于 70 多种客户端的分步设置指南：

指南	涵盖内容
编码 Agent 和 IDE	Claude Code、OpenAI Codex CLI、OpenCode、Cursor、VS Code、GitHub Copilot CLI、Visual Studio、Google Antigravity、Gemini CLI、Devin Desktop（原名 Windsurf）、Zed、Cline、Kilo Code、Roo Code、Continue、Goose、Amp、Kiro、Warp、JetBrains Junie 和 AI Assistant、Factory Droid、Augment Code、Crush、Qwen Code、Trae、Hermes Agent、OpenClaw，以及 Orca 和 T3 Code 等 Agent 编排工具
聊天应用和助手	Claude（Claude.ai、Desktop 和 Cowork）、ChatGPT、Gemini、Grok、Perplexity、Mistral Le Chat、Microsoft Copilot Studio、Muse、Raycast AI、Notion AI、Slack、LibreChat、Open WebUI、Jan、LM Studio、Cherry Studio 和 Msty Studio
编排工具和 SDK	n8n、Zapier、Make、Dify、Flowise、Langflow、OpenAI、Anthropic、xAI 和 Gemini API、官方 MCP SDK、OpenAI Agents SDK、Claude Agent SDK、Vercel AI SDK、LangChain 和 LangGraph、Pydantic AI、LlamaIndex、Mastra、CrewAI、Google ADK、Microsoft Agent Framework、Semantic Kernel、AutoGen、Agno、Strands Agents、Cloudflare Agents、smolagents、Haystack 和 AWS Bedrock AgentCore Gateway
INSTALL.md	AI Agent 可读取并遵循的自助设置说明

该服务还支持任何仅限本地 STDIO 的 MCP 客户端，可通过 mcp-remote 代理连接。该代理在 localhost 上运行，在浏览器中完成 OAuth 流程，并将请求转发至托管服务。

说明

Microsoft 365 Copilot 声明式 Agent 和 Gemini Enterprise 暂不支持：两者都需要 OAuth 客户端密钥，而此服务注册的是不带客户端密钥的公共客户端。

提示

托管应用中的菜单经常变化。如果某个步骤与您看到的界面不符，请查看客户端设置或客户端自己的 MCP 文档。

插件打包与兼容性

此仓库以多种打包格式发布相同的 MCP 服务和技能，以便客户端使用其原生的发现和安装流程：

格式	清单和配置	共享组件
Agent Plugins v1	plugin.json 和 mcp.json	skills/
Claude Code 插件	.claude-plugin/plugin.json 和 .claude-plugin/marketplace.json	.mcp.json 和 skills/
Cursor 插件	.cursor-plugin/plugin.json	.mcp.json 和 skills/
Gemini 扩展	gemini-extension.json	嵌入清单中的 MCP 服务配置
MCP Registry	server.json	远程服务元数据

skills/ 中的技能是每个打包插件都会安装的内容。请参阅 skills/README.md，了解每项技能的用途。

mcp.json 和 .mcp.json 都是有意保留的。Agent Plugins 要求根目录下的文件名为 mcp.json，并使用其可移植的传输协议词汇（streamable-http）；现有客户端则继续使用 .mcp.json 及其原生词汇（http）。更改任一文件时，请保持两者的端点设置一致。如果两者不一致，npm run validate 将失败。

要安装包含技能的 Claude Code 插件：

/plugin marketplace add Orangescrum/orangescrum-mcp-server
/plugin install orangescrum@orangescrum

---

支持的模块和工具

工具按模块和意图（读取或写入）组织。每个模块都有自己的 OAuth 范围。用户会在授权页面批准范围，工作区管理员则会限制可授予的范围。

模块	工具	范围
项目	5	mcp:projects.read · mcp:projects.write
任务：评论、依赖项、链接、标签、附件、状态、类型	27	mcp:tasks.read · mcp:tasks.write
用户	3	mcp:users.read
测试用例管理：用例、套件、计划、运行、场景、策略、基线、数据集、缺陷	69	mcp:tests.read · mcp:tests.write
版本和发布：项目、就绪状态、审批、发布说明、依赖项、上线检查清单、冻结窗口、客户影响、模板、分析	60	mcp:releases.read · mcp:releases.write
规模化敏捷：发布列车、项目增量、迭代、项目看板、PI 目标、ROAM 风险、信心投票、WSJF、检查与调整、流量指标	50	mcp:safe.read · mcp:safe.write
风险管理：风险登记册、工作流、评论、链接、关注者、审批、风险热力图、报告	27	mcp:risks.read · mcp:risks.write
检查清单：分组、项目、模板、单项检查清单	20	mcp:checklists.read · mcp:checklists.write
休假：休假类型、余额、节假日、申请、审批、报告	12	mcp:leaves.read · mcp:leaves.write
资源管理：可用性、容量、利用率、分配报告、技能	8	mcp:resources.read
冲刺	7	mcp:sprints.read · mcp:sprints.write
考勤：签到和签退、记录、团队状态、仪表板、报告	7	mcp:attendance.read · mcp:attendance.write
待办事项层级：史诗、功能、用户故事、子任务	5	mcp:epics.read · mcp:epics.write
知识库（Wiki）：书架、书籍、页面树、页面、版本、评论、附件、反向链接、行动项、评审、工作项链接、搜索	36	mcp:wiki.read · mcp:wiki.write
工时记录	3	mcp:timelogs.read · mcp:timelogs.write
项目上下文（“记忆”）	2	mcp:context.read · mcp:context.write
文档管理：跨已上传文档搜索（RAG）	1	mcp:documents.read
总计	342

每个请求还需要基础范围 mcp:use。当客户端不了解细粒度范围时，会回退使用该范围。

此服务还提供 2 个提示词：daily_standup 和 overdue_report，大多数客户端会将其显示为斜杠命令；另有 3 个资源（你的项目、你的任务和已保存的项目上下文），客户端可将其附加为上下文。

模块专属条件：

• 工作区方案包含 冲刺 和 规模化敏捷 模块时，才能使用这些模块的工具。
• 写入范围需主动选择启用。 只读授权会提供一个无法更改任何内容的研究助手。
• 授权变更会立即生效。 管理员扩大或缩小工作区允许的范围后，已连接的客户端会在下次请求时看到变更，无需重新连接。

说明

如需查看完整且最新的工具参考（包括每个工具所需的范围），请参阅 工具。

---

服务如何提供工具

Orangescrum MCP 服务会在单个 tools/list 响应中发送连接可用的所有工具，且不使用分页游标。工具名称是普通的 snake_case 动词，例如 list_projects、create_task、get_release_readiness 和 start_sprint，因此 Agent 无需先进行发现步骤即可直接调用任一工具。

这有两点好处：

• 即使客户端在获取几页工具后就停止，或只缓存第一页，也仍然能看到完整的工具集。
• Agent 可以规划多步骤工作（例如，查找一个项目，然后查找其中的活动迭代，最后查找未完成的任务），而无需额外查询。

如果客户端允许你限制启用的工具，请关闭不使用的模块，避免占用当前任务的上下文。

MCP 网关

如果你使用 MCP 网关或代理，请将其指向同一 URL。无需进行任何覆盖设置：完整工具列表会在一页中传达，网关也会原样转发用户的 Authorization: Bearer 令牌。

https://mcp.orangescrum.com/mcp/partner

网关必须透传 401 响应中的 WWW-Authenticate 标头，以便客户端发现授权服务器。

---

开始之前

设置服务之前，请确认你的环境满足以下要求。

先决条件

具体要求取决于连接方式：

对于受支持的客户端

• 拥有一个由管理员启用了 MCP 的 Orangescrum Cloud 工作区（参见管理员说明）
• Orangescrum 登录凭据（电子邮件和密码，或 Google 登录）
• 可访问所选客户端
• 用于完成 OAuth 2.1 授权流程的现代浏览器

对于 IDE 或本地客户端（桌面设置）

• 拥有一个启用了 MCP 的 Orangescrum Cloud 工作区
• 受支持的 IDE（例如，VS Code 或 Cursor）或自定义的 MCP 兼容客户端
• 如果客户端需要本地 MCP 代理，则需安装 Node.js v18+（mcp-remote）
• 用于完成 OAuth 登录的现代浏览器

---

数据与安全

服务实施了多项安全控制：

• 所有流量都通过 **HTTPS（TLS 1.2 或更高版本）**加密传输。
• 使用 OAuth 2.1 和 PKCE 以及动态客户端注册（RFC 7591）：无需共享密钥、客户端密钥，也无需在磁盘上存储 API 密钥。
• 同意权限按工作区设置。 每个令牌都绑定到登录时选定的单个工作区，因此助手无法访问其他工作区。
• 作用域决定访问边界。 如果工具所需的作用域未获用户授权，则会返回 403 并指出缺失的作用域。
• 数据访问遵循用户现有的 Orangescrum 角色和项目成员身份。用户无权查看的项目会显示为未找到。
• 令牌有效期较短。 访问令牌有效期为 1 小时；刷新令牌有效期为 30 天，并且每次交换时都会轮换。

如需深入了解安全模型和管理员控制，请参阅：

• 身份验证
• 故障排除

---

工作原理

架构与通信

1. 受支持的客户端连接到服务端点：

   https://mcp.orangescrum.com/mcp/partner
   

   服务通过 Streamable HTTP 使用 JSON-RPC 2.0，并协商 MCP 协议修订版本 2025-11-25、2025-06-18、2025-03-26 和 2024-11-05。

2. 首个未经身份验证的请求会返回带有 WWW-Authenticate 标头的 401。客户端会读取 /.well-known/oauth-protected-resource 和 /.well-known/oauth-authorization-server，注册自身并打开浏览器。

3. 用户登录、选择工作区并批准作用域。客户端使用 PKCE 验证器将授权码交换为访问令牌和刷新令牌。

4. 此后，每个请求都会携带 Authorization: Bearer <access-token>，客户端则在后台静默刷新令牌。

权限管理

仅可访问用户在 Orangescrum 中已有权限查看的数据。要使用某个范围，必须同时满足两个条件：工作区必须允许该范围，且用户必须在授权页面上批准该范围。如果客户端请求的范围超出工作区允许的范围，系统会将其限制为允许的范围，而不是拒绝请求。

速率限制

请求按分钟和按天进行速率限制。收到 429 响应意味着触发了限制；行为良好的客户端会退避并重试。请参阅速率限制。

---

工作流示例

连接后，你可以从客户端运行以下任务。

项目、任务和用户

• 搜索：“查找 Project Apollo 中所有优先级高且未完成的任务。”
• 创建/更新：“创建一个标题为 ‘Redesign onboarding’ 的任务，并分配给 Priya。”
• 批量创建：“根据这些笔记创建五个任务。”
• 用户：“列出我工作区中的用户，并显示分配给 Priya 的任务。”

冲刺和待办事项

• 状态：“Project Apollo 当前冲刺的进展如何？”
• 规划：“将这份规格拆分为一个史诗、多个功能和用户故事。”
• 安排工作：“将这三个用户故事分配到下一个冲刺。”

测试用例管理

• 报告：“为我们刚在 staging 上遇到的结账超时问题提交一个严重缺陷。”
• 运行：“重新运行昨天回归测试中所有失败的测试。”
• 比较：“将此次运行与上一次基线进行比较。”

发布

• 就绪情况：“4.2 版本可以发布了吗？还有哪些问题阻碍发布？”
• 说明：“生成 4.2 版本的发布说明。”
• 日历：“本月哪些版本落在冻结期内？”

人员和时间

• 工时记录：“记录今天在任务 1482 上花费的 2 小时。”
• 工作容量：“下周平台团队中谁的工作负荷过重？”
• 休假：“申请周五休假，并显示我的剩余余额。”

组合任务

• 关联工作：“将这三个任务关联到 4.2 版本，并添加到其检查清单中。”
• 查找文档：“在我们上传的文档中搜索 API 速率限制政策。”
• 推进工作：“将任务 1482 移至 ‘In Review’，并添加评论说明 PR 已提交。”

说明

实际功能因你的范围、角色、工作区套餐和客户端平台而异。

---

技巧和窍门

设置默认工作区上下文

按照下面的 Markdown 更新你的 AGENTS.md，以减少发现请求、节省时间和令牌，并缩小结果集。

## Orangescrum MCP

When connected to orangescrum:
- **MUST** use project_id = "YOUR_PROJECT_ID" unless I name another project
- **MUST** use `limit: 20` for ALL list and search tools
- **MUST** call get_current_user once and reuse the user id instead of looking it up again
- **MUST** ask before any delete_* tool

保存项目上下文

使用 add_project_context 工具存储助手应始终了解的项目事实（完成定义、命名约定、任务负责人等）。get_project_context 和项目上下文资源会在后续会话中提供这些信息。

使用技能

如果你使用 Claude 这类桌面客户端，可以创建或复用技能来处理重复任务。查看 Orangescrum MCP 默认技能。

使用内置提示词

运行 daily_standup 获取工作站会摘要，或运行 overdue_report 查看所有已逾期事项。

---

管理员须知：管理访问权限

如果你是管理员，正准备让组织使用 Orangescrum MCP Server，请查看以下要点。

管理、监控和撤销访问权限

• 为工作区启用 MCP： 在公司启用 MCP 并选择允许的范围之前，MCP 处于关闭状态。在此之前，无论谁登录，所有授权尝试都会被拒绝。请联系 [email protected] 或您的客户经理以启用 MCP。
• 范围上限： 工作区允许的范围是任何用户可授予范围的上限。谨慎推广时，可将范围缩小为只读范围。
• 立即撤销： 禁用工作区授权后，正在进行的令牌会在下一次请求时失效。无需等待令牌过期。
• 最终用户控制： 用户可随时在客户端中移除该客户端以断开连接；若要强制重新登录，请移除并重新添加服务。
• 审计日志： 每次工具调用都会记录在审计跟踪中，包括用户、工作区、状态码和响应时间。

常见问题排查

• 登录页面不断循环，或授权始终无法完成。 首次连接时，最常见的原因是您所属的工作区均未启用 MCP，因此授权页面没有可供选择的内容。请让管理员启用 MCP。客户端打开的浏览器中弹出窗口或第三方 Cookie 被拦截，也可能导致流程无法完成。
• 工具返回了指明某个范围的 403 错误。 令牌已成功通过身份验证，但未获授该功能。请重新连接并批准该范围。如果授权页面未提供该范围，说明工作区尚未允许该范围。
• 助手看不到您知道存在的项目。 令牌绑定到一个工作区。请再次连接并选择另一个工作区。

如需了解更多信息，请参阅故障排查。

---

安全性

模型上下文协议（MCP）允许 AI Agent 使用您账户的权限连接工具和 Orangescrum 数据，这能实现强大的工作流，但也带来了结构性风险。您启用的任何 MCP 客户端或服务（例如 IDE 插件、桌面应用、托管的 MCP 服务或“一键式”集成）都可能导致 AI Agent 代表您执行操作。

大语言模型（LLM）容易受到提示词注入及相关攻击（例如间接提示词注入和工具投毒）。这些攻击可能诱使 Agent 在未经明确请求的情况下泄露数据或做出意外更改。

为降低风险，请仅使用可信的 MCP 客户端和服务，仔细检查每个 Agent 可访问的工具和数据，并遵循最小权限原则（先使用只读范围，并在非关键工作区进行试用）。对于任何影响重大或破坏性的操作，都应要求人工确认，并监控审计跟踪中是否存在异常活动。如需报告漏洞，请参阅 SECURITY.md。

---

支持和反馈

我们会利用您的反馈改进 Orangescrum MCP Server。如果您遇到错误或功能限制，或有任何建议：

• 阅读 Orangescrum 帮助中心的 MCP 指南。
• 如果遇到托管服务、登录、范围或工作区相关问题，请发送电子邮件至 [email protected]。
• 如果您发现此仓库中的任何问题，例如文档、清单、注册表条目或技能，请提交一个问题。

---

免责声明

MCP 客户端可以使用您现有的权限在 Orangescrum 中执行操作。请遵循最小权限原则，在确认前检查影响重大的更改，并监控审计跟踪中是否存在异常活动。

本 README 中展示的 AI 客户端产品名称和徽标均为其各自所有者的商标，仅用于标识此服务兼容的客户端，并不代表获得其背书。