Ganty MCP

Ganty MCP

Ganty 是一款甘特图 SaaS，内置 Model Context Protocol（MCP） 服务，可让 Claude Desktop 和 Claude Code 等 AI 客户端通过自然语言操作项目，并在服务端计算关键路径和班次影响，而不是让大模型来计算。

状态：v1.0.0 — 生产端点：https://ganty.app/api/mcp（Streamable HTTP） 所有 Ganty 方案均可免费使用，包括 Free。

有何不同

大多数 MCP 服务通过现有 API 提供 CRUD 操作。Ganty 还提供在服务端进行计算并返回 JSON 的计算工具——因此大模型无需推理日期、依赖关系或关键路径。

• get_critical_path — 使用考虑进度的剩余工期进行正向／反向 CPM 计算。按顺序返回关键路径上的任务、每项任务最早／最晚开始和完成时间、时差以及预计结束日期。计算前会检测循环依赖，并返回 error: 'cyclic_dependency'，避免卡住或猜测。
• reschedule_and_propagate — 模拟或提交任务时间调整。默认模式为 dry_run（不写入数据库）。仅向后级联会遵守固定任务（progress=100 或位于 pinned_task_ids 中的任务），并报告 conflicts，而不是覆盖任务。commit 模式会将所有操作包装在一个全有或全无的事务中。

快速开始

1. 签发 MCP 令牌：在 Ganty 中，依次打开仪表板 → Settings → MCP Integration → "Issue new token"。
2. 配置 Claude Desktop（claude_desktop_config.json）或 Claude Code（项目根目录下的 .mcp.json）：

   {
     "mcpServers": {
       "ganty": {
         "url": "https://ganty.app/api/mcp",
         "headers": { "Authorization": "Bearer YOUR_TOKEN" }
       }
     }
   }
   

3. 重启 Claude 并尝试输入提示词：
   • "List my Ganty projects"
   • "What's the critical path for the e-commerce rebuild project?"
   • "If I push the payments task by +3 days, when does release ship?"

完整的设置指南：https://ganty.app/guide/mcp-integration

工具

读取工具（只读令牌和写入令牌均可见）

工具	说明
list_workspaces	令牌用户所属的工作区
list_projects	工作区中的项目
list_tasks	项目中的任务（可按名称／状态／负责人筛选）
get_task	单个任务及其负责人和依赖关系
list_milestones	项目中的里程碑
get_critical_path	服务端 CPM 计算，包含时差和总工期

写入工具（仅限具有写入权限范围的令牌）

工具	说明
create_project、delete_project	项目生命周期管理
create_task、update_task、delete_task	任务生命周期管理
set_task_progress	更新任务进度（自动设置状态）
add_dependency	在两个任务之间添加完成到开始依赖关系
create_milestone	添加里程碑
reschedule_and_propagate	调整任务时间，沿依赖关系级联，可试运行或提交

即使在 dry_run 模式下，reschedule_and_propagate 也会被归类为写入工具（它与提交操作共用相同的计算路径，而且我们不希望只读令牌运行不受限制的模拟）。

v1 范围和限制

我们宁可明确说明不支持，也不愿悄然给出错误答案。计算工具的每个响应都包含一个 limitations 数组。

• 依赖类型：仅支持完成到开始（Ganty 的架构不对 SS／FF／SF 建模）
• 日历：默认使用日历日；business_days: true 仅跳过周六和周日（没有节假日日历表）
• v1 不支持资源日历
• v1 忽略跨多个时段的任务（extraSegments）；计算仅使用每项任务的主要开始／结束时间
• 固定任务：progress=100 的任务会自动固定；可通过 pinned_task_ids 指定其他固定任务
• 仅向后级联：必要时将后续任务向后推迟，不会提前

架构

• 传输方式：Streamable HTTP（通过 HTTP POST 传输 JSON-RPC 2.0）— https://ganty.app/api/mcp
• 身份验证：Bearer 令牌（gnty_...），从 Ganty 仪表板签发。令牌的权限范围为 read 或 write。
• 速率限制：读取每分钟 120 次请求，写入每分钟 30 次请求（按令牌计算）
• 审计日志：每次写入调用都会记录操作、操作者、IP 和参数摘要
• 原子性：reschedule_and_propagate 的 commit 模式由 Prisma 事务封装；发生冲突时会中止，不执行写入

计算逻辑由纯 TypeScript 函数实现，并通过 28 项黄金测试验证，这些测试断言了具体日期和天数（线性链平移、菱形合并、2 秒内的环路检测、考虑进度的剩余工期、手工计算的 CPM 和时差、工作日模式、滞后天数处理、仅向后级联）。

链接

• 产品介绍页：https://ganty.app/integrations/mcp
• 设置指南：https://ganty.app/guide/mcp-integration
• Claude × Gantt 指南：https://ganty.app/blog/claude-gantt-chart
• 设计文章：https://ganty.app/blog/mcp-server-side-calculation-engine
• 工具示例：https://ganty.app/blog/mcp-gantt-chart-5-examples
• 故障排除：https://ganty.app/blog/mcp-setup-troubleshooting
• 注册（免费 5 人套餐）：https://ganty.app/signup

许可证

本文档仓库采用 MIT 许可证。 Ganty 服务本身是托管式 SaaS；每个 Ganty 工作区都包含 MCP 端点功能。