ThroughLine MCP 适配器

MCP 不是必选项,Agent API 才是主路径。

ThroughLine 通过 Agent Key + Agent API 让 WorkBuddy、Cursor 或自定义 Agent 读取和维护目标、项目和任务。MCP 仅作为客户端明确需要 MCP server 配置时的可选适配器。

可选 MCP 适配器地址
https://throughline.cn/api/mcp
认证方式:Authorization: Bearer <Agent Key>

MCP 适配器暴露这些工具

这些工具只是 Agent API 的 MCP 包装。普通接入优先在设置页复制 Agent API 配置;只有客户端要求 MCP server 配置时,才复制可选 MCP 配置。

get_workspace_context只读

读取领域、年度目标、项目和近期开放任务。

search_entities只读

搜索领域、目标、项目、任务和子任务。

get_entity只读

查看单个实体详情。

preview_actions预览

生成写入、删除、批量操作预览,不直接改数据。

confirm_action确认

用户提供确认码后执行被冻结的操作。

restore_deleted恢复

为软删除内容生成恢复预览。

plan_month规划

读取事实上下文,辅助生成月计划。

review_progress复盘

读取任务和月记录,辅助周/月/年复盘。

AI 可以帮你整理,但不能绕过你

Agent Key 只存哈希,完整 Key 只展示一次。
读、写、删除、批量操作有独立权限 scope。
写入、删除和批量动作必须先生成预览。
确认前不会改动数据,确认码过期后自动失效。
删除默认软删除,可通过恢复工具找回。
调用会进入审计与使用统计,异常 Key 可立即停用。

推荐连接流程

1

命名并生成 Key

来源名称由你自定义,只用于识别用途和审计。

2

复制 Agent API 配置

把 base URL、端点和 Bearer Key 配到你的 Agent。

3

粘贴并测试

需要 MCP 时再复制适配配置;写入前必须先看到预览和确认码。

适合这样使用

把这份产品方案拆成一个项目和五个任务。
检查本月 AI 助手接入项目还有哪些没完成。
把今天未完成任务推迟到明天,先给我预览。
根据我的年度目标,生成 9 月的三个关键推进项。

常见判断

我该用 MCP 还是 Agent API?

默认用 Agent API。它是 ThroughLine 的核心业务接口,能读取、搜索、预览和确认写入。MCP 只是可选适配器。

普通 ChatGPT 或手机 ChatGPT 能直接用吗?

普通聊天框不能只靠粘贴 Key 自动调用 API。需要支持 Actions、工具调用或自定义 HTTPS 请求的 Agent 环境。

AI 会不会直接删掉数据?

不会。删除需要 delete scope,并且仍然先生成预览和确认码;执行后也是软删除,可恢复。

MCP 能创建习惯吗?

不能。MCP 适配器不扩大 Agent API 的能力边界,习惯需要在 ThroughLine 内创建、编辑和打卡。