project.config.get
read读取项目编号、状态、权限、工作日、提醒、客户 portal、文件版本及开票基本设定。
建议先读取
-
治理与审批
只读；作所有项目写入前的基准设定。
安全说明
不得回传 secret、私有 integration token 或超出角色权限的设定。
项目管理 MCP 工具
项目管理 MCP 工具按项目交付流程设计，覆盖签署报价交接、客户 brief、SOP 模板、项目、任务、负责人、期限、依赖、里程碑、文件版本、留言决策、风险、工时成本、客户 portal 审批、进度预警、里程碑开票、close-out report 及 audit。
project.workflow_templates.list
read列出可用项目 SOP 模板、适用业务、阶段、任务数、预设负责角色及版本。
建议先读取
project.config.get
治理与审批
只读；建立项目计划或套用模板前使用。
安全说明
只显示授权部门可用模板，避免泄露内部流程。
project.workflow_template.get
read读取单一模板的阶段、任务、依赖、检查点、交付物、预设期限及风险提示。
建议先读取
project.workflow_templates.list
治理与审批
只读；AI 拆任务或批量建立任务前必须先读。
安全说明
不得修改模板；需标示模板版本，避免套用过期 SOP。
project.signed_sources.list
read查询已签署报价、确认订单或合约来源，支援自动建立对应项目。
建议先读取
project.config.get
治理与审批
只读；自动开项目前先核对来源状态。
安全说明
只读取已确认/已签署来源；不可把草稿报价当作可开项目。
project.client_brief.get
read读取客户需求、范围、文件、限制、交付标准、沟通纪录及已确认决策。
建议先读取
project.signed_sources.list
治理与审批
只读；AI 建计划前必须以 brief 作主要依据。
安全说明
客户敏感资料按项目权限遮蔽；不得引用未确认聊天片段作正式范围。
project.projects.list
read按客户、负责人、状态、阶段、交付日或健康度查询项目。
建议先读取
project.config.get
治理与审批
只读；避免重复建立项目或查找进度使用。
安全说明
按用户可见范围回传项目，避免跨客户或跨部门泄露。
project.project.get
read读取项目目标、范围、客户、负责人、成员、阶段、预算、风险及交付纪录。
建议先读取
project.projects.list
治理与审批
只读；任何项目更新、任务批量建立或 close-out 前必须先读。
安全说明
内部成本、合约及客户文件需按角色遮蔽。
project.members.list
read列出项目成员、角色、权限、所属部门、可负责任务类型及客户 portal 可见性。
建议先读取
project.project.get
治理与审批
只读；分配任务、权限或客户可见资料前使用。
安全说明
不得暴露员工私人资料或非项目相关权限。
project.workload.list
read读取团队成员任务量、可用时间、逾期任务、外勤安排及 overload 风险。
建议先读取
project.members.list, project.tasks.list
治理与审批
只读；自动任务指派、调配或延期预警前使用。
安全说明
避免把个别员工绩效公开比较，只提供营运需要的负载资料。
project.stages.list
read读取项目阶段、看板栏位、流程次序、入口条件、完成条件及客户可见设定。
建议先读取
project.project.get, project.workflow_template.get
治理与审批
只读；更新看板或里程碑前使用。
安全说明
不可把内部阶段误标为客户可见。
project.milestones.list
read查询里程碑、交付日期、完成状态、签收状态、收款节点及相关任务。
建议先读取
project.project.get
治理与审批
只读；里程碑完成、客户批核及开票前使用。
安全说明
不得向未授权角色显示合约金额或开票条款。
project.tasks.list
read按项目、阶段、负责人、状态、优先级、到期日或逾期查询任务。
建议先读取
project.project.get
治理与审批
只读；进度追踪、预警、分配或批量更新前使用。
安全说明
只回传可见任务；客户 portal 任务需遵守可见范围。
project.task.get
read读取任务描述、负责人、期限、状态、依赖、留言、附件、工时及完成标准。
建议先读取
project.tasks.list
治理与审批
只读；更新任务、完成任务或记录决策前必须先读。
安全说明
敏感留言和附件按权限遮蔽。
project.dependencies.list
read查询任务前后依赖、阻塞关系、关键路径及延误传导影响。
建议先读取
project.tasks.list
治理与审批
只读；排程风险 preview 和依赖更新前使用。
安全说明
不得基于不完整任务资料自动改变关键路径。
project.files.list
read列出项目文件、合约、图纸、报告、版本、拥有人、关联任务及存取权限。
建议先读取
project.project.get
治理与审批
只读；附件、版本管理或客户 portal 发布前使用。
安全说明
不得把内部文件误设为客户可见。
project.file_version.get
read读取单一文件版本、变更摘要、签收状态、上载者及可追溯来源。
建议先读取
project.files.list
治理与审批
只读；改版、交付或客户签收前核对。
安全说明
避免用旧版本作正式交付；需清楚标示 latest。
project.comments.list
read读取项目或任务留言、现场回报、客户回复、阻塞说明及跟进内容。
建议先读取
project.task.get
治理与审批
只读；整理决策、close-out 或 follow-up 前使用。
安全说明
私人备注与内部留言不可流入客户报告。
project.decisions.list
read查询已确认决策、客户修改、批核纪录、责任人及生效范围。
建议先读取
project.comments.list, project.audit_logs.list
治理与审批
只读；避免将未确认留言当成决策。
安全说明
决策必须有来源、时间和批准人。
project.risks.list
read读取项目风险、阻塞、延期原因、影响范围、缓解行动及负责人。
建议先读取
project.project.get, project.tasks.list
治理与审批
只读；生成风险摘要或排程 preview 前使用。
安全说明
风险摘要需区分事实、推断和建议。
project.time_logs.list
read查询任务或项目的工时纪录、人员、日期、审批状态及成本归属。
建议先读取
project.project.get, project.tasks.list
治理与审批
只读；成本分析、盈亏或 close-out 前使用。
安全说明
薪酬推算及个人绩效资料需按权限保护。
project.expenses.list
read查询项目物料、采购、外判、交通及其他开支，包含单据和审批状态。
建议先读取
project.project.get
治理与审批
只读；项目成本、利润和报告前使用。
安全说明
供应商敏感条款和单据需按角色遮蔽。
project.client_portal_state.get
read读取客户 portal 可见阶段、任务、文件、交付物、批核请求及留言权限。
建议先读取
project.project.get, project.files.list, project.milestones.list
治理与审批
只读；发布或请求客户批核前核对。
安全说明
严格区分内部视图与客户视图。
project.health_summary.get
read读取项目健康度、完成率、逾期、阻塞、负载、成本偏差及交付风险摘要。
建议先读取
project.tasks.list, project.dependencies.list, project.time_logs.list, project.expenses.list
治理与审批
只读；主管 dashboard、预警及 close-out 使用。
安全说明
聚合显示为主，避免公开个人敏感绩效。
project.audit_logs.list
read查询项目、任务、文件、决策、批核、工时、成本及开票操作纪录。
建议先读取
project.project.get
治理与审批
只读；用于追踪争议、错误、责任和批核历史。
安全说明
audit logs 只供授权管理员查看。
project.brief_to_plan.preview
preview根据客户 brief 和 SOP 模板预览项目计划、任务拆分、负责人、期限、检查点和风险。
建议先读取
project.client_brief.get, project.workflow_template.get, project.workload.list
治理与审批
必须先 preview；项目负责人批核后才可建立项目及任务。
安全说明
明确标示 AI 推断项，不能把未确认范围写入正式项目。
project.template_apply.preview
preview预览套用 SOP 模板后会新增的阶段、任务、依赖、检查点、交付物和提醒。
建议先读取
project.workflow_template.get, project.project.get, project.tasks.list
治理与审批
套用模板前需确认不会重复建立任务或覆盖现有流程。
安全说明
不得覆盖已完成任务或已签收里程碑。
project.task_batch.preview
preview预览批量建立或更新任务的负责人、期限、依赖、提醒、客户可见性和重复检查。
建议先读取
project.brief_to_plan.preview, project.tasks.list, project.members.list
治理与审批
批量任务写入需由项目负责人批核。
安全说明
需要 idempotency；避免重复建立同一批任务。
project.assignment.preview
preview预览任务指派或资源重配后的工作量、overload、期限冲突及替代人选。
建议先读取
project.workload.list, project.members.list, project.tasks.list
治理与审批
大量重配或跨部门指派需主管批核。
安全说明
不得把任务指派给无权限、不可用或明显超载成员。
project.schedule_risk.preview
preview预览延期、依赖、关键路径、资源不足、成本偏差及客户批核延误风险。
建议先读取
project.dependencies.list, project.health_summary.get, project.client_portal_state.get
治理与审批
风险建议需由负责人确认后才更新计划或发提醒。
安全说明
风险预测需列出依据，不可假装为已发生事实。
project.client_portal_publish.preview
preview预览将阶段、文件、交付物、任务进度或批核请求发布到客户 portal 的可见内容。
建议先读取
project.client_portal_state.get, project.files.list, project.milestones.list
治理与审批
对客户可见内容必须由授权人批核。
安全说明
防止内部留言、成本或未完成文件曝光。
project.milestone_invoice.preview
preview预览里程碑完成后可开票金额、合约条款、客户批核、税项及会计系统同步影响。
建议先读取
project.milestones.list, project.client_portal_state.get, project.expenses.list
治理与审批
开票前需确认里程碑完成及客户/内部批核。
安全说明
不得在未达条件时自动开票；避免重复开票。
project.closeout_report.preview
preview预览完工总结报告，包含里程碑、成果、文件、签收、工时成本、风险及后续事项。
建议先读取
project.project.get, project.milestones.list, project.files.list, project.time_logs.list, project.expenses.list, project.decisions.list
治理与审批
正式生成或交客前需项目负责人批核。
安全说明
报告需排除内部成本、私人留言及未公开决策。
project.project.create
write建立新项目，设定客户、目标、范围、负责人、团队、阶段、预算及初始状态。
建议先读取
project.brief_to_plan.preview
治理与审批
必须由项目负责人批核 preview 后建立。
安全说明
需检查重复项目、权限和 idempotency。
project.project.update
write更新项目范围、状态、优先级、负责人、交付日、预算或客户可见设定。
建议先读取
project.project.get, project.schedule_risk.preview
治理与审批
影响范围、交付日、预算或客户可见资料需批核。
安全说明
保留变更原因及 audit；不得静默改动已确认范围。
project.project.create_from_signed_source
write根据已签署报价、订单或合约建立项目，连结客户 brief、金额、交付项和负责人。
建议先读取
project.signed_sources.list, project.client_brief.get, project.brief_to_plan.preview
治理与审批
必须确认来源已签署且未曾开项目。
安全说明
不得由草稿报价或未确认订单开项目。
project.workflow_template.upsert
write新增或更新 SOP 模板、阶段、预设任务、角色、依赖、检查点及交付标准。
建议先读取
project.workflow_template.get, project.template_apply.preview
治理与审批
模板变更会影响日后项目，需管理员批核。
安全说明
保留版本；不得追溯覆盖已启动项目。
project.task_batch.create
write批量建立任务、负责人、期限、依赖、检查点、提醒及客户可见设定。
建议先读取
project.task_batch.preview
治理与审批
必须根据已批核 task batch preview 执行。
安全说明
需 idempotency；检查重复任务和无效负责人。
project.task.upsert
write新增或更新单一任务的描述、负责人、期限、优先级、依赖、交付标准及可见性。
建议先读取
project.task.get, project.assignment.preview
治理与审批
重大期限、负责人或客户可见变更需批核。
安全说明
不得覆盖完成任务的成果纪录。
project.task.status_update
write更新任务状态、进度、阻塞、现场回报、完成百分比或下一步。
建议先读取
project.task.get, project.dependencies.list
治理与审批
一般进度可由负责人更新；完成或阻塞解除需按流程确认。
安全说明
状态变更需留时间和操作者；不可跳过必要前置任务。
project.dependency.upsert
write新增或更新任务依赖、阻塞关系、关键路径标记和延期传导规则。
建议先读取
project.dependencies.list, project.schedule_risk.preview
治理与审批
影响交付日期或多人任务时需负责人批核。
安全说明
避免循环依赖；需重新计算风险。
project.milestone.upsert
write新增或更新里程碑、交付日、完成条件、客户签收要求及开票触发条件。
建议先读取
project.milestones.list, project.schedule_risk.preview
治理与审批
改动交付日、收款节点或客户批核要求需批核。
安全说明
不得改动已签收里程碑而无 audit。
project.milestone.complete
write标记里程碑完成，连结交付物、签收、完成日期、后续任务及可开票状态。
建议先读取
project.milestones.list, project.files.list, project.client_portal_state.get
治理与审批
完成里程碑前需检查必需任务和交付物。
安全说明
不可完成仍有 blocking task 的里程碑，除非管理员批核例外。
project.member.assign
write新增、移除或更改项目成员角色、任务负责范围及权限。
建议先读取
project.members.list, project.assignment.preview
治理与审批
权限提升、跨部门或大量指派需主管批核。
安全说明
不得让无授权成员看到客户敏感文件。
project.file.attach
write将文件、合约、图纸、相片、报告或签收纪录加入项目或任务并设定版本和可见性。
建议先读取
project.files.list, project.file_version.get
治理与审批
客户可见或合约文件需授权人确认。
安全说明
扫描档案类型及权限；避免覆盖最新版本。
project.comment.add
write为项目或任务新增留言、现场更新、阻塞说明、客户回复摘要或后续事项。
建议先读取
project.task.get, project.comments.list
治理与审批
一般留言按角色写入；客户可见留言需明确标示。
安全说明
不得把私人内部留言错设为客户可见。
project.decision.record
write记录已确认决策、修改要求、批核结果、影响范围、来源及责任人。
建议先读取
project.decisions.list, project.comments.list, project.audit_logs.list
治理与审批
决策必须由授权人或客户确认后写入。
安全说明
不得把 AI 摘要直接当成已确认决策。
project.client_approval.request
write向客户或内部负责人发出阶段成果、文件、修改或里程碑批核请求。
建议先读取
project.client_portal_publish.preview
治理与审批
必须先确认发布内容和收件人。
安全说明
避免发送内部文件、成本或未完成草稿给客户。
project.client_approval.record
write记录客户或内部批核、拒绝、修改要求、签收时间及附件。
建议先读取
project.client_portal_state.get, project.decisions.list
治理与审批
批核结果必须有来源、时间和身份验证。
安全说明
不可伪造客户批核；所有 sign-off 需可追溯。
project.time_log.create
write为任务或项目记录工时、工作内容、日期、人员、可收费状态及审批状态。
建议先读取
project.task.get, project.time_logs.list
治理与审批
员工可提交；修改已审批工时需主管批核。
安全说明
防止重复工时和超出合理范围输入。
project.expense.record
write记录项目物料、采购、外判或交通开支，连结单据、供应商、任务及审批流程。
建议先读取
project.expenses.list, project.project.get
治理与审批
超出预算或缺少单据需主管批核。
安全说明
防止重复报销；敏感单据需受权限保护。
project.alert_rule.upsert
write新增或更新任务逾期、接近限期、阻塞、overload、客户未批核或成本超支提醒规则。
建议先读取
project.config.get, project.schedule_risk.preview, project.health_summary.get
治理与审批
影响多人或客户通知的规则需主管批核。
安全说明
避免短时间重复通知；遵守通知频率和收件人权限。
project.milestone_invoice.create
write按已完成且已批核里程碑建立发票或会计系统开票请求。
建议先读取
project.milestone_invoice.preview
治理与审批
必须由财务或授权负责人批核。
安全说明
需 idempotency；检查是否已开票及合约条款。
project.action_request.status
status查询项目管理写入请求、批核、执行、失败、重试及 audit 状态。
建议先读取
project.audit_logs.list
治理与审批
只读状态；用于追踪批量任务、客户批核、开票和报告生成。
安全说明
不得透过 status endpoint 重新执行写入。