教學 / MCP SERVER
Threads 數據，問一句就能到手。
你的 Dashboard 已經在 /api/mcp 運行著一個 MCP Server。連接你慣用的 AI Agent — 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一眼掌握帳號現況帳號名稱、同步狀態、貼文數、資料範圍與粉絲成長摘要 — 每段對話的第一個呼叫。
list_posts · get_post搜尋並閱讀每篇貼文依日期、媒體類型或文字篩選，依瀏覽、按讚或互動率排序，再取出任一篇貼文的完整內容。
get_analytics31 個分析區塊隨選即用最佳發文時間、關鍵字分析、發文連續紀錄、瀏覽分佈等 — 依你指定的日期範圍即時計算。
get_follower_history追蹤粉絲成長曲線每日粉絲快照與成長摘要，還能加上最新的國家、城市、年齡與性別輪廓。
compare_periods比較任意兩個期間貼文、瀏覽、互動與粉絲成長並列呈現，附上絕對值與百分比變化。
6 個內建 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主題分析哪些主題與寫作模式帶動成效，並附上五個套用這些模式的貼文靈感。
讓你的 Agent 讀懂你的數據。
部署 Dashboard、連接你慣用的 Agent，下一份成效報告只差一個 Prompt。
所有連接中的 Agent 都會列在 Settings → Connected Agents，一鍵即可撤銷存取。