Throk MCP の設定方法：Claude・ChatGPT・Codex・Cursor に Threads データツールを追加する

Throk は MCP（Model Context Protocol）サーバーを提供しています。設定が済めば、Claude、ChatGPT、Codex、Cursor などの AI アシスタントに自然な言葉でデータの照会を頼めます。例：

「減脂」の直近 30 日間の台湾での言及量の推移を調べて、いいね数が最も多い投稿を 5 件見つけ、それぞれの書き出しをまとめて。

接続情報

項目	値
URL	`https://premium-api.throk.ai/mcp`
トランスポート	Streamable HTTP
認証	Throk アカウントでログイン（OAuth）、またはヘッダー `Authorization: Bearer sk-throk-...`（REST API と同じキーを使用）

2 つの接続方法

Throk アカウントでログイン（おすすめ）：AI ツールがブラウザを開くので、Throk にログインして許可すると AI ツールに戻ります。API キーは不要です。Google アカウントかメールのログインリンクでログインできます。メールの場合は、メール内のリンクを同じブラウザで開いてください。
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 をコネクタとして追加します。

設定 › コネクタ を開き、カスタムコネクタを追加します。
名前に Throk、URL に https://premium-api.throk.ai/mcp を入力します。
接続を押し、ブラウザで 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）に URL だけを書き、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 アプリ、Codex CLI、ChatGPT デスクトップ版は同じ MCP 設定を共有します。

Throk アカウントでログイン：

アプリ：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 キーを使う：アプリでは 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 アカウントでログインします。

ChatGPT の設定で開発者モードをオンにし、コネクタを追加します。
名前に Throk、MCP サーバーの URL に https://premium-api.throk.ai/mcp を入力し、認証方式に OAuth を選びます。
作成後に Throk にログインして許可すると、会話で使えるようになります。

クレジット

API キーと、Throk アカウントでログインした AI ツールは、同じアカウントの API クレジットを共有します。各ツールの料金は下記の利用できるツールをご覧ください。残高は、AI アシスタントに get_balance を呼び出してもらえばいつでも確認できます。
アカウントに API プランがない場合も接続はできますが、ツールを呼び出すとエラーが返り、開発者プラットフォームのクレジットを購入ページへのリンクが示されます。
Throk ウェブ版（app.throk.ai）のクレジットは API クレジットとは別に管理され、MCP では使えません。

接続を解除する

API キーで接続したツール：開発者プラットフォームの APIキー ページでキーを削除します。
Throk アカウントでログインしたツール：API キーを削除しても接続は解除されません。開発者プラットフォームの MCPサーバー ページで解除してください。

利用できるツール

すべてのツールは読み取り専用です。

検索

ツール	用途	クレジット
`search_posts`	キーワードで投稿を検索（最大 25 件）	1 件につき 1 クレジット（詳細データ込みの場合は 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 パラメータで投稿の言語を指定できます（英語 en を含む 7 つすべてに対応）。指定しない場合は中国語・日本語・韓国語の投稿が返され、英語は含まれません。指定できる値は投稿の言語をご覧ください。

アカウント

ツール	用途	クレジット
`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 クレジット

ライブデータと予測

ツール	用途	クレジット
`forecast_posts`	投稿から 1〜12 時間以内の投稿が、閲覧数の基準に達するかを予測	1 件につき 10 クレジット
`get_live_posts`	投稿の現在の数値をリアルタイムで取得（投稿時期を問わない）	1 件につき 3 クレジット（閲覧数が非表示の場合は 1 クレジット）
`get_live_users`	アカウントの現在のフォロワー数とプロフィールをリアルタイムで取得	1 アカウントにつき 3 クレジット

アカウント残高

ツール	用途	クレジット
`get_balance`	残りのクレジットを照会	無料

REST API との違い

件数の上限が小さめです。 レスポンスを簡潔に保つためです。例：search_posts は最大 25 件、semantic_search_posts は最大 10 件。大量のデータが必要な場合は REST API を使ってください。
デフォルトではメディアの URL とプロフィール画像の URL を含みません。 必要な場合は、このパラメータに対応したツールで include_media=true を指定してください。
1 回の呼び出しのタイムアウトは 60 秒です。
検索ルールは REST API とまったく同じです。検索ルールをご覧ください。

Throk MCP の機能紹介と料金は Throk MCP をご覧ください。