Throk MCP 安裝教學：在 Claude、ChatGPT、Codex、Cursor 加入 Threads 數據工具

Throk 提供 MCP（Model Context Protocol） 伺服器。設定好之後，你可以直接用自然語言請 Claude、ChatGPT、Codex、Cursor 等 AI 助手查資料，例如：

幫我看「減脂」最近 30 天在台灣的聲量趨勢，再找出讚數最高的 5 篇串文，整理它們的開頭寫法。

連線資訊

項目	值
網址	https://premium-api.throk.ai/mcp
傳輸方式	Streamable HTTP
認證	用 Throk 帳號登入（OAuth），或標頭 Authorization: Bearer sk-throk-...（與 REST API 使用同一把金鑰）

兩種連接方式

• 用 Throk 帳號登入（建議）：AI 工具會開啟瀏覽器，你登入 Throk、按允許後就會回到 AI 工具，不需要 API 金鑰。可以用 Google 帳號或 Email 登入連結登入；用 Email 時，請在同一個瀏覽器開啟信中的連結。
• 用 API 金鑰：在開發者平台的 API 金鑰 頁面建立金鑰，填進 AI 工具的設定。

兩種方式都使用同一個帳戶的 API 積分，見下方積分。

安裝

開發者平台的 MCP 伺服器 頁面也有各個 AI 工具的設定範例，可以直接複製。

Claude Code

用 Throk 帳號登入：執行下面的指令，再在 Claude Code 輸入 /mcp，選擇 throk 並登入。

claude mcp add --transport http throk https://premium-api.throk.ai/mcp

用 API 金鑰：在指令加上 --header。

claude mcp add --transport http throk \
  https://premium-api.throk.ai/mcp \
  --header "Authorization: Bearer sk-throk-..."

Claude Desktop

用 Throk 帳號登入：把 Throk 加成連接器。

1. 開啟 設定 › 連接器，新增自訂連接器。
2. 名稱填 Throk，網址填 https://premium-api.throk.ai/mcp。
3. 按 連接，在瀏覽器登入 Throk 並允許授權。

用 API 金鑰：透過 mcp-remote 帶上金鑰，需要先安裝 Node.js。在 claude_desktop_config.json 加入以下設定，再重新啟動 Claude Desktop：

{
  "mcpServers": {
    "throk": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://premium-api.throk.ai/mcp",
        "--header", "Authorization:${THROK_AUTH}"
      ],
      "env": { "THROK_AUTH": "Bearer sk-throk-..." }
    }
  }
}

args 請照抄，只要把 env 裡的 sk-throk-... 換成你的金鑰。

Cursor

用 Throk 帳號登入：在 ~/.cursor/mcp.json（或專案內的 .cursor/mcp.json）只填網址，再到 Cursor 設定的 MCP 頁面登入。

{
  "mcpServers": {
    "throk": {
      "url": "https://premium-api.throk.ai/mcp"
    }
  }
}

用 API 金鑰：加上 headers。

{
  "mcpServers": {
    "throk": {
      "url": "https://premium-api.throk.ai/mcp",
      "headers": {
        "Authorization": "Bearer sk-throk-..."
      }
    }
  }
}

Codex／ChatGPT 桌面版

Codex App、Codex CLI 與 ChatGPT 桌面版共用同一份 MCP 設定。

用 Throk 帳號登入：

• App：到 Plugins › Add › Create MCP App，Server URL 填 https://premium-api.throk.ai/mcp，Authentication 選 OAuth，建立後登入 Throk 並允許授權。需要圖示的話，可以下載 Throk 圖示上傳。
• CLI：在 ~/.codex/config.toml 加入以下設定，再執行 codex mcp login throk。

[mcp_servers.throk]
url = "https://premium-api.throk.ai/mcp"

用 API 金鑰：App 的 Authentication 改選 Bearer token 並貼上金鑰。CLI 則在 config.toml 指定存放金鑰的環境變數：

[mcp_servers.throk]
url = "https://premium-api.throk.ai/mcp"
bearer_token_env_var = "THROK_API_KEY"

export THROK_API_KEY=sk-throk-...

ChatGPT

ChatGPT 網頁版以開發者模式加入（Plus、Pro、Business、Enterprise、Edu 方案），用 Throk 帳號登入：

1. 在 ChatGPT 設定開啟開發者模式，新增連接器。
2. 名稱填 Throk，MCP 伺服器網址填 https://premium-api.throk.ai/mcp，驗證方式選 OAuth。
3. 建立後登入 Throk 並允許授權，就能在對話中使用。

積分

• API 金鑰與用 Throk 帳號登入的 AI 工具，共用同一個帳戶的 API 積分。每個工具的費用見下方可用的工具，也可以隨時請 AI 助手呼叫 get_balance 查詢餘額。
• 帳戶沒有 API 方案時仍然可以連接，但呼叫工具會回傳錯誤，並附上開發者平台購買積分頁面的連結。
• Throk 網頁版（app.throk.ai）的積分與 API 積分分開計算，不能用在 MCP。

中斷連線

• 用 API 金鑰連接的工具：在開發者平台的 API 金鑰 頁面刪除金鑰即可。
• 用 Throk 帳號登入的工具：刪除 API 金鑰不會中斷這些連線，請到開發者平台的 MCP 伺服器 頁面中斷。

可用的工具

所有工具都是唯讀的。

搜尋

工具	用途	積分
search_posts	關鍵字搜尋串文（最多 25 筆）	每篇 1 積分（含詳細資料每篇 2 積分）
semantic_search_posts	以意思搜尋最近 30 天的串文（最多 10 筆）	30 積分
get_inspiration	從高互動精選串文中找靈感（最多 10 筆）	30 積分
get_hot_posts	熱門串文（30–50 筆）	70 積分起，每多 1 篇加 2 積分（依瀏覽數排序為 100 積分起）
get_keyword_trend	關鍵字每日聲量（最多 10 個關鍵字、90 天）	3 積分 × 關鍵字數 × 天數（含互動數為 4 積分）

get_inspiration 可以用 language 參數選串文語言（全部 7 種，包括英文 en）；沒有指定時回傳中文、日文與韓文串文，不含英文。可用的值見串文語言。

帳號

工具	用途	積分
get_user	帳號資料與近期串文	1 積分，每 5 篇串文加 1 積分
get_user_top_threads	帳號讚數最高的串文	70 積分起
get_user_follower_history	帳號每日粉絲數（最多 365 天）	天數 ÷ 3（無條件進位），最低 1 積分
get_user_interactions	找出最常互動的人：帳號最常互相回覆的人（最多 100 個、90 天）	10 個以內 30 積分，每多 1 個加 2 積分；沒有互動時免費

排行榜

工具	用途	積分
get_cool_replies	神回覆排行	70 積分起
get_post_like_growth	爆紅串文（讚數成長最快）	70 積分起
get_follower_growth	粉絲成長最快的帳號	70 積分起
get_follower_ladder	粉絲數天梯（各級距門檻）	5 積分
get_like_ladder	讚數天梯（最近 24 小時）	5 積分
get_power_hours	平台黃金發文時段（最近 28 天）	5 積分

排行榜、天梯與黃金時段工具和搜尋工具一樣，用 language 參數選串文語言（預設 zh），每種語言分開計算（get_follower_growth 也支援全部 7 種）。可用的值見串文語言。

即時數據與預測

工具	用途	積分
forecast_posts	預測發文 1–12 小時內的串文能否達到瀏覽數門檻	每篇 10 積分
get_live_posts	即時讀取串文目前的數字（不限發文時間）	每篇 3 積分（瀏覽數隱藏時 1 積分）
get_live_users	即時讀取帳號目前的粉絲數與資料	每個帳號 3 積分

帳戶

工具	用途	積分
get_balance	查詢剩餘積分	免費

與 REST API 的差異

• 筆數上限較小，讓回應保持精簡，例如 search_posts 最多 25 筆、semantic_search_posts 最多 10 筆。需要大量資料時請改用 REST API。
• 預設不含媒體網址與大頭貼網址。 需要時，在有提供這個參數的工具加上 include_media=true。
• 每次呼叫的逾時為 60 秒。
• 搜尋規則與 REST API 完全相同，請見搜尋規則。

Throk MCP 的功能介紹與方案價格，請見 Throk MCP。