MindThread

MindThread MCP：专为 AI Agent 打造的 Threads 发布计划工具

通过 Meta 官方 Threads API，让 Claude、Cursor 或任何 MCP 客户端为你的账号撰写、安排和发布 Threads 帖子，审核草拟的回复并查看数据分析。提供 40 多种工具、免费沙盒密钥和权限控制，确保 Agent 发布前先征求你的同意。

claude mcp add --transport http mindthread https://mindthread.tw/api/mcp --header "Authorization: Bearer mt_live_your_key"

下方提供繁體中文說明

Agent 可以做什么

• 撰写：以账号的风格（人物设定、品牌资料、内容公式）生成 1 到 5 篇草稿，或由 2 到 10 部分组成的串文。
• 安排和发布：发布文字、单张图片、轮播图（2 到 10 张图片）或视频；可立即发布或指定确切时间发布，也可以将帖子加入队列，在账号自己的时段发布。
• 通过代码保持品牌风格：服务器会强制执行内容规则（长度、禁用短语、不使用话题标签、仅使用事实列表中的数字），而不只是通过提示词提出建议。
• 在重要之处回复：云端巡查会在 Threads 上搜索你的关键词并草拟回复；你的 Agent 会列出草稿，由你逐一批准或拒绝。
• 衡量成效：查看每个账号的浏览量、点赞数、回复数和关注者数，以及巡查回复的成效。
• 掌握控制权：每个密钥都能为各项权限设置 allow、ask 或 deny。设置为 ask 时，帖子会等待你在 mindthread.tw 上确认，Agent 会提供一个链接让你处理，而不是直接发布。

三分钟设置

1. 获取 API 密钥。 在 mindthread.tw 注册，连接 Threads 账号，然后打开 Settings → API keys 并创建密钥。 先从测试密钥（mt_test_…）开始：读取操作会显示真实数据，写入操作会模拟执行，不会发布到 Threads。准备好后，切换到实时密钥（mt_live_…）。 所有套餐都包含 API 访问权限（2026 年 10 月：免费套餐的每个实时密钥每天可调用 50 次；测试密钥共用每天 500 次的沙盒额度）。当前限额：mindthread.tw/developers。

2. 将 MindThread 添加到你的客户端（从下方选择）。

3. 请求安排你的第一篇帖子：

列出我的 MindThread 账号。然后写一篇简短的帖子，介绍我创业的原因，先给我看看，再安排明天台北时间 9:00 在我的账号上发布。

Agent 会调用 list_accounts、generate_posts，然后调用带有 publish_at 的 publish。使用“显示我安排好的帖子”（list_schedules）查看结果。

客户端设置

有两种连接方式，两者都会连接到同一服务：

• 远程（推荐）：将客户端指向 https://mindthread.tw/api/mcp。无需安装。
• 本地 stdio：使用 npx -y mindthread-mcp 运行此软件包。适用于只能通过命令启动服务的客户端。它会将每条消息转发到同一端点，因此工具始终相同。

Claude Code

# Remote, with an API key
claude mcp add --transport http mindthread https://mindthread.tw/api/mcp --header "Authorization: Bearer mt_live_your_key"

# Remote, signing in with your MindThread account instead of a key (run /mcp in Claude Code to log in)
claude mcp add --transport http mindthread https://mindthread.tw/api/mcp

# Local stdio
claude mcp add mindthread --env MINDTHREAD_API_KEY=mt_live_your_key -- npx -y mindthread-mcp

Claude Desktop

编辑 claude_desktop_config.json（Settings → Developer → Edit Config）：

{
  "mcpServers": {
    "mindthread": {
      "command": "npx",
      "args": ["-y", "mindthread-mcp"],
      "env": { "MINDTHREAD_API_KEY": "mt_live_your_key" }
    }
  }
}

在 Windows 上，如果 Claude 找不到 npx，请使用 "command": "cmd" 和 "args": ["/c", "npx", "-y", "mindthread-mcp"]。 无需编辑文件：Settings → Connectors → Add custom connector，URL 为 https://mindthread.tw/api/mcp，然后使用你的 MindThread 账号登录（适用于提供自定义连接器的 Claude 套餐）。

Cursor

~/.cursor/mcp.json（所有项目）或 .cursor/mcp.json（单个项目）：

{
  "mcpServers": {
    "mindthread": {
      "url": "https://mindthread.tw/api/mcp",
      "headers": { "Authorization": "Bearer mt_live_your_key" }
    }
  }
}

也可以使用 stdio 形式："command": "npx", "args": ["-y", "mindthread-mcp"], "env": { "MINDTHREAD_API_KEY": "mt_live_your_key" }。

VS Code（GitHub Copilot Agent 模式）

.vscode/mcp.json，系统会提示你输入一次密钥，并安全地保存：

{
  "inputs": [
    { "type": "promptString", "id": "mindthread-key", "description": "MindThread API key", "password": true }
  ],
  "servers": {
    "mindthread": {
      "type": "http",
      "url": "https://mindthread.tw/api/mcp",
      "headers": { "Authorization": "Bearer ${input:mindthread-key}" }
    }
  }
}

其他 MCP 客户端

• Streamable HTTP：https://mindthread.tw/api/mcp，请求头为 Authorization: Bearer <key>（也接受 X-API-Key）。
• stdio：命令为 npx，参数为 -y mindthread-mcp，环境变量为 MINDTHREAD_API_KEY。

即使没有密钥，initialize、tools/list、get_playbook 和 list_formulas 仍可使用，因此你可以先浏览一番。

示例提示词

• “MindThread 能做什么？先阅读操作手册。”（get_playbook）
• “用 @mybrand 的语气写 3 条关于为首套房存钱的帖子。暂时不要发布任何内容。”（generate_posts）
• “将帖子 1 和 3 加入队列；将帖子 2 安排在周五 20:00 发布。”（add_library、publish）
• “有没有待我处理的草稿回复？逐条展示。”（list_pending_replies、approve_pending_reply、reject_pending_reply）
• “@mybrand 过去 7 天的表现如何？与此前 7 天相比怎么样？”（analytics_insights）
• “将云巡查关键词设置为 ‘首套房’、‘抵押贷款’、‘租房还是买房’，每天最多回复 10 条，并将所有回复暂存，等待我审核。”（set_cloud_patrol）

工具

每个客户端在登录前看到的工具集，由实时服务通过 npm run tools-table 生成。服务是唯一可信来源：当它添加工具时，此软件包无需更新即可将其公开。

工具	标题	类型	功能说明
get_me	我的方案和密钥	读取	返回当前方案、此连接的身份和权限（每项权限为 allow、ask 或 deny），以及本日剩余调用次数……
list_accounts	列出已连接的账号	读取	列出此 MindThread 成员已连接的 Threads 账号，以及传递给其他所有工具的 account_id。
get_material	获取品牌资料	读取	返回账号的资料摘要（品牌定位、产品、声明、体验、常见问题、来源数据、品牌语气），供每个……
build_material	构建品牌资料	写入	根据品牌自有网站最多 8 个 https 页面，以及可选的真实案例和……备注，构建或重建账号的资料摘要。
get_account_settings	获取账号设置	读取	返回一个账号的 persona、schedule_times、review_before_publish、auto_reply_enabled、auto_thread、content_rules 和防护措施……
update_account_settings	更新账号设置	写入	更改账号的 persona（最多 4,000 个字符）、schedule_times（以英文逗号分隔的 HH:MM，使用账号时区，最多 8 个），……
list_guardrail_changes	防护措施更改历史	读取	按时间倒序列出账号的防护措施修订记录（limit 为 1 到 50，默认 20；使用 before 获取下一页）。
list_account_settings	列出账号设置（批量）	读取	列出此成员已连接的所有 Threads 账号，以及 MindThread 批量设置表中的设置（运行模式、自动发布、审核……）
preview_account_settings	预览批量设置更改	读取	显示批量设置更改的效果，不会写入任何内容：列出每个账号和单元格的当前值与新值、警告……
apply_account_settings	应用批量设置更改	写入	将一批设置更改写入最多 100 个账号，每个账号单独执行事务，并返回每行结果（成功、未更改，……）
revert_account_settings_batch	撤销批量设置	写入	在批次执行后的 24 小时内恢复该批次更改的值。
get_account_settings_batch	获取批量设置批次	读取	根据 batch_id 返回一个批次：发送时间和来源（网站、API 或 MCP）、计数、是否仍可撤销，以及每项……
generate_posts	生成帖子草稿	写入	使用内容公式（自动选择，或使用 list_formulas 中的 ID）、账号 persona 和资料等，围绕主题生成 1 到 5 篇帖子草稿……
publish	发布或安排帖子	写入	立即将帖子发布到 Threads（publish_now:true），或安排在 publish_at 发布（ISO 8601 格式，含时区偏移）。
schedule_text	安排文本帖子	写入	将现有文本（最多 500 个字符）安排在 publish_at 发布，或使用 auto_optimize_time:true 安排在下一个最佳时段（两者互斥……）
list_schedules	列出已安排的帖子	读取	列出已安排的帖子，可按 account_id 筛选，并包含状态、publish_at，以及帖子被暂缓时的 held_reason（例如……）
cancel_schedule	取消已安排的帖子	写入	根据 ID 取消已安排的帖子。
list_library	列出内容库项目	读取	按状态列出账号的内容库项目（排队中、草稿、已发布、失败；最多 200 条）。
add_library	添加内容库项目	写入	向账号的内容库添加最多 20 个项目（文本、可选的公开 https 图片），状态设为排队中（默认；会在……自动发布）
delete_library_item	删除内容库项目	写入	根据 ID 永久删除一条排队中、草稿或已归档的内容库项目。
approve_library_item	批准草稿并加入队列	写入	根据 ID 将一篇草稿移入发布队列。
update_library_item	更新内容库项目	写入	根据 ID 更改一条内容库项目：状态（已归档、草稿、排队中）、文本（根据 content_rules 检查），或队列中的位置（position……）
get_cloud_patrol	获取云巡逻设置	读取	返回账号的云巡逻配置和状态：关键词、每日上限、今日已发送的回复、review_before_reply、上次扫描时间。
set_cloud_patrol	设置云巡逻	写入	创建或更新账号的云巡逻：关键词（1 到 10 个；"#tag" 条目会搜索话题标签）、回复 persona、daily_cap（……时为 1 到 50）
cloud_patrol_log	云巡逻回复日志	读取	列出账号在过去 1 到 7 天内由云巡逻发送的回复，包含目标帖子和回复文本。
cloud_patrol_stats	云巡逻效果	读取	返回账号在过去 1 到 14 天内云巡逻回复获得的浏览量和点赞数，并列出热门回复。
list_pending_replies	列出待审核的回复草稿	读取	按状态列出账号的云巡逻回复草稿（默认待处理；也可选已发送、已拒绝、已过期）。
approve_pending_reply	发送回复草稿	写入	根据 ID 批准一条云巡逻回复草稿并立即发送到 Threads；也可选择编辑回复文本，编辑后的文本需通过相同的质量……
reject_pending_reply	拒绝回复草稿	写入	根据 ID 拒绝一条云巡逻回复草稿，并可附加备注。
list_events	列出近期事件	读取	返回成员过去 7 天的事件动态，按时间倒序排列（limit 为 1 到 200）：post.published、post.failed、reply.sent、patrol.reply、……
analytics_insights	账号数据洞察	读取	返回一个账号在一段时间内的浏览量、点赞数、回复数和粉丝数（7d、30d；默认 30d）。
list_formulas	列出内容公式	读取	列出 generate_posts 接受的内容公式，并提供每项公式的 ID 和简短说明。
get_playbook	运营手册	读取	返回通过此服务运营账号的操作手册：每日流程、确认请求的工作方式、配额，以及……
connect_account_link	获取连接新账号的链接	写入	返回 Threads OAuth 链接，供用户在浏览器中打开，以便将新的 Threads 账号连接到此成员。
disable_this_key	停用此连接	写入	永久停用发起此调用的密钥或连接。
get_my_usage	我的使用情况和调用日志	读取	返回此连接过去 1 到 30 天的使用情况（days=1 表示今天自 Asia/Taipei 00:00 起）：摘要（调用次数、单位、错误数，……）
get_approval	检查确认请求	读取	根据 ID（apr_...）返回此连接创建的一条确认请求：状态（待处理、已批准、已执行、失败、已拒绝、已过期，……）
bulk_archive_library	批量归档内容库项目	写入	一次调用可根据 ID 归档最多 50 个内容库项目。
bulk_delete_library	批量删除内容库项目	写入	一次调用可根据 ID 永久删除最多 50 个排队中、草稿或已归档的内容库项目。
bulk_queue_library	批量将内容库项目加入队列	写入	一次调用可根据 ID 将最多 50 篇草稿移入发布队列；这些草稿会按照账号的 schedule_times 自动发布。

安全與控制

• 每把金鑰各自設定權限。 每項權限（讀取、寫入草稿、排程、立即發布、傳送回覆、開啟雲端巡邏、連接帳號、放寬防護措施、webhook）可設為 allow、ask 或 deny，請在 Settings → API keys 中設定。ask 表示 Agent 會收到 approval_required 和一個供你使用的連結；只有你在 mindthread.tw 確認後，操作才會執行。
• 只有你能在網站上執行的操作。 撤銷防護措施變更一律由你執行。OAuth 連線（Claude、ChatGPT）絕不會獲准開啟雲端巡邏；API 金鑰則必須明確設定該權限。
• 內容規則以程式執行。 enforce: "block" 會讓服務拒絕違反規則的貼文，無論大模型生成了什麼內容。
• 緊急停止開關。 disable_this_key 會永久停用目前使用的金鑰。你也可以在 Settings 中撤銷金鑰和連線。
• 僅使用官方 API。 發文與回覆都會透過 Meta 官方 Threads API 進行。MindThread 絕不會要求你提供 Threads 密碼。
• 你的金鑰留在本機。 在 stdio 模式下，金鑰會從 MINDTHREAD_API_KEY 環境變數讀取，且只會傳送至 mindthread.tw。金鑰絕不會被印出（記錄中會顯示 mt_live_…abcd）。

設定

變數	必要條件	說明
MINDTHREAD_API_KEY	任何會操作你帳號的工具都需要	mt_live_… 或 mt_test_…
MINDTHREAD_MCP_URL	否	端點覆寫，預設為 https://mindthread.tw/api/mcp

需要 Node.js 18.17 或更新版本。沒有執行階段依賴項。

疑難排解

• 「MINDTHREAD_API_KEY is not set」：在客戶端設定中，將金鑰加入此服務的 env 區塊，然後重新啟動客戶端。
• 「MindThread rejected the key」：金鑰錯誤、已撤銷或已停用。請在 Settings → API keys 中建立新金鑰。
• approval_required：這是預期行為。開啟 Agent 顯示的連結並確認，貼文就會發布。
• insufficient_scope：此金鑰的該項權限設為 deny。錯誤中的 fix 欄位會指出要變更的設定。
• rate_limit_exceeded：已達每日或每分鐘上限；錯誤訊息會說明何時重設。
• 記錄會輸出至 stderr（Claude Desktop：Settings → Developer → Open Logs Folder）。stdout 僅傳送 MCP 訊息。

另有提供

• 命令列工具，適用於偏好使用 shell 命令的腳本和 Agent：mindthread-cli（npx mindthread-cli）。
• REST API：mindthread.tw/api/v1/openapi.json 提供 OpenAPI 3.1，mindthread.tw/developers 提供文件，mindthread.tw/llms.txt 提供 Agent 指南。

繁體中文

MindThread 是供 AI Agent 使用的 Threads 排程工具。連接後，Claude、Cursor 或任何支援 MCP 的工具，都能替你的 Threads 帳號撰文、排程、發文（文字、單圖、輪播、影片）、審核雲端巡邏的回覆草稿，以及查看觀看與互動數據。全程透過 Meta 官方 Threads API，不需要你的 Threads 密碼。

三分鐘上手：

1. 前往 mindthread.tw 註冊並連接 Threads 帳號，在「設定 → API 金鑰」建立金鑰。建議先使用測試金鑰（以 mt_test_ 開頭）：讀取的是真實資料，寫入只會模擬，不會發布到 Threads。
2. 將 MindThread 加入你的工具，例如 Claude Code：

   claude mcp add --transport http mindthread https://mindthread.tw/api/mcp --header "Authorization: Bearer mt_live_你的金鑰"
   

   Claude Desktop、Cursor、VS Code 的設定請見上方的 客戶端設定。
3. 對 AI 說：「列出我的 MindThread 帳號，幫我寫一篇介紹我為什麼創業的短文，給我看過之後，排在明天早上 9 點發。」

你保有控制權：每把金鑰的每項權限都能設成「允許」、「先問我」或「拒絕」。設成「先問我」時，AI 會取得確認連結並交給你；你在 mindthread.tw 按下確認後才會發布。字數、禁用詞、只能使用你列出的數字等內容規則，會由伺服器以程式檢查，也可以設定為直接阻擋。

授權條款

MIT © Ultra Lab