API + MCP

让生态使用同一套术语与标准

API v2 提供完整双语规范、受控术语和分账草案契约。MCP 让 Agent 读取与起草,但发布、审批、股权写入和付款始终留给获授权的人。

MCP protocol2025-11-25

sha256:5098760caa5105bf

公共标准 API

匿名读取完整双语规范、术语、TaskSpec、角色、政策、模板与品牌快照。正式写操作必须通过 TableUser 资源授权并 fail closed。

GET /api/v2/manifest

MCP Streamable HTTP

协议固定为 2025-11-25。资源公开读取,校验和草案工具需要生态 API Key。

POST /mcp

可调用资源

  • opc://manifest/current
  • opc://glossary/current
  • opc://standards/{sectionId}
  • opc://taskspec/{taskCode}
  • opc://roles/{role}
  • opc://policy/{policyId}
  • opc://brand/current
  • opc://split-templates/{version}
  • opc://organizations/{id}
  • opc://split-projects/{id}
  • opc://settlement-runs/{id}
  • opc://equity-ledgers/{legalEntityId}

校验与草案工具

  • resolve_term
  • validate_standard_reference
  • validate_taskspec
  • compare_standard_versions
  • draft_alignment_report
  • recommend_role
  • draft_onboarding_profile
  • assess_readiness
  • propose_task_path
  • simulate_operating_plan
  • draft_split_project
  • validate_split_rule
  • calculate_draft_settlement
  • explain_settlement
  • compare_rule_versions
  • draft_invitation

稳健性边界

  • AI 输出只作为建议,必须由人确认。
  • 付款、凭证、分账修改与最终提交不暴露为自主工具。
  • MCP 不得发布规则、覆盖汇率、批准账本或写入股权事件。
  • 工具密钥只存哈希,日志不记录密钥和敏感原文。