CC CCProject 使用帮助 网络计划、横道图与投标图纸操作手册
帮助首页MCP 会把哪些内容提供给 AI？

MCP 会把哪些内容提供给 AI？

CCProject 启动 MCP 服务后，**不会自动把整个项目文件或全部项目数据发送给 AI**。AI 只能看到软件明确公开的 MCP 接口，并且只有实际调用某项工具时，才会交换该工具需要的参数和执行结果。

本页主要供用户了解数据范围和隐私边界。具体工具名称和参数请查看 MCP 工具清单及参数说明。

MCP 连接后会提供什么

内容提供时间说明
MCP 服务说明建立连接时告诉 AI 该服务用于操作当前打开的 CCProject 项目
工具定义AI 获取 tools/list 时包括工具名称、功能说明、输入参数、返回字段和安全标记
调用参数AI 调用某项工具时只发送该次操作所需的标题、日期、任务/节点 GUID、工期、排序位置、移动方向等参数
查询结果AI 调用 ccproject_query 时按指定范围返回字段字典、项目与图形设置、工作明细、节点、关系、排程分析、资源、WBS、B/E/F 进度、R 调整方案或 A 分析报告；支持分页和对象筛选
预览与执行结果CCProject 完成调用后返回成功或失败、revision、预计/实际差异以及错误说明
资源优化结果AI 调用分析、预演或应用工具时返回资源冲突、候选工作、前后超配、预算/停止原因和预览令牌；日期与资源曲线由 CCProject 权威重算
绘图预览AI 调用 ccproject_export_preview 时在本机临时目录生成 PNG，并把路径和文件信息返回给客户端

例如，要求把节点 7 → 8 的工作向下移动两行时，可以先只查询该节点对，再预览和执行移动。除非 AI 明确调用 scope: "all" 的查询，否则不会同时返回全部工作、全部节点和全部关系。

当前可查询与不可查询的项目内容

ccproject_query 当前可以按需返回：

  • 公开数据字典，说明数据域、查询范围、输入/计算/持久化/临时分类和敏感信息规则；
  • 项目核心设置及项目快照 554 个持久化标量、53 个基础数组（持久化直接字段 607/607），以及 110 个复合字段目录和按字段分页读取；27 个会话专用标量单独分类，合计覆盖项目快照顶层 744/744 个字段。外部主数据源 URI、本机文件路径和图片路径默认省略，只有明确指定 includeSensitive=true 才返回；
  • 项目快照之外的 B/E/F/R/A 记录：分支、执行批次、执行任务、执行变更、预测、前锋线和分析报告等九种记录共 136/136 个字段；分支快照仍按上述 744 字段方式读取，分析报告输出文件索引默认省略；
  • 工作完整明细（当前 TTaskRecord 238/238 个标量字段），以及双代号/横道图的纸张、标题、列和核心绘图设置；
  • 项目摘要、当前文件名、视图、排程模式和只读/修改状态；
  • 工作 ID/GUID、名称、日期、工期、进度、起止节点号、起止节点 GUID 和绘图行；
  • 节点号、节点 GUID、绘图行和歧义标记；
  • 双代号工作节点边，以及任务前后置关系和时距。
  • 任务当前顺序、WBS 层级和双代号工作/节点绘图行；自动布局只在实际预览或执行时处理这些内存数据；
  • 当前项目的 WBS 父子结构、各层级工作数量、计划起止、进度和同单位工程量汇总；
  • 指定 B/E/F 数据链下的 WBS 实际进度、预计起止、延期、异常和关键工作汇总；
  • 排程摘要、关键线路顺序、关键线路关系、项目及关键线路工期；
  • 每项逻辑工作的最早/最迟起止、总时差、自由时差、关键标记和里程碑标记；
  • 指定 asOf 日期下的逾期工作，以及已有延误量、截止日期突破和负时差原因。
  • 资源库字段，以及每项资源的计划总量、计划工时、平均用量、容量、峰值和超配标记；
  • 工作与资源的分配记录，包括计划/实际数量、逻辑工作身份和排程起止时间；
  • 计划资源负荷连续区间和超配区间，可按资源和日期范围筛选。
  • 关系 5/5、日历 19/19、资源 14/14 和资源分配 10/10 个模型字段；字段可读完整不表示对应字段均允许写入；
  • 计划基准和基准工作，以及执行批次列表；
  • 指定执行批次的实际开始/完成、完成百分比、剩余工期和变更说明；
  • 计划—实际—预测起止偏差、偏差依据、关键与异常标记；
  • 项目中已经保存的预测快照和逐工作预测结果；查询不会重新计算或生成预测。
  • 已保存的 R 调整方案及其来源 B/E/F、审批/发布状态、工作变化计数和逐工作差异；
  • 已保存的 A 分析报告及其来源数据链、筛选条件、标题、说明、结论和选中工作明细；查询不会生成、审批或发布 R/A 数据。

成功查询还返回 dataSchemaVersion、signatureAlgorithm 和 resultSignature。结果签名用于判断同一查询结果是否变化，不是完整项目指纹，也不能替代修改时使用的 revision。

下列内容当前仍不会自动提供，也没有对应的完整查询范围：

  • 项目文件本身及完整文件内容；
  • 项目文件的原始数据库内容和未公开字段；
  • 逐日展开的完整资源报表和按实际完成记录计算的资源曲线；当前负荷/超配范围只采用计划口径；
  • 系统审计字段、计算中间缓存、临时选区、鼠标悬停、滚动位置和未登记的内部调试状态；
  • 打印文件和其他未明确导出的文件；绘图预览只有调用导出工具时才生成。

如果用户把文字、截图或项目文件另外粘贴、上传给 AI，这属于 AI 客户端自身的数据输入，不是 CCProject MCP 自动发送。

本机 MCP 不等于项目不上网

CCProject MCP 只监听本机地址 127.0.0.1，外部电脑不能直接通过这个地址访问当前服务。但 AI 客户端可能需要把用户的提问、工具调用参数和调用结果发送给其模型服务。

因此应分别理解：

  1. **CCProject MCP 的范围**：负责本机 CCProject 与 AI 客户端之间的工具调用，不主动上传整个项目。
  2. **AI 客户端的范围**：如何保存和处理对话、附件、调用参数及结果，应以该 AI 客户端自己的隐私规则为准。

用户使用时的检查原则

  1. 连接前确认当前打开的是需要操作的项目。
  2. 在 AI 调用工具前，检查准备执行的操作及关键参数。
  3. 删除工作时，必须确认准确节点对，并明确选择“合并节点”或“保留并断开节点”。
  4. 执行后回到 CCProject 检查图面和排程结果。
  5. MCP 工具不会自动保存项目；查询和预览完成后也不会写回项目文件，确认无误后再由用户保存。
  6. 不使用 MCP 时可以停止服务。

资源优化的数据边界

当前版本已经开放资源库、工作资源分配、资源负荷/超配查询，以及资源优化分析、预演和应用。AI 可以提供工期或起止候选等可变输入，但不能直接指定软件的最终计算结果；CCProject 会按工作日历、逻辑关系、资源用量和容量重新计算日期、关键线路及资源曲线。预演不修改项目，正式应用必须携带预演令牌并通过再次权威校验，超时、取消、预算到限、令牌不匹配或容量校验失败均不保留修改。

以后软件新增或调整持久化业务功能时，数据范围仍应根据真实 tools/list、命令目录和实际返回结果同步更新，不能只根据功能设想提前写入。