TOALDO SUPPORT · AGENT & API

API / MCP 与智能体接入

将 Codex、WorkBuddy、企业自建智能体或其他支持 MCP / REST 的 Agent 连接到 TOALDO。外部智能体通过受控 Agent Gateway 工作，不直接访问 TOALDO 内部 Worker、Shell 或生产节点。

进入 API 管理查看 OpenAPI

接入方式

MCP

适合 Codex、WorkBuddy 及支持远程 HTTP MCP 的智能体。

https://api.toaldoagent.com/api/agent/mcp

REST

适合企业系统、自建 Agent 与工作流编排器。

https://api.toaldoagent.com/api/agent/v1

如何获取 API Key

  1. 先登录 TOALDO 官网。
  2. 进入“个人中心 → Agent & API / API 管理”。
  3. 为 Codex、WorkBuddy 或企业 Agent 分别创建独立 Key。
  4. 按需要选择读取、项目、文件、任务等 Scope，并限定允许的生产服务与自动执行设计费上限。
  5. 完整 Secret 只显示一次，请保存到智能体或企业的安全凭据环境中。

安全提示：不要把完整 API Key 粘贴给智能客服、公开对话、工单或普通文档。Kimi 可以介绍接入方法，但不会要求你提供完整 Secret。

Codex 示例

[mcp_servers.toaldo]
url = "https://api.toaldoagent.com/api/agent/mcp"
bearer_token_env_var = "TOALDO_API_KEY"
tool_timeout_sec = 180

把完整 Key 保存到运行 Codex 的安全环境变量 TOALDO_API_KEY，不要直接写进公开配置仓库。

WorkBuddy / 其他 MCP Agent

MCP URL: https://api.toaldoagent.com/api/agent/mcp
Authorization: Bearer <TOALDO_API_KEY>

如果客户端支持自定义 HTTP MCP / Connector，可使用同一 MCP 地址与 Bearer Key。不同 Agent 建议使用独立 Key，便于撤销与审计。

REST 能做什么

  • 读取设计费钱包状态。
  • 列出、读取或按授权创建项目。
  • 向项目上传文件。
  • 在提交前估算任务。
  • 提交、查询与取消生产任务。
  • 读取进度、成果列表并下载成果。
  • 查看该 Key 的写操作与审计记录。

创建项目、上传文件、提交任务、取消任务等写操作应使用幂等键，避免网络重试造成重复业务操作。

Kimi 智能客服可以回答什么

你可以直接在 TOALDO 智能对话里问：

“怎么把 Codex 接到 TOALDO？”

Kimi 应说明 MCP 地址、API Key 创建位置、环境变量和权限范围。

“WorkBuddy 怎么对接？”

Kimi 应说明 HTTP MCP / Connector、Bearer Key、安全存储和独立 Key 建议。

“企业智能体可以调用哪些能力？”

Kimi 应说明 REST / MCP、项目、文件、任务、进度、成果与受控审批。

“API Key 发给你可以吗？”

Kimi 应明确回答：不要发送完整 Key；应保存在安全凭据环境中。

边界

Agent API 是 TOALDO 对外的受控业务接口，不是内部生产网络的直通代理。外部 Agent 不应获得 Worker、Shell、内部端口、服务器文件系统或支付密钥的直接访问权。涉及费用超限、权限不足或敏感操作时，应进入明确审批或人工流程。