TakeFlow 本地连接器 · 接入指南
目录(10 节)
本指南介绍 TakeFlow 本地连接器的安装、使用与常见问题处理方式。按第三节完成安装后,您可以直接用自然语言向 AI 助手描述需求,无需记忆任何命令或参数。
若您更习惯网页阅读,可打开同目录下的
接入指南.html,内容与本文件一致,并支持打印。English version:
接入指南-EN.md/接入指南-EN.html.
| 适用对象 | 使用 TakeFlow 云机坐席的运营人员 |
| 适用版本 | 本地连接器 v2.4.0 |
| 阅读建议 | 首次安装请阅读第二、三节;日常使用参考第四、五节;遇到问题查阅第六节 |
一、连接器能为您做什么
安装连接器后,AI 助手可以在您授权的范围内直接操作 TakeFlow 云机坐席,包括:
- 查询坐席列表与到期时间
- 开机、关机,调取坐席实时画面
- 续费试算与下单
- 向指定坐席的 TikTok 账号发布视频或图片
- 修改账号头像、昵称、简介与网站
- 查询作品播放数据
- 批量检测 TikTok 账号是否仍然存在(封号检测)
- 分析失败任务的录屏,协助定位原因
连接器适用于 WorkBuddy、Codex、Claude Desktop、Cursor、DeepSeek Harness 等可在本机运行程序的桌面客户端,安装一次即可通用。ChatGPT 等纯云端产品无法加载本地连接器,原因与处理方式见第六节。
关于运行方式,有三点说明:
| 无需准备服务器 | 连接器运行在您自己的电脑上 |
| 无需等待审核 | 解压并运行安装程序即可使用 |
| 数据不离开本机 | 登录凭证保存在本地,请求由您的电脑直接发往平台 |
二、安装前的准备工作
1. 一台可联网的电脑
macOS、Windows、Linux 均可。
2. Node.js 18 或更高版本
在终端(Windows 为「命令提示符」)中执行 node -v 查看版本:
- 显示
v18.x、v20.x、v22.x等版本号,表示已满足要求; - 提示找不到命令,请前往 https://nodejs.org/zh-cn 下载 LTS 版本,安装完成后重新执行上述命令。
3. 一个 TakeFlow 账号
即您平时登录 TakeFlow 后台所使用的手机号与密码。
ffmpeg 为可选组件,仅在使用「录屏诊断」功能时需要;若仅提供截图进行分析,则无需安装。如需安装:macOS 执行
brew install ffmpeg,Windows 在 PowerShell 中执行winget install Gyan.FFmpeg。
4. Python 3(可选)
仅在使用「封号检测」功能时需要。在终端执行 python3 --version 查看版本,显示 3.8 或更高即可;macOS 与常见 Linux 发行版通常已自带,Windows 可从 https://www.python.org/downloads/ 安装。
三、安装步骤
第 1 步:解压到固定目录
解压后可见两个文件夹:
TakeFlow-MCP:程序主体,请保留;文档:本指南及配套文档的副本(含英文版),可放置于任意位置,删除不影响使用。
建议放置位置:
- macOS / Linux:
~/TakeFlow-MCP - Windows:
D:\TakeFlow-MCP
请注意以下两点:
- 请勿直接放在「下载」文件夹中使用,该目录可能被系统清理;
- 安装完成后请勿删除或移动该目录。客户端配置中记录的是该路径,一旦移动需要重新安装。
第 2 步:运行安装程序
| 系统 | 操作方式 |
|---|---|
| macOS | 双击 一键安装.command(首次运行可能被系统拦截,处理方法见 3.1) |
| Windows | 双击 一键安装.bat(若出现「Windows 已保护你的电脑」,点击「更多信息」→「仍要运行」) |
| Linux | 在该目录中打开终端,执行 bash 一键安装.sh |
3.1 macOS 首次运行被系统拦截
安装程序未做 Apple 签名,首次双击时系统会提示:
Apple 无法验证“一键安装.command”是否包含可能危害 Mac 安全或泄漏隐私的恶意软件。
这是系统对未签名脚本的常规保护提示,并非病毒警告。按以下步骤放行一次即可:
- 点击「好」关闭提示;
- 打开「系统设置」→「隐私与安全性」;
- 在「安全性」区域可看到「已阻止“一键安装.command”以保护 Mac」,其右侧有「仍要打开」;
- 点击「仍要打开」,输入电脑密码或使用触控 ID;
- 再次双击
一键安装.command,在弹窗中点击「打开」。
若未出现「仍要打开」,可先在文件上右键选择「打开」,再返回查看。 如仍无法运行,可在该目录打开终端执行
bash 一键安装.sh,此方式不受双击拦截影响。
3.2 安装程序会依次询问四项信息
- API 地址:直接回车,使用默认地址即可;
- 手机号:输入 TakeFlow 账号手机号后回车;
- 密码:输入过程中屏幕不显示任何字符(包括星号),此为正常现象,输入完成后直接回车;
- 需要接入的客户端:程序会依次询问 WorkBuddy、Codex、Claude Desktop、Cursor、DeepSeek Harness,请根据实际安装的客户端输入
y或n。其中 WorkBuddy、以及已检测到安装目录的 Codex 与 DeepSeek Harness 会默认选「是」,Claude Desktop 与 Cursor 默认选「否」。
完成后将显示:
✓ 登录成功,凭证已保存
✓ 连接验证通过,账号下共 8 个坐席
✓ 安装完成!
出现「安装完成」即表示安装成功。其中坐席数量以您账号的实际情况为准。
3.3 安装完成后可以关闭终端
可以。终端窗口仅用于运行安装程序,关闭不影响使用。连接器并非常驻后台的程序,客户端在需要调用时才会自动启动,使用完毕即退出。
- 关闭窗口不影响连接器;
- 电脑重启后无需重新安装;
- 仅在两种情况下需要重新运行安装程序:① 令牌超过 30 天失效;② 安装目录被移动。
窗口底部显示「进程已完成」,表示程序已正常退出。
第 3 步:重启客户端并验证
请将客户端完全退出后重新打开。WorkBuddy 需退出整个应用(macOS 使用 Cmd+Q,Windows 在托盘图标上选择退出),仅关闭窗口不生效。
随后输入以下指令进行验证:
请帮我查看 TakeFlow 的坐席列表,并标出即将到期的坐席
首次调用时,客户端可能询问是否允许该连接器,选择允许即可。若能正常返回坐席列表,说明安装与连接均已完成。
四、日常使用示例
以下场景均可通过一句话完成。AI 助手会自动判断所需的操作步骤,您无需了解背后的工具与参数。
查询坐席与到期时间
我有哪些坐席?哪些即将到期?
将返回坐席编号、绑定账号、粉丝数、到期时间与开机状态,临近到期者会单独标注。
开机、关机与查看画面
请将 16 号坐席开机,完成后把画面链接发给我
AI 助手会先与您确认目标坐席,随后执行开机并等待画面就绪,最后提供控制台链接。打开链接后,使用 TakeFlow 账号登录一次即可查看画面。
补充说明:坐席在未使用时处于关机状态,这不影响已排定的任务。平台会在任务开始前自动开机、任务结束后自动关机,无需人工干预。
续费与下单
29 号坐席续费 3 个月需要多少费用?
将先给出套餐与实付金额(含手续费),经您确认后才会下单,并提供支付链接。支付完成后,可请 AI 助手查询到账状态。
上传与发布作品
请把桌面上的
10月新品.mp4发布到 52 号和 53 号坐席,文案沿用上一次的
该操作分为两个步骤:平台要求以素材目录为单位选择素材,无法直接指定单个文件。因此需要先将文件上传至云盘目录,再基于该目录创建发布任务。
您只需确认以下信息,其余步骤由 AI 助手完成:发布到哪些坐席、目录中有几条素材、立即发布或定时发布时间、标题与文案。
操作前建议了解以下规则:
- 坐席数量与每个账号的发布条数之积,不得超过目录中的文件数量,不足时会提示补充素材;
- 定时发布使用北京时间,已过去的时间无法提交;
- 如需背景音乐,请说明「配热门音乐」或指定歌曲名称;未说明则不加音乐;
- 相同文件此前上传过时会自动秒传,不占用额外空间;
- 支持 mp4、mov、jpg、jpeg、png 格式,单个文件不超过 2GB。
修改账号资料
请把 16 号坐席的头像换成这张图片,并将昵称改为 your_nickname
头像会先上传至云盘并取得链接后自动替换,无需您自行处理格式。未提及的字段不会被清空:若只修改头像,昵称与简介保持原样。
查询播放数据
52 号坐席最近的作品播放情况如何?
将返回账号概览(粉丝数、获赞数、作品数)以及最近 10 条作品的数据。
两点提示:
- 图片轮播类作品的播放量常显示为 0,这是数据源未统计所致,不代表发布失败;
- 发布后 24 小时内数据尚不稳定,建议观察 24–48 小时后再评估效果。
分析失败任务
昨天的任务为什么没有发布成功?(附录屏文件路径或链接)
请分析这张截图,看看卡在哪一步。
将抽取关键帧并与规则库比对,输出四部分内容:分析结果、关键画面、核心判断、规避建议。
检测账号是否被封
请帮我查一下这几个 TikTok 账号还在不在:@user123、@user456、@user789
将逐个返回结论:存在、查无此号、存在但全零或未确认,并附昵称、作品数、粉丝数。十个账号约需两分钟,属正常速度。
两点提示:
- 「查无此号」不等于 100% 封号:封号、注销、平台回收与改名在接口层面表现一致。若您能提供账号的数字 ID(uid),可进一步复核——uid 查得到说明只是改名,查不到才是真的不存在;
- 本功能使用公开的第三方查询接口,只做账号存在性判断,不涉及您的 TakeFlow 账号数据。
其他常见操作
请检查所有坐席的登录状态,掉线的账号帮我重新登录
请给 2 号和 19 号坐席创建养号任务,明天早上 9 点开始
请帮我录入一条客户信息,开通 CLAW
五、需要您确认的操作
以下四类操作在执行前,AI 助手会复述操作内容并等待您确认:
| 类型 | 示例 | 确认方式 |
|---|---|---|
| 涉及费用 | 续费下单 | 「29 号坐席续费 3 个月,实付 ¥xxx(含手续费),是否确认下单?」 |
| 对外发布 | 发布作品、修改头像昵称 | 「发布到 52、53 号坐席,各 1 条,明天 10:00,标题为 xxx,是否确认?」 |
| 状态变更 | 开机、关机、批量登录、养号任务 | 「即将对 16 号坐席执行开机,是否确认?」 |
| 文件上传 | 上传素材、创建目录 | 「即将把 xxx.mp4 上传到『20261026』目录,是否确认?」 |
概括而言:涉及资金、账号状态与对外内容的操作,均会事先征求您的确认。
六、常见问题
排查前建议先确认当前版本号(见第八节)。联系技术支持时一并提供,有助于更快定位问题。
双击安装程序无反应
- macOS:可能是文件缺少执行权限。请在该目录打开终端,执行
chmod +x 一键安装.command后重试; - 也可直接在终端执行
bash 一键安装.sh,此方式不受双击拦截影响。
提示未检测到 Node.js
电脑未安装 Node.js,或版本低于 18。请前往 https://nodejs.org/zh-cn 安装 LTS 版本后重新运行安装程序。
安装完成后客户端中找不到 TakeFlow
请按以下顺序排查:
- 客户端是否已完全退出并重新启动?仅关闭窗口不生效;
- 在 WorkBuddy 中打开「插件 → MCP 服务器」,确认 takeflow 一项的状态是否正常(绿色),若显示红色则表示配置有误;
- 在安装目录打开终端,手动执行
node server/takeflow-mcp.mjs。该命令没有输出属正常现象,按Ctrl+C退出即可;若出现报错信息,请提供给技术支持。
提示未配置凭证或令牌失效
请重新运行安装程序完成登录。令牌每 30 天到期一次,属平台安全策略,并非故障。
登录失败,提示账号或密码错误
请确认使用的是 TakeFlow 平台账号(而非 TikTok 账号)。若该手机号尚未注册,安装程序会询问是否使用同一密码注册,输入 y 即可。
图片或视频上传失败
- 检查格式:仅支持 mp4、mov、jpg、jpeg、png;
- 检查大小:单个文件不超过 2GB;
- 检查空间:云盘容量不足时,需先在平台网页端清理;
- 若提示「cos-credentials 未开通」,无需处理,连接器会自动切换其他方式完成上传。
视频诊断提示缺少 ffmpeg
请参考第二节安装 ffmpeg,安装完成后重启客户端。若仅使用截图分析,则无需安装。
封号检测提示找不到 python3
该功能依赖 Python 3.8 及以上版本。请参考第二节第 4 项安装,安装完成后重新执行即可。若您的电脑不允许安装,可跳过该功能,不影响其他功能使用。
公司电脑不允许安装 Node.js
可请 IT 人员使用便携版 Node(解压即用,无需安装),并将客户端配置中的 command 指向该 node 文件,具体方式见附录。
ChatGPT 能直接使用这个连接器吗
不能。ChatGPT 运行在云端,无法调用您电脑上的程序;本连接器在本地运行,凭证与操作都不离开本机,因此无法添加进 ChatGPT。
若确需在 ChatGPT 中使用,需要单独部署一套公网网关,包含域名、证书、登录鉴权与日常运维。这部分属于独立服务,费用与本地接入包分开计算。WorkBuddy、Codex、Claude Desktop、Cursor、DeepSeek Harness 均为桌面客户端,不受此限制。
七、数据与隐私
- 登录凭证仅保存在本机:存放于
~/.takeflow/config.json,文件权限为 600(仅本人可读),不会上传至任何服务器; - 密码不做保存:登录时输入的密码仅用于换取令牌,使用后即丢弃;
- 账号密码不离开本机:批量登录离线坐席时,账号密码与两步验证码由本机读取并直接提交,不会传递给 AI;
- 链接不携带令牌:推流控制台与购买页均为普通地址,首次打开时正常登录即可;
- 素材直传:文件由您的电脑直接上传至对象存储,不经过中转服务器;上传使用的临时密钥仅存在于内存中,约 1 小时后失效。
八、版本、升级与卸载
如何确认当前版本
以下三种方式任选其一:
- 查看压缩包名称:形如
TakeFlow-MCP-本地接入包-v2.4.0-20261119.zip,v之后为版本号,末尾 8 位为打包日期(2026 年 11 月 19 日); - 运行安装程序:首行会显示版本号,查看后可直接关闭窗口,不会改动任何内容;
- 询问 AI 助手:「TakeFlow 连接器是什么版本?令牌还有多久到期?」即可获得本机相关信息。
联系技术支持时提供版本号,有助于缩短排查时间。
组件版本
安装包内含一个连接器与六项技能,版本如下:
| 组件 | 版本 | 用途 |
|---|---|---|
| 本地连接器 | v2.4.0 | 安装程序与 MCP 服务 |
| takeflow | 2.3.0 | 坐席、开关机、续费、任务、素材、发布、账号资料、播放数据 |
| seats-check | 1.0.0 | 坐席登录状态与账号检查 |
| cultivation-task | 1.0.0 | 养号任务 |
| client-info | 1.0.0 | 客户信息录入 |
| tiktok-auto-ops-diagnostic | 1.1.2 | 失败任务录屏诊断 |
| tiktok-ban-check | 1.0.0 | 账号封号检测 |
技能随安装包一同发布,无需单独升级。
升级
将新版本压缩包解压并覆盖原目录(或解压至新目录),重新运行安装程序,随后重启客户端。原有配置与技能会先自动备份。本地版不会自动更新,需要手动执行。
卸载
- 删除
~/.takeflow目录(macOS 可在访达中按Cmd+Shift+G,输入~/.takeflow后回车); - 打开客户端的 MCP 配置,删除
takeflow一项(DeepSeek Harness 用户请删除~/.dsh/profiles/<profile>/cordis.patch.yml中的takeflow-mcp条目); - WorkBuddy 用户还需删除
~/.workbuddy/skills/下的六个目录:takeflow、seats-check、cultivation-task、client-info、tiktok-auto-ops-diagnostic、tiktok-ban-check;DeepSeek Harness 用户对应删除~/.dsh/skills/下的同名目录。
九、法律与合规声明
本节说明本连接器与第三方平台、第三方商标之间的关系,以及使用过程中的责任边界,建议在使用前阅读。
第三方名称与图标
本指南、安装包及配套演示视频中出现的 WorkBuddy、Codex、Claude、DeepSeek Harness 等产品的名称、图标、界面截图与商标,分别归其各自权利人所有。上述内容仅用于说明本连接器的兼容范围与配置位置,不代表本产品与这些公司存在隶属、合作、代理、赞助或背书关系,也不代表其对本产品作出认证或推荐。相关名称与图标的使用不构成对其权利的挑战;如权利人认为使用方式不当,我们将在收到通知后及时调整或移除。
MCP 是通用开放协议
Model Context Protocol(MCP)是一项开放的技术协议,不属于本产品的专有技术。本连接器依据该协议实现,因而可以在支持 MCP 的客户端中调用;协议本身的演进、版本变更与兼容性,由其规范维护方决定。「支持 MCP」仅表示技术上具备对接条件,不代表任何平台对本产品进行认证、收录或推荐。
需同时遵守各平台规范
接入与使用各智能平台时,您需要同时遵守该平台的用户协议、开发者条款、使用政策以及您所在地区的法律法规。各平台对 MCP 的支持范围、配置方式、可用功能与调用频次,均由平台方自行决定,并可能随时调整、限制或终止。本产品无法保证在任一平台的持续可用性,也不对平台方的上述行为承担责任。
使用边界
本连接器仅限用于您自有或已获授权的 TakeFlow 账号与 TikTok 账号的日常运营。请勿将其用于规避平台风控与审核、批量注册或买卖账号、发布违法违规内容,以及其他违反平台规则或法律的行为。您账号下执行的操作及其后果,由您自行承担。
第三方数据与服务
播放数据、封号检测等结果来自第三方公开数据源,可能存在延迟、截断或缺失,仅供运营参考,不作为平台官方结论,也不作为法律依据。
责任范围
本指南用于说明技术接入方式,不构成对任何第三方平台的授权、代理或担保。因客户端版本变更、平台规则调整、网络环境或第三方数据源异常导致的接入失败、功能受限或数据偏差,我们将协助排查,但不承担由此产生的间接损失。
附录:面向 IT 人员的手动配置
本节供 IT 人员参考。普通用户按第三节运行安装程序即可,无需阅读本节。
A1. 手动获取令牌
curl -X POST https://saas.takeflows.com/admin-api/system/tk-auth/login \
-H 'Content-Type: application/json' \
-d '{"phoneNumber":"13800000000","password":"您的密码"}'
将返回的 accessToken 与 refreshToken 写入 ~/.takeflow/config.json,并将文件权限设置为 600:
{
"baseUrl": "https://saas.takeflows.com",
"phoneNumber": "13800000000",
"accessToken": "登录返回的 accessToken",
"refreshToken": "登录返回的 refreshToken",
"expiresTime": 1792633796480
}
A2. 客户端配置
| 客户端 | 配置文件 |
|---|---|
| WorkBuddy | ~/.workbuddy/mcp.json(Windows:%USERPROFILE%\.workbuddy\mcp.json) |
| Codex CLI | ~/.codex/config.toml |
| Claude Desktop | macOS ~/Library/Application Support/Claude/claude_desktop_config.json;Windows %APPDATA%\Claude\claude_desktop_config.json |
| Cursor | ~/.cursor/mcp.json |
| DeepSeek Harness | ~/.dsh/profiles/<profile>/cordis.patch.yml(桌面版 profile 为 desktop) |
{
"mcpServers": {
"takeflow": {
"command": "/绝对路径/node",
"args": ["/绝对路径/TakeFlow-MCP/server/takeflow-mcp.mjs"],
"env": { "TAKEFLOW_HOME": "/Users/您的用户名/.takeflow" }
}
}
}
[mcp_servers.takeflow]
command = "/绝对路径/node"
args = ["/绝对路径/TakeFlow-MCP/server/takeflow-mcp.mjs"]
[mcp_servers.takeflow.env]
TAKEFLOW_HOME = "/Users/您的用户名/.takeflow"
# DeepSeek Harness:写在 profile 目录的 cordis.patch.yml
- id: takeflow-mcp
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: takeflow
transport: stdio
command: "/绝对路径/node"
args:
- "/绝对路径/TakeFlow-MCP/server/takeflow-mcp.mjs"
env:
TAKEFLOW_HOME: "/Users/您的用户名/.takeflow"
toolCallTimeoutMs: 300000
failOnStartupError: true
DeepSeek Harness 另有三点需留意:请修改 cordis.patch.yml 而非同目录的 cordis.yml;安装完成后须完全退出应用再启动;toolCallTimeoutMs 若沿用默认的 60 秒,视频抽帧会因下载耗时较长而中断。
两点注意事项:
command需填写 node 的绝对路径(可通过which node/where node查询),图形界面客户端无法读取终端的环境变量;- 原有配置中的其他 MCP 服务请勿删除,仅追加
takeflow一段即可。
A3. Codex 的技能索引
Codex 没有技能机制,安装程序会在 ~/.codex/AGENTS.md 中维护一段由 <!-- takeflow-skills:start --> 到 end 的索引,用于告知模型在何种场景下读取哪份说明。该段之外的内容不会被改动。
如需了解更详细的字段与参数说明,可查阅同目录下的
README.md。
若安装或使用过程中遇到问题,可将终端中的报错信息截图发送给技术支持,也可直接询问 AI 助手:「我安装 TakeFlow 连接器时出现了以下报错,应如何处理?」
接入指南.md 自动生成,内容与 md 完全一致;如需修改,请改 md 后重新生成,不要直接编辑此文件。