ガイド / MCP SERVER
Threads MCP で、データはひと言で手元に。
MCP サーバー内蔵。Claude Code、Claude、Codex、Cursor をつなげば、投稿・分析・フォロワーのデータに直接質問できます。読み取り専用で、接続はあなたが承認します。
約 2 分 · API キー不要 · 読み取り専用
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 をデプロイ済みダッシュボードのドメインに置き換えてください。
01できること
読み取り専用ツール 8 つ、レポートプロンプト 7 つ。
MCP サーバーは同期済みデータを構造化ツールとして公開します。自然な言葉で質問するだけで、エージェントが必要なツールを選び、必要な分だけ読み取ります。
get_account_overviewアカウントをひと目で把握接続済み全アカウントのユーザー名、同期状態、投稿数、データ範囲、フォロワー成長サマリー — どの会話も最初に呼ぶツールです。複数アカウントがある場合、エージェントがどれを見るか尋ねます。
list_posts · get_postすべての投稿を検索・閲覧日付・メディアタイプ・テキストで絞り込み、閲覧数・いいね・エンゲージメント率で並べ替え、任意の投稿の全文を取得。
get_analytics31 種類の分析セクション最適な投稿時間、キーワード分析、投稿ストリーク、閲覧数分布など — 指定した期間でその場で計算します。
get_follower_history · compare_post_growthあらゆる伸びを追う日次フォロワースナップショットと成長サマリー、最新のオーディエンス内訳に加え、各投稿が投稿後どう伸びたかを 1 時間単位で、同じ経過時間の他の投稿と比べて確認できます。
compare_periods · get_monthly_review期間比較と月次レビュー投稿数・閲覧数・エンゲージメント・フォロワー成長を並べて変化を比較。月単位なら前月と基準期間に対する月次レビューと、先月の実験の採点まで行います。
内蔵プロンプト 7 種レポートはワンクリック月次レビュー、パフォーマンスレビュー、コンテンツ戦略など 7 種類 — クライアントのメニューから選ぶだけで完全なレポートが届きます。
02接続方法
API キーは不要。ブラウザで承認するだけ。
認証は OAuth 2.1(PKCE)と Dynamic Client Registration。クライアントが自動で登録し、ブラウザにダッシュボードのログイン画面が開き、同意画面であなたが承認します。
- エンドポイントをコピー
MCP サーバーはデプロイ済みダッシュボードの /api/mcp にあります。いつもログインしているドメインと同じで、追加のサービスは不要です。
- クライアントに追加
Claude Code と Codex はコマンド 1 行、Claude はカスタムコネクタ、Cursor は URL の設定 1 つ — 下で切り替えて確認できます。
- ログインして承認
ブラウザにダッシュボードのログインが開きます。読み取り専用スコープを承認すれば接続完了 — いつでも Settings から取り消せます。
コマンド 1 行を実行し(ページ上部でコピーできます)、Claude Code 内で /mcp を実行して、開いたブラウザでログインを完了します。
接続済みエージェント
分析データの読み取りを許可した MCP クライアント。
03使い方
自分の言葉で質問するか、プロンプトから始める。
接続すればツールは自動で現れ、設定は不要です。アカウントについて何でも質問するか、7 つの内蔵プロンプトを実行してください。多くは 30d や 90d のような期間指定に、月次レビューは月の指定に対応します。
どのツールを呼ぶかはエージェントが判断します — まず概要を見て、必要に応じて投稿・分析・フォロワー履歴を読み取ります。
performance-reviewパフォーマンスレビュー全体トレンド、ベスト/ワースト投稿とその理由、次の期間への具体的なアクション 3 つ。
content-strategyコンテンツ戦略どの形式・長さ・トピックが効いているか — そして今後の最適なコンテンツ配分。
posting-schedule投稿スケジュールオーディエンスが実際に反応する時間帯から、具体的な週間スケジュールを提案。
viral-post-breakdownバズ投稿の分解突出した投稿を深掘りし、再現可能なパターンを抽出します。
audience-insightsオーディエンス分析フォロワー成長と属性データ、そしてコンテンツと投稿時間への示唆。
topic-analysisトピック分析成果を生むトピックと文章パターン、それを応用した投稿アイデア 5 つ。
monthly-review月次レビュー1 か月を前月と基準期間で比較し、先月の実験を採点して、来月試す実験を 3 つ提案します。
エージェントに、自分のデータを。
ダッシュボードをデプロイし、いつものエージェントを接続すれば、次のレポートはプロンプト 1 つの距離です。
接続中のエージェントは Settings → Connected Agents に表示され、ワンクリックで取り消せます。
