通过 MCP 在项目计划中使用 ChatGPT、Claude 和 Gemini

把任务清单粘贴给 AI 助手，再问它“项目延误了吗？”，得到的回答听起来合理，却并不可靠：模型不了解依赖关系、日历和浮动时间，它给出的日期也没有经过任何计算。

Model Context Protocol（MCP）改变了这一点。助手不再猜测：它通过调用 Planitude 排程引擎的工具来查询计划，而它提出的每一项修改都会按照与甘特图相同的规则重新计算。本指南介绍 MCP 是什么、助手能对你的项目做什么，以及如何连接 ChatGPT、Claude 和 Gemini。

什么是 MCP#

Model Context Protocol 是一项开放标准，让 Claude、ChatGPT 等 AI 应用能够连接外部数据源、工具和工作流；其文档把它比作 AI 应用的 USB-C 接口^[1]。服务提供方发布一个带有工具列表的 MCP 服务器，助手会发现这些工具，并在有助于回答问题时调用它们。

对项目计划而言，这意味着助手处理的不是粘贴到聊天里的副本，而是真实的计划，并且使用的是连接者本人的权限。

助手能对你的计划做什么#

Planitude 的 MCP 服务器提供读取和分析工具：

• 项目状态：项目列表，以及把每个项目归类为延误、有风险、正常或已完成的总览，并给出原因和未来七天的截止日期。
• 计划详情：任务、日期、依赖关系和人员，也可以只显示关键任务。
• 关键路径：没有浮动时间的任务链、接近关键的任务，以及浮动时间的分布。
• 延误影响：“如果拆除工作推迟三天，完工日期会推迟多少？”，并与可用的浮动时间进行对比。
• 蒙特卡洛模拟：P50、P80 和 P95 完成日期，按计划或按某个截止日期完成的概率，以及风险因素。
• 工作负荷：超负荷的人员以及导致超负荷的任务。
• 计划的基线、版本和模板。

这样，“本周哪些项目有风险，为什么？”或“我们在 12 月 15 日前交付的概率有多大？”之类的问题，得到的都是基于计算的回答，而不是模型的猜测。

带预览的修改#

拥有编辑权限时，助手还可以创建项目（空白项目、基于模板，或基于包含阶段、任务和链接的结构化计划），并对项目进行修改：添加任务、更新工期和进度、建立依赖关系、保存基线、导入 .mpp 文件。

较大的修改会先经过预览：助手准备一组修改，Planitude 在不保存任何内容的情况下返回计算结果（新的完成日期、能否满足截止日期、冲突、超负荷人员、关键路径），只有在确认之后才会应用这些修改。如果在此期间有人修改了项目，这些修改会被拒绝，助手必须重新读取计划。此外，ChatGPT 默认会在每次执行写入操作之前请求确认^[3]。

安全：OAuth、权限与撤销#

ChatGPT、Claude.ai 和 Gemini 等 Web 应用通过 OAuth 连接，这是 MCP 规范规定的授权机制，基于带 PKCE 的 OAuth 2.1^[2]。你不需要分享密码，也不需要复制密钥：助手会打开 Planitude，你登录后会看到一个授权页面，上面列出了它可以执行的操作。

• 读取权限始终包含在内；只有打开“同时允许修改”时才会授予修改权限。
• 你可以把访问范围限制在一个工作区。
• 助手以你的权限执行操作：它只能看到你能看到的项目。
• 它不能删除项目或任务，也不能管理你的账号和密钥。
• 你可以随时在 个人资料 › API 密钥 › 已连接的应用 中断开任何应用。

对于更适合使用密钥的工具，你可以创建具有只读或读写权限、可选有效期的 API 密钥；密钥只显示一次，撤销会立即生效。

连接 ChatGPT#

连接自定义 MCP 服务器需要使用开发者模式，该模式在网页版中面向 Plus、Pro、Business、Enterprise 和 Education 方案提供^[3]：

1. 在 ChatGPT 中打开 Settings › Security and login，开启开发者模式^[3]；
2. 在应用中新建一个应用，粘贴 URL https://planitude.app/mcp，并选择 OAuth 作为认证方式；
3. 登录 Planitude 并允许访问；
4. 在对话中通过 + 菜单选择开发者模式，并启用 Planitude。

在组织中，管理员可能会限制开发者模式。此外，我们已经向 ChatGPT 应用目录提交了 Planitude 应用，目前正在接受 OpenAI 的审核。

连接 Claude#

在 Claude 中需要添加一个自定义连接器，Free、Pro、Max、Team 和 Enterprise 方案均可使用；Free 方案可以添加一个^[4]：

1. 打开 Customize › Connectors，选择 Add custom connector；
2. 粘贴服务器 URL；不需要 OAuth 客户端 ID 或密钥；
3. 选择 Connect，登录 Planitude 并允许访问。

在 Team 和 Enterprise 方案中，由 Owner 在 Organization settings › Connectors 中添加连接器，之后每位成员使用自己的账号连接^[4]。该连接器适用于 claude.ai、Claude Desktop 和移动应用。

连接 Gemini#

在 Gemini 应用中，Google 目前只向美国境内、年满 18 岁、已开启 Gemini 应用活动记录的个人账号开放基于 MCP 的自定义应用；不支持工作或学校账号^[5]。如果你符合这些条件：

1. 在 gemini.google.com 打开 Settings › Connected Apps，选择 Add a custom app^[5]；
2. 粘贴服务器 URL，并按照提示操作；
3. 登录 Planitude 并允许访问。

连接需要在网页版中创建，但在移动应用中同样可以使用^[5]。对于其他所有账号，仍可以使用下一节介绍的 Gemini CLI。

开发者工具：Claude Code、Codex、Cursor 和 VS Code#

面向开发者的助手既支持 OAuth，也支持 API 密钥：

• Claude Code：claude mcp add --transport http planitude https://planitude.app/mcp；首次使用时会打开 Planitude 请求授权^[6]。
• Codex：在 ~/.codex/config.toml 中添加 [mcp_servers.planitude] 配置块，适用于 CLI、应用和 IDE 扩展。
• Gemini CLI：gemini mcp add --transport http planitude https://planitude.app/mcp。
• VS Code 与 GitHub Copilot：在 .vscode/mcp.json 中添加服务器，工具会出现在 Agent 模式中^[7]。
• Cursor：在 ~/.cursor/mcp.json 或项目文件中添加服务器^[8]。

在 Planitude 的 个人资料 › API 密钥 中可以找到已经填好地址和密钥占位符的配置示例。从 Jira 到 Teams 的其他集成，请见集成页面和《集成指南》；API 和 Webhook 请见开发者页面。

常见问题#