この接続はβ版・実アカウント未検証です。利用者の環境で初回取得を確認する必要があります。
自動投稿やキーワード検索が目的なら、この読み取りツールでは達成できません。必要な権限・エンドポイントに対応した別の構成を選びます。
接続前に用意するもの
Xの開発者向けAPIでユーザー投稿を読めるBearer Tokenと利用枠を確認します。対象は@から始まるユーザー名ではなく数値のユーザーIDです。トークンはSynapse MCPの設定欄だけに入力し、AIの会話へ貼らないでください。
XをSynapse MCPへ接続する
Synapse MCPにログインして対象店舗の接続画面を開き、「媒体を追加」からXを選びます。
Synapse MCPの店舗画面でXを選び、APIキー/トークンを入力します。XユーザーID(数値)も指定してください。ユーザー投稿の読み取りに対応するBearer Token。X側のAPI利用枠が別途必要です。接続を保存しただけでは実データの取得確認は完了しません。AIから最初の取得を行い、媒体の画面と照合します。
AI側にもMCP接続を登録する
新規の有料プランは1契約=1店舗で、各媒体1アカウントを接続できます。フリー・Plus系では対象プロジェクトを開いて操作します。
- 店舗の接続画面の「MCPリンク」で、利用するAI向けのリンクを発行します。
- AIのカスタムコネクタ/MCPアプリ設定へ登録し、Synapse MCPの認証を完了します。
- 新しい会話でその接続を有効にし、下の質問を送ります。別案件のコネクタは同じ会話で有効にしないでください。
登録条件はAIのプラン・組織設定によって異なります。Claude・ChatGPTへのMCP登録手順も確認してください。冒頭の「AIに聞く」は記事の相談用で、押すだけでは実データを読めるようになりません。APIキーやMCPリンクを会話本文に貼らず、接続設定欄へ入力します。
最初の取得と確認
次の質問は使用例で、実際の取得結果ではありません。媒体接続とAI側のMCP登録を済ませてから使ってください。
Synapse MCPの x_recent_posts で設定済みユーザーの直近投稿を取得してください。投稿ID・投稿日・本文・取得できた公開反応数を表にし、対象ユーザーと取得件数を明記してください。追加ページがある場合は全件取得済みとは書かず、投稿や返信はしないでください。
ここまで確認できたら完了
X上の対象投稿と投稿日・本文を照合します。反応数は取得時点の値として確認し、テーマ別の整理へ進みます。インプレッションが返らない場合、反応率の分母を推測して作らないでください。
投稿のテーマと反応を同じ表にする
まず取得した投稿を、告知・ノウハウ・事例・問いかけなど、本文に基づくテーマへ分類します。そこへ公開反応数を並べれば、どのテーマを次の企画会議で検討するか話しやすくなります。
反応数は公開からの時間にも影響されます。昨日の投稿と一か月前の投稿を同じ条件として順位づけせず、投稿日と取得日時を残します。反応の差だけで本文の良し悪しや売上への寄与を断定しない振り返りにします。
投稿の確認と、投稿代行は別の仕事
この接続で行うのは投稿の読み取りです。文章の修正案をチャット内で作ることはできますが、Xへの投稿・返信・削除は行いません。DMや非公開の詳細分析、X全体を対象にした検索も、この取得ツールの範囲ではありません。
APIを直接開発する場合と違い、Synapse MCPではキーと対象ユーザーIDを登録してAIから呼び出せます。ただしX側のAPI利用枠は別に必要で、MCP接続によってその条件がなくなるわけではありません。
初回確認のあとに試す質問
以下は使い方の例です。実際の取得結果ではありません。追加で使う媒体も同じ店舗へ接続してから質問してください。
指定したXアカウントの取得可能な直近投稿を読み、テーマ別に分類してください。本文・投稿日・公開反応数を根拠にし、取得できた投稿の範囲を明記してください。
反応が多かった投稿の共通点を仮説として整理し、次に試す投稿案を3つ作ってください。成果が保証されるとは書かず、実際の投稿はしないでください。
うまくいかないとき
ユーザーIDの入力で止まる
@ユーザー名やプロフィールURLではなく、数値IDを指定します。手元にない場合はX公式のユーザー参照APIで対象を確認してください。
投稿が取れない・上限エラーになる
X側の読み取り権限・API利用枠・対象投稿へのアクセス可否を確認します。β版のため接続保存だけを動作確認の完了としません。
利用前に確認したいこと
ユーザー名ではなく数値のユーザーIDが必要です。投稿へのアクセス可否・取得量・費用はX側のAPI契約に従います。取得した本文に機密情報や個人情報が含まれないかも確認してください。
取得項目はSynapse MCPの対応ツール、APIの仕様はXの公式資料で確認できます。
