MCP 経由で Yandex Direct を Gemini に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Yandex Direct をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Yandex Direct + Gemini

Yandex Direct の広告を AI に読み取り専用で分析させます。キャンペーン、広告グループ、広告、キーワードと入札単価、サイトリンクとコールアウト、代理店のクライアント、ディクショナリ、変更の追跡、そして日別、キャンペーン別、広告別、検索クエリ別の統計レポートに対応します。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

YANDEX_DIRECT_TOKEN

ステップ 1 — 認証情報を取得

セットアップは約 10 分で、これに Yandex が API アクセスを承認するまでの時間（1 時間から数営業日）が加わります。キャンペーンが 1 つ以上ある Yandex Direct アカウントと、oauth.yandex.ru に登録した自分のアプリが必要です。

1. oauth.yandex.ru でアプリを登録します。プラットフォームは Web サービス、権限は Yandex Direct API（direct:api）です。アプリの ClientID を控えておきます。
2. Yandex Direct の Web 画面で Tools → API を開き、その ClientID で API アクセスを申請して API 利用規約に同意します。Yandex が申請を承認するまで、呼び出しはエラー 58 で失敗します。
3. Direct アカウントでサインインした状態で、自分の ClientID を入れた https://oauth.yandex.ru/authorize?response_type=token&client_id=<ClientID> を開き、access_token（y0_ で始まります）を YANDEX_DIRECT_TOKEN にコピーします。先頭に Bearer や OAuth は付けません。トークンの有効期間は約 1 年で、使っている間は延長されます。
4. 代理店の場合のみ: 読み取る広告主の Yandex ログインを YANDEX_DIRECT_CLIENT_LOGIN に設定します。ログインの一覧は yandex_direct_list_agency_clients で取得できます。自社アカウントの場合は空のままにします。
5. コネクターをインストールし、yandex_direct_get_client を実行します。アカウント、ログイン、通貨が表示されます。

読み取れるデータ: タイプ、ステータス、状態、期間、資金、累計のクリック数と表示回数、入札戦略を含むキャンペーン、地域と除外キーワードを含む広告グループ、タイトル、本文、リンクを含む広告、入札単価と生産性を含むキーワードとオートターゲティング、検索の各掲載順位に必要な入札単価とトラフィックを含むキーワード入札、サイトリンク、コールアウト、共有の除外キーワードセット、リターゲティングリスト、代理店のクライアント、通貨や地域などのディクショナリ、指定時点以降に変更されたキャンペーン、そして日別、キャンペーン別、広告別、検索クエリ別の統計レポートです。

レポート: yandex_direct_get_report はタブ区切りのテキストを返し、1 行目が列名、金額は小数です。小さなレポートはすぐに返ります。大きなレポートはオフラインで作成され、AI は Yandex が示す待ち時間の後に同じパラメーターでもう一度要求します。キューに入れられるオフラインレポートは最大 5 件で、検索クエリレポートはオフラインのみ、対象は直近 180 日間です。

金額とページ送り: 入札単価、予算、資金はマイクロ単位の整数で返ります（2500000 = アカウント通貨で 2.50）。一覧は標準で最大 500 件、上限は 10,000 件で、広告グループ、広告、キーワードは 1 回の呼び出しで最大 10 キャンペーン分を読み取ります。

設計上、読み取り専用: すべてのツールは読み取りだけを行います。作成、変更、一時停止、支払いは一切しないため、確認が必要な操作も、インストール時にオフになっているツールもありません。

制限: どの呼び出しも広告主の 1 日あたりの割り当てから API ポイントを消費し、失敗した呼び出しは 20 ポイントかかります。AI は単発の呼び出しを何度も行うより、複数の ID をまとめた 1 回の呼び出しを優先し、必要なフィールドだけを要求します。エラー 152 は本日のポイントを使い切ったこと、506 は同時リクエストが多すぎることを示します。

よくあるエラー: 53 はトークンが無効または期限切れであることを示し、手順 3 のとおり新しいトークンを取得します。58 はアプリの API アクセスがまだ承認されていないことを示します。54、3000、3001 は API アクセスや権限がないこと（たとえばトークンで読み取れないクライアントログイン）を示します。513 はログインが Direct に接続されていないこと、8000 と 4000 から 4006 はパラメーターの誤り、8800 はオブジェクトが見つからないこと、9300 は 1 回の呼び出しの ID が多すぎることを示します。

このコネクターは、キャンペーン、広告、キーワード、入札単価の作成や編集、審査、予算、支払いの処理、Sandbox や Wordstat の利用は行いません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Gemini にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう。Gemini CLI が Yandex Direct のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「先週のキャンペーンの成果を教えてください。キャンペーンごとの表示回数、クリック数、CTR、費用、コンバージョンを見せてください。」
• 「過去 30 日間で、コンバージョンが 1 件もないのに最も費用がかかった検索クエリはどれですか。」
• 「『冬タイヤ』キャンペーンのキーワードを入札単価と一緒に一覧にし、上位表示に必要な単価も教えてください。」
• 「現在、却下されている広告や配信されていない広告はどれですか。理由も教えてください。」
• 「私たちは代理店です。クライアントの一覧を出し、クライアント romashka-shop の昨日の費用を見せてください。」

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続