Linkedin Ads Mcp

LinkedIn Ads MCP サーバー

Claude AI が LinkedIn Ads のデータにアクセスし、分析できるようにする MCP（Model Context Protocol）サーバーです。キャンペーンの最適化、パフォーマンスレポート、データに基づく広告判断に AI を活用したいマーケター、創業者、グロースチーム向けに構築されています。

ヒント

セットアップせずに使いたいですか？ 同じ作者が提供する AdPlug は、ホスト型の LinkedIn Ads MCP です。OAuth でサインインし（LinkedIn の開発者アプリも、管理が必要な認証情報も不要です）、Claude、ChatGPT、または Cursor を約 2 分で接続できます。同じコネクターから Google Ads と Microsoft Ads も利用できます。読み取りツールは無料で、書き込み操作は実行前にすべてプレビューされます。このオープンソースサーバーも無料で、セルフホスト可能なままです。

クイックインストール（コーディング不要！）

技術的な設定は避けたいですか？ 以下のプロンプトのいずれかをコピーして、Claude に貼り付けるだけです。AI がすべて行います！

オプション 1：Claude Code でインストール（推奨）

Claude Code をインストール済みの場合は、このプロンプト全体をコピーして貼り付けてください。

I want you to install the LinkedIn Ads MCP server so I can analyze my LinkedIn advertising data. Please do the following:

1. FIRST, check if Node.js is installed by running `node --version`. If not installed, tell me to install it from https://nodejs.org first.

2. Clone the repository to my home directory:
   - cd ~
   - git clone https://github.com/danielpopamd/linkedin-ads-mcp.git
   - cd linkedin-ads-mcp

3. Install dependencies and build:
   - npm install
   - npm run build

4. Create the .env file with placeholder values:
   - cp .env.example .env

5. NOW IMPORTANT - Ask me for my LinkedIn API credentials:
   - Ask: "Please provide your LinkedIn Client ID (from https://www.linkedin.com/developers/apps)"
   - Ask: "Please provide your LinkedIn Client Secret"

6. Update the .env file with the credentials I provide.

7. Set up Claude Desktop configuration:
   - Read the current Claude Desktop config file:
     - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
     - Windows: %APPDATA%/Claude/claude_desktop_config.json
   - Add the linkedin-ads MCP server to mcpServers (merge with existing config if any):
     {
       "mcpServers": {
         "linkedin-ads": {
           "command": "node",
           "args": ["<FULL_PATH_TO>/linkedin-ads-mcp/dist/index.js"],
           "env": {
             "LINKEDIN_CLIENT_ID": "<MY_CLIENT_ID>",
             "LINKEDIN_CLIENT_SECRET": "<MY_CLIENT_SECRET>"
           }
         }
       }
     }
   - Replace <FULL_PATH_TO> with the actual path (e.g., /Users/username)
   - Replace the env values with my actual credentials

8. Run the authentication flow:
   - npm run auth
   - This will open my browser - tell me to authorize the app with LinkedIn

9. Tell me to restart Claude Desktop to activate the MCP server.

10. After restart, confirm setup by telling me to ask Claude: "List my LinkedIn ad accounts"

If you don't have my LinkedIn API credentials yet, first explain how to get them:
- Go to https://www.linkedin.com/developers/apps
- Create a new app (need a LinkedIn Company Page)
- Go to Products tab and request "Advertising API" access
- Go to Auth tab and add redirect URL: http://localhost:3000/callback
- Copy the Client ID and Client Secret

Start now!

オプション 2：Claude Desktop でインストール（チャット形式）

Claude Desktop を直接使用している場合（Claude Code を使わない場合）は、セットアップガイドを開始するためにこのプロンプトをコピーしてください。

I want to install the LinkedIn Ads MCP server to analyze my LinkedIn advertising data with Claude. I'm not technical, so please guide me step by step with simple instructions.

Please walk me through:

1. **Check Prerequisites**
   - Do I have Node.js installed? (Tell me how to check and where to download if needed)
   - Do I have a LinkedIn Developer App? (If not, guide me through creating one at https://www.linkedin.com/developers/apps)

2. **Get LinkedIn API Access**
   Walk me through:
   - Creating a LinkedIn Developer App
   - Requesting Advertising API access (Products tab)
   - Adding the redirect URL: http://localhost:3000/callback (Auth tab)
   - Finding my Client ID and Client Secret

3. **Download and Install**
   Give me the exact commands to run in my terminal (one at a time):
   - How to open Terminal (Mac) or Command Prompt (Windows)
   - Clone the repository
   - Install dependencies
   - Build the project

4. **Configure Claude Desktop**
   - Tell me exactly where the config file is located
   - Give me the exact JSON to add (with placeholders for my credentials)
   - Show me how to edit the file

5. **Authenticate with LinkedIn**
   - What command to run
   - What to do when the browser opens

6. **Test the Setup**
   - Tell me to restart Claude Desktop
   - Give me a test question to ask

Please start with step 1 and wait for my response before moving to the next step. Use simple language and assume I've never used a terminal before.

インストール前に必要なもの

いずれかのインストール方法を使用する前に、以下が必要です。

1. Node.js（バージョン 18 以上） - こちらからダウンロード
2. LinkedIn の企業ページ - 開発者アプリの作成に必要です
3. Advertising API にアクセスできる LinkedIn 開発者アプリ - こちらから作成

LinkedIn API の認証情報を取得する（5～10 分）

1. LinkedIn Developer Portal にアクセスします
2. **「Create App」**をクリックします
3. 以下を入力します。
   • App name：「My LinkedIn Ads Analytics」（または任意の名前）
   • LinkedIn Page：自社の企業ページを選択します
   • App logo：任意の正方形の画像をアップロードします
4. 作成後、**「Products」タブに移動して、「Advertising API」**をリクエストします（承認には 1～5 日かかります）
5. **「Auth」**タブに移動して、リダイレクト URL http://localhost:3000/callback を追加します
6. Client ID と Client Secret をコピーします。これらが必要になります。

制作者

Daniel Popa - パフォーマンスマーケティングコンサルタント、AI 自動化スペシャリスト

有料広告、コンバージョン率最適化、データに基づくグロース戦略を通じて、意欲的なスタートアップの収益性の高い成長を支援しています。パフォーマンスマーケティングに 10 年以上携わり、運用した広告予算は 1 億ドルを超えます。現在は、マーケティングの効率とパフォーマンスを高めるための AI ワークフローや自動化の導入に注力しています。

このツールは LinkedIn の広告データと AI による分析の隔たりを埋め、Claude との自然言語での会話を通じて、マーケターが実用的なインサイトを得やすくするために開発されました。

• ウェブサイト：danielpopa.me
• 注力分野：パフォーマンスマーケティング、AI 自動化、グロース戦略

手動インストール（開発者向け）

手動でインストールしたい場合や、より細かく制御したい場合は、以下の手順に従ってください。

できること

この MCP サーバーは、Claude Desktop（または MCP 互換クライアント）を LinkedIn Marketing API に接続し、次のことを可能にします。

• キャンペーンのパフォーマンスを自然言語で照会
• オーディエンスの属性を分析し、広告に反応しているユーザーを把握
• LinkedIn キャンペーン全体のコンバージョンとリードを追跡
• 期間、キャンペーン、キャンペーングループ間のパフォーマンスを比較
• 広告データに関するAI を活用したインサイトを取得

Claude との会話例

"Show me campaign performance for the last 30 days"
"Which job functions are responding best to my ads?"
"Compare this week's performance vs last week"
"What's my cost per lead for the lead gen campaigns?"
"Which creatives have the best CTR?"
"Show me the daily trend for conversions"

機能

• 25 種類の専用ツール — アカウント、キャンペーン、クリエイティブ、オーディエンス、コンバージョン、分析、キャンペーン管理全般（作成、更新、削除）を網羅
• 包括的な指標 — すべてのレポートに、費用、インプレッション、クリック数、CTR、リーチ、フリークエンシー、エンゲージメント数、エンゲージメント率、CPM、CPC、コンバージョン数、コンバージョン率、コンバージョン単価、オーディエンス浸透率、平均滞在時間が含まれます
• OAuth 認証は 1 回だけ — 一度認証すれば、すべての LinkedIn 広告アカウントにアクセスできます
• トークンの自動更新 — トークンは有効期限前に自動更新されます
• レート制限への対応 — API のレート制限に対する指数バックオフ機能を内蔵
• 人が読みやすい名前 — 属性データには、シニアリティ、職種、業種などの実際の名前が表示されます（ID ではありません）

前提条件

1. LinkedIn Developer アプリ

この MCP サーバーを使用する前に、LinkedIn Developer アプリケーションを設定する必要があります。

1. LinkedIn Developer Portal にアクセスします
2. **「Create App」**をクリックします
3. アプリの詳細を入力します。
   • アプリ名：例：「My LinkedIn Ads Analytics」
   • LinkedIn ページ：会社のページを選択します
   • アプリのロゴ：ロゴをアップロードします（必須）
4. Client ID と Client Secret を控えます

2. Advertising API アクセスをリクエスト

1. アプリで **「Products」**タブを開きます
2. **「Advertising API」**を選択します
3. ビジネス上の利用目的を記載して申請フォームを送信します
4. 承認を待ちます（通常 1～5 営業日）

3. OAuth を設定

1. アプリの **「Auth」**タブを開きます
2. 次のリダイレクト URL を追加します：http://localhost:3000/callback
3. 次の OAuth 2.0 スコープが利用可能であることを確認します。
   • r_ads - 広告アカウントの読み取り
   • r_ads_reporting - レポートデータの読み取り
   • rw_ads - キャンペーン、クリエイティブ、広告の作成と管理
   • r_organization_social - 組織の投稿の読み取り（クリエイティブのコンテンツ用）

インストール

# Clone the repository
git clone https://github.com/danielpopamd/linkedin-ads-mcp.git
cd linkedin-ads-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Create your environment file
cp .env.example .env

.env を編集して LinkedIn の認証情報を設定します。

LINKEDIN_CLIENT_ID=your_client_id
LINKEDIN_CLIENT_SECRET=your_client_secret

認証

認証フローを実行して、アクセストークンを取得します。

npm run auth

これにより、次の処理が行われます。

1. LinkedIn の OAuth ページがブラウザーで開きます
2. アプリケーションの認可を求められます
3. トークンがローカルの ~/.linkedin-ads-mcp/tokens.json に保存されます
4. トークンの有効期間は 60 日で、自動更新されます

Claude Desktop の設定

Claude Desktop の設定ファイルに次の内容を追加します。

macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "linkedin-ads": {
      "command": "node",
      "args": ["/full/path/to/linkedin-ads-mcp/dist/index.js"],
      "env": {
        "LINKEDIN_CLIENT_ID": "your_client_id",
        "LINKEDIN_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

重要：/full/path/to/linkedin-ads-mcp を、このリポジトリをクローンした実際のパスに置き換えてください。

設定を更新したら、変更を反映するために Claude Desktop を再起動してください。

利用可能なツール

アカウント管理

キャンペーンとクリエイティブのパフォーマンス

オーディエンスとデモグラフィック

コンバージョンとリード獲得

高度な分析

キャンペーン管理（書き込み操作）

標準指標

すべてのパフォーマンスレポートには、次の指標が含まれます。

API の制限とベストプラクティス

LinkedIn API の制限

• レート制限：5分間あたり最大4,500万の指標値
• レスポンス制限：1レスポンスあたり最大15,000要素
• リクエストあたりの指標数：最大20指標
• デモグラフィックデータの遅延：12～24時間
• リーチデータ：期間は最大92日

ベストプラクティス

1. まずアカウント一覧を取得する - 有効なアカウント ID を取得するため、必ず最初にアカウントを一覧表示します
2. 適切な期間を指定する - 期間が短いほど結果をすばやく取得できます。定期レポートには30日間を使用します
3. キャンペーンを具体的に指定する - 分析対象のキャンペーンがわかっている場合は、キャンペーン ID で絞り込みます
4. 比較を活用する - compare ツールを使って、パフォーマンスの変化をすばやく特定します

プロジェクト構成

linkedin-ads-mcp/
├── src/
│   ├── index.ts              # MCP server entry point
│   ├── auth-cli.ts           # OAuth CLI tool
│   ├── auth/
│   │   ├── oauth.ts          # OAuth 2.0 flow
│   │   └── token-store.ts    # Secure token storage
│   ├── lib/
│   │   ├── linkedin-api.ts   # LinkedIn Marketing API client
│   │   └── types.ts          # TypeScript type definitions
│   └── tools/
│       ├── accounts.ts       # Account management tools
│       ├── performance.ts    # Campaign & creative performance
│       ├── demographics.ts   # Audience demographics tools
│       ├── conversions.ts    # Conversion & lead gen tools
│       ├── analytics.ts      # Advanced analytics tools
│       └── campaign-management.ts  # Campaign CRUD & image upload tools
├── dist/                     # Compiled JavaScript output
├── package.json
├── tsconfig.json
└── .env.example

開発

# Build the project
npm run build

# Run the server (for testing)
npm run dev

# Run authentication flow
npm run auth

トラブルシューティング

「Not authenticated」エラー

npm run auth を実行して、LinkedIn で認証してください。

「Rate limited」レスポンス

サーバーは指数バックオフを使ってレート制限を自動的に処理します。頻繁に制限に達する場合は、リクエストの頻度を下げてください。

トークンの期限切れ

トークンは自動的に更新されます。それでも問題が解決しない場合は、~/.linkedin-ads-mcp/tokens.json を削除してから、npm run auth で再認証してください。

API アクセスが拒否されました

LinkedIn Developer アプリで次の項目が設定されていることを確認してください。

1. 「Advertising API」製品が承認されている
2. 正しい OAuth スコープ（r_ads、r_ads_reporting）が有効になっている
3. ユーザーアカウントが、クエリ対象の広告アカウントにアクセスできる

キャンペーン名が「不明」と表示される

通常は、アナリティクスのキャンペーン ID がアカウント内のどのキャンペーンとも一致していないことを意味します。アーカイブ済みのキャンペーンや、同期の遅延がある場合に発生することがあります。

技術スタック

• Model Context Protocol（MCP） - Claude が外部ツールと連携できるようにするプロトコル
• LinkedIn Marketing API - LinkedIn の広告データ用公式 API
• TypeScript - 型安全な開発
• Node.js - ランタイム環境

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

MIT License - 詳細は LICENSE ファイルをご覧ください。

謝辞

Anthropic の Model Context Protocol SDK を使用して構築されています。

Daniel Popa による AI 活用ワークフローで作成