この記事でわかること
- LINEヤフーは、検索広告とディスプレイ広告のデータをAIクライアントから参照できる公式MCPサーバーを公開しました。
- 広告アカウント、キャンペーン、広告、キーワード、レポートを参照できますが、広告設定の変更には対応していません。
- 単発の調査や項目確認には便利ですが、定期取得や大量処理では直接APIを使う構成が適しています。
生成AIによる要約
広告APIを自然言語で扱えれば、レポートの確認はかなり楽になるはずです。実際に動かしてみると、その期待は半分ほど当たっていました。
LINEヤフーは2026年9月15日、広告運用を支援する公式のMCPサーバーを発表しました。サービスの提供開始日は9月14日です。検索広告とディスプレイ広告のデータを、CodexなどのMCPクライアントから参照できます。
率直な結論を先に置きます。単発の調査やレポート項目の確認には便利です。一方、定期取得や大量処理では、広告APIを直接呼ぶほうが速く、挙動も管理しやすいと感じました。
LINEヤフー広告の公式MCPサーバーとは
MCP（Model Context Protocol）は、AIクライアントと外部サービスを接続するための共通仕様です。今回公開されたLY Ads MCP Serverは、MCPクライアントからLINEヤフー広告 APIを利用できるようにします。
確認時点のバージョンはv0.0.1です。ソースコードはGitHubで公開され、Apache License 2.0で提供されています。
| 項目 | 内容 |
|---|---|
| 対象 | 検索広告、ディスプレイ広告 |
| 接続方式 | Streamable HTTP |
| 接続先 | http://localhost:18765/mcp |
| 認証 | ビジネスID単位のMCP専用OAuthクライアント |
| 操作範囲 | 参照のみ |
広告の追加や変更、停止には対応していません。参照専用という制限は物足りなく見えるかもしれませんが、本番アカウントへAIを接続する最初の段階としては妥当です。設定変更を伴わず、取得できる情報と認証範囲を確かめられます。
参照できる広告データ
検索広告では、ベースアカウントと広告アカウントに加え、キャンペーン、広告グループ、広告、キーワード、除外キーワードを参照できます。ディスプレイ広告でも、アカウントから広告までの主要な階層と、広告グループのターゲティング設定を取得できます。
レポート取得では、AIが利用可能なフィールドを確認し、依頼内容に合う指標とディメンションを選びます。利用者がAPIのフィールド名を調べて指定する必要はありません。これは、MCPを使う価値が出やすい部分です。
取得結果は先頭50行が会話へ返り、全件はUTF-8のCSVとしてローカルへ保存されます。CSVは自動削除されないため、保存先と保持期間は利用者側で決める必要があります。
Codexで利用するまでの設定
利用には、LINEヤフー広告 APIの利用権限と、MCP専用のOAuthクライアントが必要です。通常の広告API用クライアントとは別に、専用ページからビジネスID単位で発行します。
Python 3.11以降、Git、pipxを用意し、OAuthクライアントの情報を環境変数へ設定します。シークレットをGit管理下のファイルへ保存してはいけません。
$env:LY_ADS_CLIENT_ID = "<発行されたClient ID>"
$env:LY_ADS_CLIENT_SECRET = "<発行されたClient Secret>"
$env:LY_ADS_MCP_JWT_SIGNING_KEY = "<別途生成したランダムな値>"
$env:LY_ADS_REPORT_OUTPUT_DIR = "$HOME\.ly-ads-mcp\reports"公式READMEでは、バージョンを指定した次の起動方法が案内されています。
pipx run --spec "git+https://github.com/yahoojp-marketing/ly-ads-mcp-server.git@v0.0.1" ly-ads-mcpサーバーが起動したら、Codexへ接続先を登録してOAuth認証を行います。
codex mcp add ly-ads-mcp --url http://localhost:18765/mcp
codex mcp login ly-ads-mcpブラウザでは、対象の広告アカウントへアクセスできるビジネスIDを選びます。OAuth認証後にCodexを再起動すると、LINEヤフー広告の参照ツールを利用できます。
実際の広告アカウントで試した結果
実際の広告アカウントへ接続し、検索広告のキャンペーン別レポートを取得しました。案件名、アカウントID、キャンペーン名、実績値は伏せますが、主要指標まで取得できています。広告設定の変更は発生していません。
一方、導入は接続先を一行登録するだけでは終わりませんでした。MCP専用OAuthクライアントの発行、Windows上のPython環境、認証情報の保存先、Codex側の権限確認を順に整える必要があります。広告アカウントがMCC配下にある場合は、baseAccountIdとaccountIdの違いも理解しておく必要があります。
レポート生成には数十秒かかることがありました。公式READMEでも、60秒以内に完成しなければエラーを返す仕様が示されています。長期間や多数の項目を一度に指定せず、期間やフィールドを絞るほうが安定します。
なお、導入時に生じた一部の問題はMCPサーバーだけの問題ではありません。Codex CLIのバージョン、Windowsの実行制限、ローカルファイルへの権限も挙動へ影響します。導入前に、MCPクライアントと実行環境を分けて確認したほうが切り分けやすくなります。
MCPと直接APIはどう使い分けるか
処理速度だけを比べるなら、直接APIを呼ぶほうが有利です。MCPでは、AIが依頼を解釈し、利用可能なフィールドを確認してからツールを呼びます。レポート生成そのものの待ち時間に、AIとMCPの処理が加わります。
| 比較項目 | MCP | 直接API |
|---|---|---|
| 単発の調査 | 自然言語で依頼しやすい | クエリやコードの準備が必要 |
| 定期取得 | AIの判断が入り、実行時間を読みづらい | スケジュールと出力形式を固定しやすい |
| 大量処理 | 会話の表示件数と実行時間に制約がある | バッチ処理を設計しやすい |
| 仕様確認 | AIがフィールド情報を確認できる | ドキュメントやスキーマを自分で確認する |
| 保守 | MCPサーバーとクライアントの両方に依存する | 自前コードの保守が必要 |
すでに広告APIからデータ基盤へ定期連携している場合、その処理をMCPへ置き換える利点は大きくありません。APIは定型処理の基盤として残し、MCPはその場で数値を確認したいときや、取得項目を試したいときに使うのが現実的です。
つまり、MCPは広告APIの代替ではありません。広告APIをAIから扱いやすくする参照レイヤーです。この位置づけであれば、v0.0.1の段階でも使いどころがあります。
導入前に確認したいこと
サーバーはローカルホストで動かし、信頼できるMCPクライアントだけを接続します。OAuthクライアントのシークレットやアクセストークンを、プロンプトへ入力する必要はありません。
広告アカウントが複数ある場合は、AIへ対象IDを明示したほうが安全です。曖昧な名称だけで複数アカウントを横断させると、意図しない範囲まで参照する可能性があります。
また、CSVには広告データが含まれます。保存先のアクセス権、削除方法、バックアップ対象を事前に決めてください。参照専用でも、取得したデータの管理責任までMCPサーバーが引き受けるわけではありません。
公式提供、OAuth対応、参照専用という三つの条件は、広告アカウントへAIを接続する出発点として安心感があります。ただし、日次連携を支える基盤としてではなく、対話型の調査窓口として使うほうが、このMCPサーバーの長所を活かせます。
関連記事
この記事をシェア
ryottaman
広告代理店で17年、現在は事業会社でインハウスマーケティングを担当しています。
SIGNALZの記事はAIを活用して作成し、10年以上の運用型広告の実務経験をもとに内容を確認・監修しています。制作方針の詳細はサイトについてをご覧ください。
Google検索の優先ソースにSIGNALZを追加
追加すると、Google検索のトップニュースでSIGNALZの記事が見つけやすくなります。AIモードとAIによる概要でも「優先」バッジが付きます。設定はいつでも解除できます。