project.config.get
read讀取項目編號、狀態、權限、工作日、提醒、客戶 portal、文件版本及開票基本設定。
建議先讀取
-
治理與審批
只讀；作所有項目寫入前的基準設定。
安全說明
不得回傳 secret、私有 integration token 或超出角色權限的設定。
項目管理 MCP 工具
項目管理 MCP 工具按項目交付 workflow 設計，覆蓋簽署報價交接、客戶 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 重新執行寫入。