教學 / MCP SERVER
Threads MCP，數據問一句就能到手。
你的 Dashboard 內建 MCP Server。連接 Claude Code、Claude、Codex 或 Cursor，就能直接問你的貼文、數據與粉絲紀錄。唯讀，每個連接都由你核准。
約 2 分鐘 · 不需要 API Key · 唯讀存取
https://your-deployment.example.com/api/mcp
claude mcp add --transport http threads-analytics https://your-deployment.example.com/api/mcp
把 your-deployment.example.com 換成你部署的 Dashboard 網域。
01它能做什麼
八個唯讀工具，七個報告 Prompt。
MCP Server 把你同步好的數據整理成結構化工具。你用自然語言發問，Agent 自己挑選工具、只讀取需要的部分。
get_account_overview一眼掌握帳號現況所有已連接帳號的名稱、同步狀態、貼文數、資料範圍與粉絲成長摘要 — 每段對話的第一個呼叫。有多個帳號時，Agent 會先問你要查哪一個。
list_posts · get_post搜尋並閱讀每篇貼文依日期、媒體類型或文字篩選，依瀏覽、按讚或互動率排序，再取出任一篇貼文的完整內容。
get_analytics31 個分析區塊隨選即用最佳發文時間、關鍵字分析、發文連續紀錄、瀏覽分佈等 — 依你指定的日期範圍即時計算。
get_follower_history · compare_post_growth追蹤每一條成長曲線每日粉絲快照、成長摘要與最新受眾輪廓，還有每篇貼文發布後逐小時的成長，並和其他貼文在同一時間點比較。
compare_periods · get_monthly_review比較期間、回顧整月貼文、瀏覽、互動與粉絲成長並列比較並附上變化 — 也能針對單一月份對照上月與基準完整回顧，並為上月的實驗打分數。
7 個內建 Prompt一鍵產出完整報告月報、成效回顧、內容策略等七種範本 — 在客戶端選單點一下，就能拿到完整報告。
02如何連接
不需要 API Key，在瀏覽器按下核准就好。
驗證採用 OAuth 2.1 with PKCE 與 Dynamic Client Registration：客戶端自動註冊，瀏覽器開啟你 Dashboard 的登入頁，由你在授權畫面親自核准。
- 複製你的 Endpoint
MCP Server 就在你部署的 Dashboard 的 /api/mcp — 跟你平常登入的是同一個網域，不需要多跑任何服務。
- 加入你的客戶端
Claude Code 與 Codex 各一行指令、Claude 加一個 Custom Connector、Cursor 填一個 URL — 在下方切換查看各客戶端的做法。
- 登入並核准
瀏覽器會開啟 Dashboard 登入頁。核准唯讀權限後 Agent 就連上了 — 隨時可以在 Settings 撤銷。
執行一行指令（頁面上方可複製），接著在 Claude Code 裡輸入 /mcp，瀏覽器開啟後完成登入。
授權存取
Claude 想要連接你的 Threads Analytics。
這將允許該 agent：
讀取你的貼文、數據與分析資料
它無法修改任何資料，也無法代替你發文。
已連接的 agent
你已授權讀取分析資料的 MCP client。
03如何使用
用自己的話問，或從 Prompt 範本開始。
連接完成後工具會自動出現，不需要任何設定。直接詢問帳號的任何問題，或執行七個內建 Prompt，多數都能加上像 30d、90d 的期間參數，月報則指定月份。
Agent 會自己決定呼叫哪些工具 — 先看帳號總覽，再視需要讀取貼文、分析或粉絲紀錄。
performance-review成效回顧整體趨勢、表現最好與最差的貼文及原因，加上下個期間的三個具體行動。
content-strategy內容策略哪些形式、長度與主題有效 — 以及接下來該採用的內容配比。
posting-schedule發文排程根據受眾實際互動的時段，排出具體的每週發文時間表。
viral-post-breakdown爆紅貼文解析深入拆解表現突出的貼文，萃取可以重複使用的模式。
audience-insights受眾洞察粉絲成長與輪廓數據，以及它們對內容與發文時間的意義。
topic-analysis主題分析哪些主題與寫作模式帶動成效，並附上五個套用這些模式的貼文靈感。
monthly-review月報單月表現對照上月與基準，為上月的實驗打分數，並提出三個下個月要試的新實驗。
讓你的 Agent 讀懂你的數據。
部署 Dashboard、連接你慣用的 Agent，下一份成效報告只差一個 Prompt。
所有連接中的 Agent 都會列在 Settings → Connected Agents，一鍵即可撤銷存取。