X Ads (Twitter Ads) と Gemini の接続方法

Gemini アプリ（個人アカウント）。 gemini.google.com を開き、Settings、Connected Apps の順に進み（表示されない場合は先に Personal Intelligence を開きます）、Custom apps の下で Add a custom app を選びます。

PaidSync のサーバー URL を貼り付けて Next をクリックします。PaidSync は自分自身を登録するため、コピーする API キーも、Advanced features に入力するものもありません。

ウェブで一度追加すれば、Gemini のモバイルアプリでも使えます。Google はカスタムアプリを、個人の Google アカウント、18 歳以上、米国、英語、Keep Activity オンに限定しています。

職場または学校のアカウントでは追加できないため、代わりに下の Gemini Enterprise を使ってください。

Gemini CLI。 コマンドを実行し、/mcp auth paidsync と入力して、PaidSync のログインでサインインします。

Google は 2026年6月18日に、無料プランと Google One のユーザー向けに Gemini CLI を Antigravity CLI に置き換えたため、それらのアカウントは下の Antigravity を使います。

VS Code の Gemini Code Assist エージェントモードは、Gemini CLI と同じ設定ファイルを読み込みます。~/.gemini/settings.json に次を追加します。

Antigravity は別のキーを使います。

エージェントパネルのメニューを開き、MCP Servers、Manage MCP Servers、View raw config の順に選ぶか、~/.gemini/config/mcp_config.json を編集して、serverUrl でサーバーを追加します。

Antigravity は、動的クライアント登録によって自動的にサインインします。

Gemini Enterprise、Business エディション。 チームの管理者が、Settings and help、Manage team、Connected apps、Add MCP Server の順に進んで PaidSync を追加します。

PaidSync は、Gemini が必要とする Streamable HTTP トランスポートと、https://api.paidsync.ai/authorize および https://api.paidsync.ai/token の OAuth 2.0 を提供します。

そのフォームが求めるクライアント認証情報については、support@paidsync.ai にメールしてください。

PaidSync のサインイン画面が開きます。Continue with Google を選ぶか、PaidSync のメールとパスワードでサインインします。次に PaidSync の画面で、PaidSync 経由で Gemini が広告アカウントを管理することを許可するか尋ねられます。承認する を押すと、PaidSync が接続されます。

PaidSync が初めてで、Google でサインインしますか？ Approve を押すと無料アカウント (100 タスク、クレジットカード不要) が作成されます。この画面には、PaidSync 内で接続済みの広告アカウントについての記載もあります。新しいアカウントでは、手順 3 を終えるまでその一覧は空です。

どのチャットでも 「X Ads を接続して」 と入力してください。Gemini がリンクを返し、X 自身のサインイン画面と認可画面が開きます。広告アカウントにアクセスできる X アカウントでサインインし、PaidSync を認可してください。PaidSync が X のパスワードを見ることはありません。

戻って 「X の広告アカウントを一覧表示して」 と入力します。Gemini は list_x_accounts で一覧を表示し、set_active_x_account で指定したアカウントを選びます。X の接続、広告アカウントの一覧表示、アカウントの選択ではタスクを消費しません。続けて 「過去 7 日間の X キャンペーンの成果を表示して」 と試してみてください。

任意の期間について、アカウント、キャンペーン、ラインアイテム別の費用、インプレッション、クリック、エンゲージメントを、広告アカウントの通貨とタイムゾーンで取得できます。

選択した広告アカウントのキャンペーン、ラインアイテム、プロモーテッドポスト。

キャンペーンは pause_x_campaign と enable_x_campaign、ラインアイテムは update_x_line_item で行います。

キャンペーンの一日予算は update_x_campaign_budget で、ラインアイテムの入札と、キャンペーンとラインアイテムの名前も変更できます。

新しいキャンペーン、ラインアイテム、プロモーテッドポストの作成と、クリエイティブのアップロードはできません。それらは X Ads Manager で作成してください。

PaidSync には、ターゲティング、カスタムオーディエンス、コンバージョンレポートに対応する X ツールはありません。

X は ads-api.x.com/mcp で X Ads 向けに運営しています。セットアップページでは、Ads API アクセスのある X 開発者アプリを作成してその OAuth 2.0 クライアント ID を使う必要があり、クライアントとして Grok と Claude Code が挙げられています(2026年9月30日確認)。

Zapier の Twitter 連携ページによると、同連携は 31 August 2023 付で廃止されました（30 Sep 2026 確認）。

n8n の X（旧 Twitter）ノードは投稿、ダイレクトメッセージ、ユーザー、リストを扱い、ドキュメントには広告関連の操作が記載されていません（30 Sep 2026 確認）。

X Ads API 上に MCP サーバーを自作し、X 開発者アプリを登録して、ホスティングと保守も自分で行います。

PaidSync へは、登録したときと同じ方法でサインインしてください。Continue with Google か、PaidSync のメールアドレスとパスワードを使います。

メールでサインインするユーザーでアカウントがない場合は、paidsync.ai/signup で作成してから、もう一度 Gemini に PaidSync を追加してください。X の認可画面でエラーになった場合は、Gemini にもう一度 「X Ads を接続して」 と依頼し、新しいリンクを取得してください。

Gemini に X 広告アカウントを一覧表示させ、名前または ID で目的のアカウントに切り替えます。list_x_accounts のあと set_active_x_account が実行され、以降の X へのリクエストはすべて選択したアカウントに送られます。切り替えでタスクは消費されません。

PaidSync は、認可した X アカウントがアクセスできる広告アカウントを一覧表示します。X Ads Manager で、この X アカウントにその広告アカウントへのアクセス権があるかを確認するか、アカウント管理者に追加を依頼し、もう一度 Gemini に広告アカウントの一覧表示を依頼してください。それでも表示されませんか？ support@paidsync.ai までメールでご連絡ください。

PaidSync は、チャットを軽く保つため、Gemini に短いスターターのツール一覧を表示します。まず Gemini に paidsync_context を呼び出すよう依頼してください。接続済みプラットフォームと、X を含む全ツールの一覧が返され、Gemini はそれらのツールを paidsync_exec 経由で実行します。Gemini に PaidSync がまったく表示されない場合は、設定、接続済みアプリの下に表示されているか確認してください。