Yandex Direct MCP

Yandex Direct MCP は、AIアプリケーションをYandex Directの広告アカウントに接続します。自然言語で「広告予算がどこに使われているか」を尋ね、キャンペーン・広告・キーワードを照合し、アカウントの各セクションを行き来することなく必要な変更を準備・実行できます。接続はダイアログ内でそのまま開始できます。事前にトークンを作成したり、設定を編集したりする必要はありません。

• 44のツール。 キャンペーン、広告グループ、広告、キーワード、入札単価、調整、拡張機能、統計、残高、リファレンス、そしてダイアログ内でのアカウント接続。

• 2つの接続方法。 URLによるリモートサーバーは、手動でトークンを取得する必要がなく、データの読み取りのみを行います。npxによるローカル接続は、アカウントへのフルアクセスを提供します。

• チャットでの接続。 Yandexがログインページを開きます。チャットでコードを受け取った後、すぐに広告を操作でき、アクセスは自動的に延長されます。

• わかりやすい金額表示。 便利なツールでは、予算・入札単価・残高がAPIのマイクロ単位ではなく、アカウントの通貨で表示されます。

• 実際の広告。 ローカルでの変更は本番アカウントに適用され、支出に影響を与える可能性があります。テスト環境での作業には、Yandex Directのサンドボックスがあります。

最初のメッセージでお試しください：

アカウントのキャンペーンと、先週の広告グループ別の支出を表示して。

サーバーを接続 · シナリオを見る · 技術ドキュメントを開く

1分で動作を確認

あなた： Yandex Directを接続して。

アシスタント： Yandexへのログインリンクを提供します。目的の広告アカウントにアクセスできるアカウントで開き、アクセスを承認して、表示されたコードを送信してください。

あなた： Yandexのページからコードを送信します。

アシスタント： Directを接続し、アカウントを表示します。アプリケーションを再起動する必要はありません。

あなた： アカウントのキャンペーンと、先週の広告グループ別の支出を表示して。

アシスタント： キャンペーンを検索し、広告グループ別のレポートを作成して、アカウントの通貨で支出を表示します。

Related MCP server: Yandex Direct MCP Server

目次

• クイックスタート

• 任せられること

• 仕組み

• データを変更できる操作

• 接続と設定

• データとテレメトリー

• 制限事項

• 技術ドキュメント

• サポート

クイックスタート

1. 接続方法を選択し、以下の手順に従ってAIアプリケーションにサーバーを追加します。

2. 新しいダイアログを開いて、次のように尋ねます：「アカウントのキャンペーンと、先週の広告グループ別の支出を表示して」。

トークンを自分で取得せずに分析 — URL経由

リモートサーバー https://mcp.askads.ru/mcp は、URLによるMCPをサポートするアプリケーションから接続します。ブラウザでYandexにログインし、アクセスを承認します。トークンを設定ファイルに渡す必要はありません。このオプションは読み取り専用です。統計、監査、オブジェクトの閲覧用であり、広告設定は変更しません。

Claude Codeでは、次のコマンドで追加できます：

claude mcp add --transport http yandex-direct https://mcp.askads.ru/mcp

接続後、/mcp を開いて認証を完了します。HTTP MCPをサポートするその他のアプリケーションでは、アプリケーションのインターフェースから同じURLを追加します。

フルアクセス — npx によるローカル接続

オブジェクトの作成・変更にはNode.js 20+が必要です。npx は初回起動時にサーバーをダウンロードします。パッケージを個別にインストールする必要はありません。トークンを事前に取得する必要もありません。接続はダイアログ内でそのまま開始できます：

1. AIアプリケーションにサーバーを追加します。以下はCodexの例です。その他のアプリケーションは折りたたみ式の手順にまとめられています。

2. 「Yandex Directを接続して」と入力します。アシスタントがYandexへのログインを案内し、アカウントを表示します。

CIおよびエージェント環境向けには、準備済みのトークンと YANDEX_DIRECT_LOGIN を使用します。接続と設定 を参照してください。

アプリケーションのインターフェースから：

1. Settings → Plugins → MCP servers を開きます。

2. Add server をクリックします。

3. 起動コマンド npx -y mcp-yandex-direct@latest を追加します。

コマンドラインから：

codex mcp add yandex-direct -- npx -y mcp-yandex-direct@latest

接続を確認します：

codex mcp list

Codex公式手順

claude mcp add --transport stdio --scope user yandex-direct -- npx -y mcp-yandex-direct@latest

接続を確認するには：claude mcp list。

Settings → Developer → Edit Config を開き、claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "yandex-direct": {
      "command": "npx",
      "args": ["-y", "mcp-yandex-direct@latest"]
    }
  }
}

Developerセクションがない場合は、ファイルを手動で開きます：macOS — ~/Library/Application Support/Claude/claude_desktop_config.json、Windows — %APPDATA%\Claude\claude_desktop_config.json。Claude Desktopを再起動します。

~/.cursor/mcp.json を開いてすべてのプロジェクトでサーバーを接続するか、特定のプロジェクトの .cursor/mcp.json を開きます。以下を追加します：

{
  "mcpServers": {
    "yandex-direct": {
      "command": "npx",
      "args": ["-y", "mcp-yandex-direct@latest"]
    }
  }
}

コマンドパレットで MCP: Open User Configuration を実行します。開いた mcp.json にサーバーを追加します：

{
  "servers": {
    "yandex-direct": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-yandex-direct@latest"]
    }
  }
}

保存後、MCP: List Servers を実行し、リストからサーバーを起動します。

任せられること

予算の使われ方を確認する

• 「先週、最も多く使ったキャンペーンはどれ？」

• 「インプレッションとクリックはあるのに、コンバージョンにつながらない広告はどれ？」

• 「1ヶ月のキャンペーン別の支出、CTR、平均クリック単価を比較して」。

• 「アカウントの残高とAPIの日次クォータの残りを表示して」。

改善点を見つける

• 「予算を消費しているのにクリックがないキーワードはどれ？」

• 「現在停止中またはモデレーションに通っていないグループと広告はどれ？」

• 「モバイルデバイスに適用されている入札単価調整を確認して」。

• 「このキャンペーンにはどのクイックリンクと補足説明がある？」

変更を準備する

• 「CTRが高いキーワードの新しい入札単価を提案して、適用前の変更内容を表示して」。

• 「このテーマのキャンペーンにマイナスキーワードがあるか確認して、リストを準備して」。

• 「モスクワ向けの新しいテキストキャンペーンのパラメータをまとめて：予算、グループ、キーワード、広告」。

明示的な操作を実行する

• 「これらのキーワードをグループ123に追加して、入札単価を45₽に設定して」。

• 「広告456を一時停止して」。

• 「画像付きのページを広告ライブラリに送信して」。

仕組み

広告は通常、3つのレベルで構成されます：キャンペーン → 広告グループ → 広告。グループにはキーワード、配信設定、入札単価調整があります。広告にはクイックリンク、補足説明、名刺、画像を含めることができます。

サーバーはこれらのオブジェクトをまとめて表示するのに役立ちます。キャンペーンの支出をグループの統計、キーワード、広告に関連付けます。新しいキャンペーンと広告を作成できるのはテキストタイプのみです。その他のタイプのキャンペーンは、読み取り、名前変更、予算変更、停止、アーカイブ、IDによる削除が可能です。

統計は即座には生成されません。get_statistics はReportsサービスでレポートを開始し、準備ができるまで待機します。大きなリストは autoPaginate が結果のページを自動的に巡回します。

データを変更できる操作

URLによるリモートサーバーはデータの読み取りのみを行います。npx によるローカルサーバーは、実際の広告アカウントを変更できます：

ツールはAIアプリケーションに読み取り・書き込み・潜在的に元に戻せない操作のラベルを渡します。アプリケーションは確認を表示できますが、その動作はクライアントに依存します。API直接リクエストは、confirmWrite=true がない限り書き込みを実行しません。広告を変更するには明示的な依頼が必要です。

接続と設定

通常の使用では、トークンを事前に用意する必要はありません：

1. チャットでYandex Directの接続を依頼します。

2. 目的の広告アカウントにアクセスできるアカウントで Yandex OAuthのリンクを開きます。

3. アクセスを承認し、表示されたコードをチャットに送信します。これで広告を操作できます。クライアントを再起動する必要も、設定を編集する必要もありません。

その後、接続は自動的に維持されます。アクセスは自動的に延長され、1年で失効することはありません。状態を確認するには「接続ステータスを表示して」、無効にするには「Directを切断して」と依頼します。付与されたアクセスは Yandex ID で取り消せます。

ダイアログがないCIおよび自動インストール環境向けには、環境変数による設定が利用可能です：

YANDEX_DIRECT_TOKEN 用の準備済みトークンは、目的のアカウントにアクセスできるアカウントでログインして、以下のリンクから取得できます：

Yandex Directのトークンを取得

トークンをチャット、リポジトリ、スクリーンショットに公開しないでください。トークンは広告アカウントへのアクセスを提供し、予算に影響を与える可能性のある操作も含まれます。

データとテレメトリー

デフォルトでは、サーバーは匿名の技術イベントを送信します。ランダムなインストールID、呼び出されたツールの名前、サーバー、AIアプリ、Node.js、オペレーティングシステムのバージョンです。これは、サーバーのどの部分が使用されているか、起動時に問題が発生するかを把握するために必要です。Yandexトークン、広告アカウントのデータ、ツールの引数、クエリテキスト、環境変数の値と名前は送信されません。

Ask Ads MCPサーバーのテレメトリーを無効にするには、環境変数を設定します：

ASKADS_TELEMETRY=0

制限事項

• APIの日次クォータ。 各呼び出しはUnitsを消費します。get_quota ツールは、消費量、残量、本日利用可能な量を表示します。

• レポートの制限。 Yandexレポートには、1日あたりの容量と件数に独自の制限があり、Reportsサービスでのレポートの準備ができるまで待つ必要があります。

• 大きなリスト。 自動ページネーションで内部制限に達した場合、サーバーは結果を明示的に不完全としてマークし、隠しません。

• 一時的なエラー。 サーバーはレート制限時に最大3回再試行します。ネットワークエラーとサーバーエラーは、変更を重複させないために読み取り専用操作でのみ自動的に再試行されます。

• 本番アカウント。 ローカルの変更は実際の広告アカウントに適用され、支出に影響を与える可能性があります。テストにはサンドボックス（YANDEX_DIRECT_SANDBOX=true）を使用してください。

• 常時監視はありません。 サーバーはAIアプリからの呼び出し中にのみ動作します。アプリが定期タスクをサポートしている場合は、必要な指標を確認するための定期的なリクエストを設定できます。

技術ドキュメント

• MCP機能カタログ — 各ツールのユーザータスク別ページ。

• 全ツール — 各ツールのパラメータ、応答、制限。

• 開発 — プロジェクトの構成とソースコードの扱い。

• Yandex Direct API — APIとその制限に関する一次情報。

• npmパッケージ — 公開されているサーバーのバージョン。

サポート

バグを見つけた、またはシナリオが不足していますか？ issueを作成 するか、Telegram でお問い合わせください。