Adgentek Ad Server (AdsMCP)

AdsMCP

AI アプリケーション向けの広告マネタイズ MCP サーバーです。

AdsMCP は Adgentek がホストする Model Context Protocol サーバーです。会話のコンテキスト、ユーザーの意図、広告掲載機会に基づいて、AI エージェントや対話型インターフェースがコンテキストに合った広告を自動的に配信できるようにします。

広告サーバー一式を基盤に構築されています。Adgentek のライブ広告需要を利用することも、独自の直販キャンペーンを持ち込むことも、両方を組み合わせることもできます。広告テクノロジーの専門知識は不要です。

始める前に

広告を配信するには、Adgentek のパブリッシャーアカウント、API キー、および有効な AI Surface が少なくとも 1 つ必要です。

パブリッシャーアカウントを作成 →

セットアップチェックリスト

1. app.adgentek.ai/publishers/auth でアカウントを作成します
2. AI Surface を作成します — パブリッシャーダッシュボードで Inventory → Surfaces に移動し、少なくとも 1 つの Surface（例：conversational、search、voice）を追加します。Surface は広告を表示できる場所を定義し、最低 eCPM を設定します。
3. API キーを生成します — パブリッシャーダッシュボードで Settings → API Keys に移動し、キー（adgt_ で始まるもの）を作成します。このキーによってすべての MCP リクエストが認証されます。

Surface が少なくとも 1 つ有効になると、アカウントは有効とみなされます。

接続

{
  "mcpServers": {
    "adgentek-ads": {
      "url": "https://mcp.adgentek.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

必要な設定はこれだけです。MCP 対応クライアントはすべて、この URL とヘッダーのパターンをサポートしています。ローカルパッケージや環境変数は不要です。

プラットフォーム別の設定

接続設定はすべてのプラットフォームで同じです。異なるのはファイルの場所とラッパーキーだけです。

// ~/Library/Application Support/Claude/claude_desktop_config.json  (macOS)
// %APPDATA%\Claude\claude_desktop_config.json  (Windows)
{
  "mcpServers": {
    "adgentek-ads": {
      "url": "https://mcp.adgentek.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

// ~/.claude/settings.json
{
  "mcpServers": {
    "adgentek-ads": {
      "url": "https://mcp.adgentek.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

// .cursor/mcp.json
{
  "mcpServers": {
    "adgentek-ads": {
      "url": "https://mcp.adgentek.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

// .vscode/mcp.json
{
  "servers": {
    "adgentek-ads": {
      "url": "https://mcp.adgentek.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

{
  "mcpServers": {
    "adgentek-ads": {
      "url": "https://mcp.adgentek.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

利用可能なツール

ads.serve

現在の会話に基づいて、コンテキストに合った広告を配信します。指定されたコンテキストで利用可能な、収益性が最も高い広告を返します。一致する広告がない場合は null を返します。

必須パラメーター： conversationId、userKey、surface

任意パラメーター： messages、intent、sentiment、depth、language、geo、preferHtml、extras

const result = await callTool('ads.serve', {
  conversationId: 'conv_abc123',
  userKey:        'user_456',
  surface:        'conversational',
  messages: [
    { role: "user",      content: "What CRM works best for a small sales team?" },
    { role: "assistant", content: "For small teams, a few options stand out..." },
    { role: "user",      content: "Which ones integrate with Google Workspace?" }
  ],
  intent:    'research',
  sentiment: 65,
  depth:     3,
  language:  'en',
  geo:       'US'
});

if (result.ad) {
  displayAd(result.ad.render.markdown);
  // Impressions: embed ad.impression_url as a 1x1 pixel in the browser
  // Clicks: use ad.click_url as the CTA link href
}

Surface の種類： conversational、search、voice、creative、web

意図の値： purchase、research、support、informational

ads.prefetch

1 回の呼び出しで、最大 10 件の広告コンテキストを一括リクエストします。バッチ内の各項目には、ads.serve と同じパラメーターを使用します。

必須： batch（配列、最大 10 項目 — 各項目に conversationId、userKey、surface が必要）

const results = await callTool('ads.prefetch', {
  batch: [
    { conversationId: 'conv_1', userKey: 'user_456', surface: 'conversational', messages: [...] },
    { conversationId: 'conv_2', userKey: 'user_456', surface: 'search',         messages: [...] }
  ]
});

// results.ads            — array of ad objects (null where no ad matched)
// results.prefetched_count — number of ads returned
// results.truncated       — true if your batch exceeded the 10-item limit

広告レスポンス形式

ads.serve が一致する広告を返した場合：

{
  "ad": {
    "id": "ad_abc123",
    "title": "Product Title",
    "content": "Description text",
    "cta": "Learn More",
    "click_url": "https://api.adgentek.ai/.../click?...",
    "impression_url": "https://api.adgentek.ai/.../pixel.gif?...",
    "render": {
      "markdown": "## Title\n\nContent\n\n[CTA](click_url)",
      "plain": "Title - Content - CTA",
      "html": "<div>...</div>"
    }
  },
  "targeting_scores": { ... }
}

一致する広告がない場合：

{
  "ad": null,
  "reason": "no_eligible_ads",
  "targeting_scores": { ... }
}

トラッキング

インプレッションとクリックのトラッキングには、各広告レスポンスに含まれる URL を使用します。これらの URL は、ブラウザー、アプリ内 WebView、埋め込み UI など、あらゆる表示環境で機能します。

• インプレッション：広告の表示時に ad.impression_url を 1×1 ピクセルの画像として読み込みます
• クリック：CTA リンクの href に ad.click_url を使用します（広告主の遷移先への署名付きリダイレクト）

<img src="{ad.impression_url}" width="1" height="1" style="display:none" alt="" />


<a href="{ad.click_url}" target="_blank" rel="noopener noreferrer">{ad.cta}</a>

これらの URL を変更したり、迂回したりしないでください。署名付きで、有効期間が限られています。

MCP リソース

このサーバーは、読み取り専用のドキュメントを MCP リソースとして公開します。

フルアドサーバー — 独自の広告を持ち込む

AdsMCPは、MCPインターフェースを後付けしたデマンドソースではありません。フル機能のアドサーバーです。

パブリッシャーは次のことができます。

• Adgentekのライブデマンドを利用する — プログラマティック、パフォーマンス、直接取引の各デマンドチャネルで確立した関係を持ち、継続的に拡大しています
• 独自のキャンペーンを持ち込む — 直接販売した広告主との取引をアップロードし、同じads.serve呼び出しを通じて配信します
• 追加の広告ソースを組み込む — Adgentekのソースに加えて独自のデマンドパートナーを接続し、すべてのソースを対象に自動で収益を最適化します

あなたの広告枠。あなたのデマンド関係。統合された一つのサーバー。

プライバシーアーキテクチャ

ユーザーとの会話は非公開です。会話の生コンテンツが広告主、デマンドパートナー、または第三者と共有されることはありません。

AdsMCPが広告主に送信するのは、関連性の高い広告を選ぶのに必要な最小限の情報である、派生シグナルのみです。

運用開始

1. **パブリッシャーアカウントを作成**し、APIキーを生成します
2. パブリッシャーダッシュボード（Inventory → Surfaces）で、少なくとも1つのAI Surfaceを作成します
3. 上記の接続スニペットを使って、AIアプリにMCP設定を追加します
4. [email protected]に連絡して、連携を確認し、ライブデマンドを有効にします

Adgentekについて

AdsMCPはAdgentekによって開発・運営されています。

Adgentekは、AIアプリが根本的に異なる種類のパブリッシャーであり、そのために作られた広告インフラを利用するべきであって、ディスプレイ広告向けのウェブから後付けで転用されたものを使うべきではないと考えています。会話型インターフェースには、より豊かなインテントシグナル、より長いエンゲージメントセッションがあり、従来のアドテクの構築方法を形作った従来型の制約もありません。

Adgentekは、この環境にネイティブな広告収益化レイヤーを構築しています。コンテキストを認識し、プライバシーに配慮し、MCPネイティブで、個人開発者が手掛ける単一のGPTから、複数のサーフェスを持つ会話型プラットフォームまで、あらゆる規模のAIアプリに広告を配信できるよう設計されています。デマンドに関する当社の関係は、プログラマティック、直接取引、パフォーマンスの各チャネルにわたり、パブリッシャーは当社のソースに加えて独自の広告ソースを組み込むこともできます。

AIアプリを開発していて、広告インフラを構築せずに広告収益を得たいなら、AdsMCPが求めているものです。

[email protected] — adgentek.ai