用 MCP 把 MindThread 接進 Claude、Claude Code、Cursor：讓 AI 代理排 Threads 貼文、看成效、批准海巡留言（2026 教學）

把 MindThread 用 MCP 接進 Claude Desktop、Claude Code 或 Cursor 之後，你可以直接用一句話請 AI 代理處理 Threads 帳號的日常工作。這篇用三件日常工作當範例：

1. 排程發文：代理用 publish 帶上 publish_at（指定時間），或用 schedule_text 把已經寫好的文字排進去；排好的貼文用 list_schedules 查。
2. 看近 7 天成效：代理用 get_top_posts 加上 days: 7，列出近 7 天表現最好的貼文和每篇的觀看、按讚、回覆。
3. 批准待審的海巡留言：雲端海巡開了「先審再發」這個可選設定之後，代理用 list_pending_replies 一則一則拿給你看，你說好就用 approve_pending_reply 送出，不要就用 reject_pending_reply 退掉。

這些都是 MindThread 伺服器上真的有的工具名稱。代理不需要你寫程式，它讀了工具說明就會自己挑工具。下面照順序講：準備什麼、三種接法、第一次對話怎麼問、常見錯誤，以及額度怎麼算。以下版本與數字都是 2026 年 11 月 12 日實際查的。

開始之前：一把 API 金鑰

到 mindthread.tw 註冊、連上你的 Threads 帳號，再到「設定 → API 金鑰」建立一把金鑰。建議先用測試金鑰（mt_test_ 開頭）：寫入只做模擬，什麼都不會發到 Threads。帳號清單、成效總覽、待審留言這類讀取是你的真實資料，但 get_top_posts 只回 3 篇標示「沙盒示範貼文」的示範內容，generate_posts 回的是 [TEST] 開頭的示範草稿。要看自己的真實成效和真正的草稿，請換成正式金鑰（mt_live_ 開頭）。

每把金鑰除了「讀取資料」以外的每一項權限，都可以設成「允許」「先問我」或「不允許」（讀取資料只有「允許」和「不允許」）。設成「先問我」的動作，代理不會直接執行，而是拿到一個 approval_required 和一條確認連結交給你，你在 mindthread.tw 按下確認才會執行。發文權限設成「先問我」，是讓代理動手、自己留最後一關的做法。

不帶金鑰也能先看看：我們用 npx -y mindthread-mcp 實測，不帶金鑰時 tools/list 列出 43 個工具，get_playbook（操作說明）也能讀；要碰到你的帳號的工具，就會提示你先設定金鑰。帶 API 金鑰時，伺服器改給完整清單；我們同一天直接查完整清單，是 50 個工具。

MindThread 的 MCP 有兩種接法，連到的是同一台伺服器：

• 遠端（建議）：用戶端直接連 https://mindthread.tw/api/mcp，什麼都不用裝。
• 本機 stdio：執行 npm 套件 mindthread-mcp（11 月 12 日查 npm 為 0.2.0），它把每一則訊息轉給同一個網址，所以用的是遠端同一份工具清單。套件沒有任何執行期相依，需要 Node.js 18.17 以上。這個伺服器也登錄在官方 MCP Registry，名稱是 io.github.ppcvote/mindthread。

接法一：Claude Desktop

打開「Settings → Developer → Edit Config」，在 claude_desktop_config.json 加入：

{
  "mcpServers": {
    "mindthread": {
      "command": "npx",
      "args": ["-y", "mindthread-mcp"],
      "env": { "MINDTHREAD_API_KEY": "mt_test_你的金鑰" }
    }
  }
}

存檔後重開 Claude Desktop。Windows 如果找不到 npx，把 command 改成 "cmd"，args 改成 ["/c", "npx", "-y", "mindthread-mcp"]。

驗證：在新對話輸入「列出我的 MindThread 帳號」，代理會呼叫 list_accounts，回傳你連上的帳號和每個帳號的 id。

接法二：Claude Code

在終端機執行（遠端、用金鑰）：

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

想用本機 stdio，改成：

claude mcp add mindthread --env MINDTHREAD_API_KEY=mt_test_你的金鑰 -- npx -y mindthread-mcp

不想放金鑰，也可以只加網址（不帶 --header），再在 Claude Code 裡打 /mcp，用 MindThread 帳號登入。

驗證：執行 claude mcp list，清單裡要看得到 mindthread；進對話後請它「讀 MindThread 的 playbook」，它會呼叫 get_playbook。

接法三：Cursor

編輯 ~/.cursor/mcp.json（所有專案）或專案裡的 .cursor/mcp.json（單一專案）：

{
  "mcpServers": {
    "mindthread": {
      "url": "https://mindthread.tw/api/mcp",
      "headers": { "Authorization": "Bearer mt_test_你的金鑰" }
    }
  }
}

也可以用 stdio 寫法："command": "npx"、"args": ["-y", "mindthread-mcp"]、"env": { "MINDTHREAD_API_KEY": "mt_test_你的金鑰" }。

驗證：在 Cursor 的對話裡問「我的 MindThread 方案和金鑰權限是什麼」，代理會呼叫 get_me，回傳方案、這把金鑰每項權限的設定和今天剩下的呼叫次數。

第一次對話怎麼問：三輪示範

下面三輪的問法都對得到真的工具，回答裡的欄位也是工具真的會回的。

第一輪：先看成效。
你：「列出我的 MindThread 帳號，再看第一個帳號近 7 天觀看最高的三篇。」
代理會先呼叫 list_accounts 拿到帳號 id、使用者名稱和粉絲數，再呼叫 get_top_posts，帶 days: 7、metric: "views"、limit: 3，列出每篇的內文和觀看、按讚、回覆。用測試金鑰跑這一輪，get_top_posts 回的是 3 篇示範貼文，不是你的貼文。

如果你改問「這個帳號近 7 天整體表現」，代理可能會用 analytics_insights 帶 period: "7d"。這裡要注意一件事：這個工具回傳的篇數是 7 天內的，但總觀看數是帳號累計，回應裡用 views_scope 和 posts_scope 標明。拿累計觀看除以 7 天的篇數，算出來的數字沒有意義；想看單篇表現，用 get_top_posts 比較準。

第二輪：寫稿、排程。
你：「照第一名那篇的寫法寫兩篇草稿，先不要發。第二篇排在明天晚上 9 點。」
代理用 generate_posts 依帳號的人設和品牌素材寫出草稿，再用 publish 帶 publish_at（含時區的時間，例如 +08:00）把第二篇排進去。回應裡有貼文 id 和狀態；如果排的時間不在這個帳號平常發文的時段，還會附一則提醒。你的金鑰如果把排程設成「先問我」，這一步會變成一條確認連結。用測試金鑰時，草稿是 [TEST] 開頭的示範文字，排程也只是模擬。

第三輪：處理待審留言。
你：「有沒有等我批准的海巡留言？一則一則給我看。」
代理用 list_pending_replies 列出待審稿，每則有觸發的關鍵字、原貼文作者、原貼文內容與連結、擬好的留言和到期時間。你說「這則可以」，它呼叫 approve_pending_reply 立刻送出（正式金鑰預設的「標準」組合把送出留言設成「先問我」，所以代理會先給你一條確認連結，你按下確認後留言才送出）（也可以先改字再送，改過的字一樣要過品質檢查）；你說「這則不要」，它呼叫 reject_pending_reply。

待審稿只在雲端海巡開了「先審再發」時才會出現，這是可選設定，不是預設。開啟雲端海巡這個權限要另外設定，用帳號登入（OAuth，包含 Claude、ChatGPT 與 Claude Code 的 /mcp）的連線都拿不到，第一次建議在網站上開好。雲端海巡每天的點數隨方案：免費方案只在註冊後 14 天試用期間有（每天 50 點），之後停止；Connect 300 點、Pro 500 點、Business 1,500 點。

常見錯誤

另外，Windows 上 Claude Desktop 找不到 npx 時，照接法一的 cmd /c 寫法改。Claude Desktop 的記錄在「Settings → Developer → Open Logs Folder」。

額度與費用

每一次工具呼叫都算進金鑰的每日次數，包括什麼都沒查到的輪詢（例如一直問 list_events 或 list_pending_replies）。依 方案頁 與開發者文件，每把正式金鑰每天的次數：

每把正式金鑰另有每分鐘 120 次的上限；同一位會員的測試金鑰合計共用每天 500 單位和每分鐘 30 次的沙盒額度，不扣方案次數。每日次數在台北時間 00:00 重置。

碰到 429 時，回應會寫是哪一種上限（window：每日或每分鐘）、reset_at 和 retry_after_seconds。每日用完就等到 reset_at，每分鐘用完就等 retry_after_seconds。免費方案如果要讓代理定時看事件，文件建議單一端點每 30 分鐘問一次就好；每 15 分鐘查一次待審留言要付費方案。有公開的 https 網址的話，用 webhook 收「有新的待審留言」「發文失敗」這類通知，比一直輪詢省次數。代理每天跑很多輪的話，免費方案的 50 次很快就會用完，這時就該考慮升級。

常見問題

要會寫程式才能用嗎？
不用。照上面的設定片段貼進用戶端，之後都是用一般的話請代理做事，它會自己挑 MindThread 的工具。

代理會不會在我不知道的時候發文？
看你怎麼設金鑰權限。新建的正式金鑰預設是「標準」：立刻發文、送出海巡留言等六項敏感動作每次先問你，排程發文不用問，排好的貼文時間到會自動發出。要連排程也先問你，選「保守」。把「立即發文」和「排程」設成「先問我」，代理每次要發都只拿得到一條確認連結，你在 mindthread.tw 按下確認才會發出去；也可以直接設成「不允許」。

不帶金鑰可以做什麼？
可以完成連線、列出工具清單（我們 11 月 12 日實測為 43 個），也能讀 get_playbook 和 list_formulas。要讀寫你的帳號，就要設定金鑰，或在支援的用戶端用 MindThread 帳號登入。

測試金鑰會真的發到 Threads 嗎？
不會。用 mt_test_ 開頭的測試金鑰，寫入只做模擬，回應會標明是測試模式，不會發到 Threads。讀取有的是你的真實資料（例如帳號清單），有的是示範內容：get_top_posts 回 3 篇模擬貼文，generate_posts 回 [TEST] 開頭的示範草稿。還沒做沙盒的功能會直接回 test_mode_unsupported，也不會寫入。

MCP 和 mindthread-cli 差在哪？
MCP 給 Claude Desktop、Cursor 這類用戶端用；mindthread-cli（11 月 12 日查 npm 為 0.4.0）是命令列工具，適合會跑終端機指令的代理和排程腳本。兩者打的是同一套 API，權限和額度規則一樣。

延伸閱讀

• MindThread 開發者文件：完整端點、權限與額度說明。
• Threads 自動發文要不要人工確認？全自動、先審再發、只給草稿怎麼選：三種都是可選的做法，權限設成「先問我」適合哪些情況。
• Threads 關鍵字監看與自動回覆是什麼：雲端海巡怎麼找到要留言的貼文。
• 用 API 發的 Threads 貼文會被壓觸及嗎？官方一天上限怎麼算：Threads 那邊的上限怎麼算。