Claude CodeとMCPで広告APIを繋ぐ実装手順

広告レポートの集計や残予算の計算を、毎朝手作業でこなしていないだろうか。Google広告やMeta広告のAPIをClaude Codeから直接叩ければ、この定型作業は数十秒で終わる。鍵になるのがMCP（Model Context Protocol・AIツールと外部APIをつなぐ共通規格）だ。この記事では、PythonでMCPサーバーを自作し、Claude Codeに広告APIをつなぐまでの手順を、実際に詰まった点つきでまとめる。読み終えれば、今日から自分の運用環境に組み込める。

なぜ広告運用にMCPが必要なのか

MCPはAnthropicが2024年末に公開した開かれた規格だ。AIツールが外部APIを使うための共通の口を定める。これまではツールごとに個別の連携を作る必要があった。MCPなら一度サーバーを用意すれば、Claude CodeでもChatGPTでも同じデータに届く。2026年時点で公式レジストリには8,000を超えるMCPサーバーが登録済みだ。広告分野はまだ法人メディアの実装記事が薄く、先行者の窓が開いている。

広告運用と相性が良い理由は3つある。1つ目は、GAQLやInsightsの複雑なクエリをAIに任せられる点。2つ目は、残予算や消化ペースの計算を自然言語で頼める点。3つ目は、複数媒体の数字を1つの窓口で横断できる点だ。手元のGoogle広告APIの叩き方はGoogle広告APIをPythonで動かす手順にまとめている。MCP化の前にAPI単体で動かしておくと理解が早い。

Pythonで最小構成のMCPサーバーを作る

実装は驚くほど短い。Python公式のMCP SDKを使えば、3ステップで動く。まず環境を用意し、次にツールを1つ定義し、最後にClaude Codeへ登録するだけだ。以下の手順はブックマークして、自分のAPIキーとエンドポイントに書き換えて使ってほしい。詳しい仕様はMCP公式サイト（https://modelcontextprotocol.io）で確認できる。

（1）SDKを入れる: pip install "mcp[cli]" を実行する。（2）サーバー本体を書く: FastMCPを読み込み、関数の上に @mcp.tool() デコレータを付けるだけで、その関数がAIから呼べるツールになる。残予算を返す関数なら、Meta Insightsを叩いて当月消化を取得し、月予算との差を返す形にする。（3）登録する: claude mcp add コマンドでサーバーのパスを渡す。これでClaude Codeの起動時に自動で読み込まれる。

ツール定義には型ヒントとdocstringを必ず書く。AIはこの説明文を読んで、いつどの引数でツールを呼ぶかを判断する。説明が曖昧だと呼び出しの精度が落ちる。ここは手を抜かない方がよい。

実際に詰まった罠: stdioでのprintが通信を壊す

最初に組んだとき、サーバーがClaude Codeから見えず数時間溶かした。原因はデバッグ用の print() だった。MCPの既定はstdio方式で、標準出力そのものをAIとの通信路に使う。そこへprintで文字を流すと、JSONの通信が壊れて接続が落ちる。エラーは「サーバーが応答しない」としか出ず、原因が見えにくい。

解決は単純だ。ログは標準エラー出力へ出す。Pythonなら print("msg", file=sys.stderr) か、loggingモジュールでstderrハンドラを使う。標準出力には一切書かないと決めておくと安全だ。この1点さえ守れば、あとの実装は素直に進む。API単体では見えず、MCP化して初めて出る罠なので、覚えておく価値がある。

広告運用での使いどころと書き込みの注意

読み取り系は積極的に任せてよい。残予算の計算、消化ペースの異常検知、媒体横断のレポート集計は、MCP経由でClaude Codeに聞くのが速い。毎朝の日予算チェックを自動化する流れは広告の日予算を自動計算するPython実装と組み合わせると効く。この連携の完全版はnoteの実践ガイドにまとめている。

一方で、予算変更や入札の書き込みをAIに直接握らせるのは慎重にすべきだ。誤った桁で日予算を更新すれば、広告費が一気に溶ける。書き込み系のツールは、まず一時停止やvalidateモードで作り、実値を読み返してから有効化する二段構えにする。AIの判断を最終確定にせず、人が数字を確認する関門を1つ残しておく。

本記事で紹介した実装を、資料化やAIツールの比較検討まで広げるなら、以下のツールも使える:

AIスライド作成ツール「イルシル」を試してみる

まとめ

MCPは広告運用者にとって、APIとAIの間をつなぐ最短の配管だ。SDKで3ステップ、詰まる点はstdioのprintだけ。まずは残予算を返す読み取りツールを1本作り、Claude Codeから呼べる状態を今日中に用意してみてほしい。書き込みは人の確認を挟む。この順で広げれば、安全に効率化できる。

実務でそのまま使いたい人へ

本記事の手法の完全版（実際のコード・テンプレート・つまずき対処つき）は、運営者のnote（note.com/ryo_ai_hack）で公開している。実データに基づく実践ガイドをまとめて読める。

DMM 生成AI CAMP

コメント

コメントを投稿

このブログの人気の投稿

Claude Skills販売で月5万稼ぐ3ステップ実践

イメージ
2026年、Anthropicが公開した「Claude Skills」が新たな副業の入口として注目を集めている。SKILL.mdというMarkdown形式の手順書を1枚書くだけで、誰でも自分の業務ノウハウをAIワークフローとして販売できる仕組みだ。海外では非エンジニアが50日で5,000ドルを売り上げた事例も登場し、日本でも参入の動きが加速している。今回は「Claude Skills 販売 副業」を軸に、月5万円を狙うための3ステップを具体的に解説する。コードは一切不要、初期費用もほぼゼロで始められる。 Claude Skillsとは何か:販売できる理由 Claude Skillsは、Claude Codeが特定タスクを実行する際に読み込む「再利用可能な指示書」である。実体はSKILL.mdというテキストファイル1枚で、業務手順を自然言語で記述するだけで動く。プログラミング言語は必要なく、日本語で「請求書を読み取り仕訳を生成する」「議事録から議題別サマリを作る」といった手順を構造化して書けば成立する。 販売できる理由は3つある。第一に、Anthropicの審査やマーケットプレイス登録が不要で、自分のサイトやGumroad経由で即販売できる。第二に、業務知識そのものが資産になるため、士業・人事・経理など専門職の暗黙知が高値で売れる。第三に、購入者はファイルをClaude Codeに置くだけで使えるため、サポート負荷が極めて低い。海外メディアagent37の報告では、税務処理を自動化するSkillが1本79ドルで継続的に売れている。 月5万円のリアルな単価設計 1本2,980円のSkillを月17本売れば達成できる。1本9,800円なら月5本で到達する。高単価帯は専門業務向け、低単価帯は汎用ツール系という棲み分けが定石となっている。 ステップ1:売れるSkillテーマを30分で決める 最初の関門はテーマ選定である。売れるSkillには共通点が3つある。「毎週繰り返す業務」「結果物がテキストかコード」「担当者の判断が定型化できる」の3点だ。この条件を満たす自分の業務を15個書き出し、上位3つに絞り込む作業を30分で行う。 具体例を挙げる。広告運用者なら「日次レポートのSlack要約Skill」、人事なら「面接フィードバック整形Skill」、ライターなら「SEO見出し構成生...
続きを読む

Claude CodeでExcel自動化副業を月5万にする手順

イメージ
Claude Codeを副業に使いたいが、何から手をつければ収入につながるのか見えにくい。本記事は、需要が安定しているExcel自動化案件に的を絞り、3週間で初案件を獲得し月5万円までスケールさせる具体的な手順をまとめる。コーディング未経験でも、手順どおりに進めれば動くものを納品できる構成にした。 なぜExcel自動化が初心者の最短ルートなのか クラウドソーシングで需要が枯れない領域がExcel関連だ。ランサーズやクラウドワークスでは「VBAでの集計自動化」「データ整形」「請求書生成」が常時数百件単位で募集されている。単価は1案件3,000〜30,000円で、納期も短い案件が多い。 従来は VBAの知識 が壁だった。だがClaude Codeは自然言語の指示からVBAコードを生成し、ターミナル上で実行・修正まで完結する。リベシティの解説によれば、Excel自動化はClaude Code副業16ジャンルの中で初心者が最も入りやすい分野とされている。 参考: リベシティのClaude Code活用例まとめ 準備するもの（初期費用は月3,000円のみ） Claude Pro契約: 月額20ドル（約3,000円） Node.js: 公式サイトから無料でインストール Microsoft Excel: すでに持っているはず クラウドソーシングのアカウント: ランサーズかクラウドワークス 初期投資はClaude Proの月3,000円のみ。1案件取れれば即回収できる水準だ。インストール手順は Uravationの2026年最新ガイド に図解で載っている。 3週間ロードマップ：初案件獲得まで 1週目：Claude Codeで動くものを3つ作る 最初の壁は「指示の出し方」だ。いきなり案件に応募せず、まず手元のExcelで3つの小さな自動化を作る。例として「フォルダ内のCSVを1つに統合」「請求書テンプレへの差し込み」「重複行の検出」が定番だ。各15〜30分で完成する。 この段階で重要なのは、生成されたVBAを 必ず自分で1行ずつ読む こと。読めなくても動作の意図は把握する。後工程のエラー対応で効いてくる。 2週目：ポートフォリオを2本作る 応募時に提示する成果物を準備する。「営業日報の月次集計を5秒で完了するマクロ」「100枚の請求書PDFを一括生成するツール」のように、効果を秒数や...
続きを読む

Difyの使い方｜初心者でも10分で作れるAIアプリ入門

イメージ
「AIを使ったアプリを作りたい。でもプログラミングの知識がない」——そんな悩みを持つ人が急増している。2026年現在、ノーコードでAIアプリを開発できるツールは複数ある。中でも注目度が高いのがDify（ディフィ）だ。オープンソースで公開されており、無料プランでもチャットボットや文章生成ツールを作成できる。 Difyをまったく触ったことがない初心者でも大丈夫。この記事では、アカウント登録からAIアプリ完成までの全手順を解説する。最短10分で、自分だけのAIチャットボットが動き出す。 Difyとは？ノーコードで使えるAI開発プラットフォーム Difyは、大規模言語モデル（LLM）を活用したAIアプリをノーコードで開発できるプラットフォームだ。オープンソースとして公開されている。2026年4月時点でダウンロード数は500万を超えた（ Dify公式サイト ）。 主な特徴は以下の3つ。 マルチモデル対応 ：OpenAIのGPT、AnthropicのClaude、GoogleのGeminiなど数百種類のAIモデルを切り替えて使える ノーコードUI ：処理ブロックをつなげるだけで、チャットボットやワークフローを構築できる RAG（検索拡張生成） ：自社ドキュメントやFAQをアップロードし、その情報をもとに回答するAIを作れる プログラミング経験がゼロでも、ブラウザ上で直感的に操作できる。これがDify最大の強みだ。 Difyの始め方｜アカウント登録から初期設定まで3ステップ Difyを使い始めるまでの手順はシンプルだ。3ステップで完了する。 ステップ1：アカウントを作成する Difyクラウド版（ cloud.dify.ai ）にアクセスする。「始める」ボタンをクリックしよう。Googleアカウント、GitHubアカウント、メールアドレスのいずれかで登録できる。所要時間は1分程度だ。 ステップ2：AIモデルのAPIキーを設定する ログイン後、画面右上のアカウントアイコンから「設定」に進む。「モデルプロバイダー」を開き、使いたいAIサービスを選ぼう。事前に取得したAPIキーを入力して保存すれば完了だ。 まだAPIキーがない場合はOpenAI公式サイト（ platform.openai.com ）で取得できる。無料クレジットが付くため、初期費用はか...
続きを読む