MCP 経由で LinkedIn Ads を Gemini に接続する方法

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

LinkedIn Ads + Gemini

Marketing API を通じて LinkedIn Campaign Manager を読み取ります。広告アカウント、キャンペーングループ、キャンペーン、クリエイティブに加え、キャンペーン、クリエイティブ、日別、または会社、職務、職位などのメンバー属性ごとの広告分析（インプレッション、クリック、費用、コンバージョン、リード）を確認できます。

前提条件

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

LINKEDIN_ADS_CLIENT_ID, LINKEDIN_ADS_CLIENT_SECRET

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

1. https://www.linkedin.com/developers/apps でアプリを作成します。LinkedIn では、アプリを LinkedIn Page に関連付ける必要があります。
2. アプリで Advertising API プロダクトを申請し、LinkedIn の承認を待ちます。自社の広告アカウントだけなら Development ティアで十分です。
3. アプリの Auth タブで、Authorized redirect URLs にリダイレクト URI https://cloud.anythingmcp.com/api/mcp-oauth/callback を追加します（AnythingMCP をセルフホストしている場合は <your AnythingMCP URL>/api/mcp-oauth/callback）。
4. 同じタブの Client ID と Primary Client Secret を LINKEDIN_ADS_CLIENT_ID と LINKEDIN_ADS_CLIENT_SECRET にコピーします。LINKEDIN_ADS_REFRESH_TOKEN は空のままにしてください。サインイン時に自動で入力されます。
5. コネクターをインストールし、Authorize with Provider をクリックして、広告アカウントにロールを持つ LinkedIn メンバーでサインインします。コネクターが要求するスコープは r_ads（アカウント、キャンペーン、クリエイティブ）と r_ads_reporting（分析）です。
6. linkedin_ads_list_my_ad_accounts を実行します。メンバーが使える広告アカウントが、各アカウントでのロールとともに urn:li:sponsoredAccount:507404993 のような URN で表示されます。ほかのツールには番号だけを渡します。

読み取り専用です: AI は広告アカウント、キャンペーングループ、予算、入札額、スケジュール、ターゲティングを含むキャンペーン、審査結果と配信されない理由を含むクリエイティブを読み取ります。作成、変更、一時停止、開始は一切できません。

分析: アカウント全体または 1 つのキャンペーンについて、任意の期間のインプレッション、クリック、費用、コンバージョン、リードを、合計または日別で、キャンペーン、キャンペーングループ、クリエイティブ、または会社、職務、職位などのメンバー属性ごとに確認できます。費用はアカウント通貨または USD で表示されます。パフォーマンスデータはほぼリアルタイムで、10 年間保存されます。メンバー属性の数値は概算で、12 から 24 時間遅れて反映され、保存期間は 2 年です。表示されるのはクリエイティブごと 1 日あたり上位 100 件の値だけで、イベント数が 3 未満の値は除外されます。テストアカウントには分析データがありません。空の応答はエラーではなく、活動がないかアクセス権がないことを意味します。

トークン: アクセストークンの有効期間は 60 日です。Advertising API が承認されたアプリには有効期間 1 年のリフレッシュトークンも発行され、コネクターはこれを使ってアクセスを自動的に更新します。期限が切れたら、もう一度 Authorize with Provider をクリックしてください。

制限: LinkedIn はアプリとメンバーごとに 1 日単位で、分析についてはデータ量でもリクエストを制限します。429 が返ったら、しばらく待ってから再試行してください。1 回の分析の応答は最大 15,000 行です。

よくあるエラー: 401: もう一度認可してください。403 USER_NOT_AUTHORIZED または ACCESS_DENIED: メンバーがそのアカウントにロールを持っていないか、アプリに Advertising API プロダクトまたは r_ads_reporting スコープがありません。426 またはバージョンエラー: コネクターが送る API バージョンを LinkedIn がサポートしなくなっています。カタログからコネクターを更新してください。

このコネクターは Campaign Manager で何も作成、変更しません。新しいキャンペーンやクリエイティブの作成も、予算、入札額、ターゲティング、ステータスの変更も行いません。

ステップ 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 が LinkedIn Ads のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「先月 LinkedIn Ads にいくら使いましたか。キャンペーンごとのリード単価も教えてください。」
• 「過去 30 日間で、どの職務と職位の人が広告を最も多くクリックしましたか。」
• 「最大のキャンペーンについて、過去 2 週間の日別のインプレッション、クリック、費用を見せてください。」
• 「今配信されていないクリエイティブはどれですか。その理由も教えてください。」

FAQ

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

次のステップ

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