TOCA MCP Server

由 Google Drive 中的 TOCA_OS 业务事实来源治理的 ChatGPT 确定性执行层。

生产状态

该仓库已超越引导阶段。目前的生产基础包括：

• 位于 /mcp 的私有 Streamable HTTP MCP 传输；

• 健康检查/就绪边界；

• Meta OAuth、webhook 与密钥管理边界；

• 由提供商支撑的 Instagram 历史记录/洞察读取；

• Meta Ads 读取能力；

• 持久化 PostgreSQL 调度；

• TOCA 管理的 Instagram 调度工具；

• 一个从 PostgreSQL 认领到期作业的自主单例 Cloud Run 守护进程；

• 幂等的 Instagram 发布，并在重试前进行由提供商支撑的对账；

• 通过短期签名 URL 交付私有 GCS 资产；

• 审计、死信与失败关闭（fail-closed）执行控制。

TOCA_OS / Google Drive 仍是业务事实来源。GitHub 是代码、模式、测试和基础设施的事实来源。外部提供商对外部副作用仍保持权威。

Related MCP server: Instagram Complete MCP Server

当前生产拓扑

ChatGPT
  -> TOCA_OS business policy/context
  -> private TOCA MCP service
       -> typed MCP tools
       -> PostgreSQL scheduled_jobs / audit_events / provider_publications
  -> TOCA-managed Instagram daemon (singleton Cloud Run service)
       -> claimDue()
       -> approval/audit gate
       -> provider reconciliation
       -> idempotent Instagram publication
       -> provider confirmation

调度属于应用层操作，必须使用受保护的 instagram.toca_schedule.* MCP 接口面。Git 提交和应用重新部署不是常规的发布时钟或调度 API。

质量门禁

每个被提升的变更都必须通过：

pnpm install --frozen-lockfile
pnpm format:check
pnpm architecture:check
pnpm lint
pnpm typecheck
pnpm test
pnpm build

关于当前契约，请参阅 docs/architecture/README.md、docs/architecture/routes-capabilities-v1.md、 docs/architecture/toca-managed-instagram-scheduler-v1.md 和 docs/operations/infrastructure-control-plane.md。