ガイド / MCP SERVER
Threads データ、ひと言で手元に。
デプロイしたダッシュボードは /api/mcp で MCP サーバーを公開しています。普段使っている AI エージェント — 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 / できること
読み取り専用ツール 6 つ、レポートプロンプト 6 つ。
MCP サーバーは同期済みデータを構造化ツールとして公開します。自然な言葉で質問するだけで、エージェントが必要なツールを選び、必要な分だけ読み取ります。
get_account_overviewアカウントをひと目で把握ユーザー名、同期状態、投稿数、データ範囲、フォロワー成長サマリー — どの会話も最初に呼ぶツールです。
list_posts · get_postすべての投稿を検索・閲覧日付・メディアタイプ・テキストで絞り込み、閲覧数・いいね・エンゲージメント率で並べ替え、任意の投稿の全文を取得。
get_analytics31 種類の分析セクション最適な投稿時間、キーワード分析、投稿ストリーク、閲覧数分布など — 指定した期間でその場で計算します。
get_follower_historyフォロワーの推移を追う日次フォロワースナップショットと成長サマリー、さらに最新の国・都市・年齢・性別の内訳も取得できます。
compare_periods任意の 2 期間を比較投稿数・閲覧数・エンゲージメント・フォロワー成長を並べて、実数と変化率で比較します。
内蔵プロンプト 6 種レポートはワンクリックパフォーマンスレビュー、コンテンツ戦略、投稿スケジュールなど 6 種類 — クライアントのメニューから選ぶだけで完全なレポートが届きます。
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 を実行して、開いたブラウザでログインを完了します。
アクセスを許可
Claude が Threads Analytics への接続を求めています。
このエージェントに以下を許可します：
投稿・メトリクス・分析データの読み取り
データの変更や、あなたに代わっての投稿はできません。
接続済みエージェント
分析データの読み取りを許可した MCP クライアント。
03 / 使い方
自分の言葉で質問するか、プロンプトから始める。
接続すればツールは自動で現れ、設定は不要です。アカウントについて何でも質問するか、6 つの内蔵プロンプトを実行してください。どれも 30d や 90d のような期間指定に対応します。
どのツールを呼ぶかはエージェントが判断します — まず概要を見て、必要に応じて投稿・分析・フォロワー履歴を読み取ります。
performance-reviewパフォーマンスレビュー全体トレンド、ベスト/ワースト投稿とその理由、次の期間への具体的なアクション 3 つ。
content-strategyコンテンツ戦略どの形式・長さ・トピックが効いているか — そして今後の最適なコンテンツ配分。
posting-schedule投稿スケジュールオーディエンスが実際に反応する時間帯から、具体的な週間スケジュールを提案。
viral-post-breakdownバズ投稿の分解突出した投稿を深掘りし、再現可能なパターンを抽出します。
audience-insightsオーディエンス分析フォロワー成長と属性データ、そしてコンテンツと投稿時間への示唆。
topic-analysisトピック分析成果を生むトピックと文章パターン、それを応用した投稿アイデア 5 つ。
エージェントに、自分のデータを。
ダッシュボードをデプロイし、いつものエージェントを接続すれば、次のレポートはプロンプト 1 つの距離です。
接続中のエージェントは Settings → Connected Agents に表示され、ワンクリックで取り消せます。