Adgentek Ad Server (AdsMCP)

AdsMCP

面向 AI 应用的广告变现 MCP 服务。

AdsMCP 是 Adgentek 托管的 Model Context Protocol 服务，可让 AI Agent 和对话界面根据对话上下文、用户意图和广告位机会，自动投放相关广告。

基于完整的广告服务端堆栈构建。可使用 Adgentek 的实时需求、自有直销广告系列，或两者兼用。无需广告技术专业知识。

开始之前

您需要拥有 Adgentek 发布商账户、API 密钥，以及至少一个已启用的 AI Surface，才能投放广告。

创建发布商账户 →

设置清单

1. 创建账户，访问 app.adgentek.ai/publishers/auth
2. 创建 AI Surface — 在发布商控制面板中，前往 Inventory → Surfaces 并添加至少一个 Surface（例如 conversational、search、voice）。Surface 定义广告的展示位置，并设置您的底价 eCPM。
3. 生成 API 密钥 — 在发布商控制面板中，前往 Settings → API Keys 并创建密钥（前缀为 adgt_）。此密钥用于验证所有 MCP 请求。

至少启用一个 Surface 后，您的账户即视为已激活。

连接

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

这就是所需的全部配置。所有兼容 MCP 的客户端都支持此 URL + Headers 模式，无需本地软件包或环境变量。

平台专属配置

所有平台的连接配置都相同，只有文件位置和封装键有所不同。

// ~/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

在一次调用中批量请求最多 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 像素图片
• 点击：将 ad.click_url 用作 CTA 链接 href（签名重定向至广告主目标页面）

<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. 在发布者控制面板中至少创建一个 AI Surface（Inventory → Surfaces）
3. 使用上方的连接代码片段，将 MCP 配置添加到你的 AI 应用
4. 联系 [email protected]，以验证集成并启用实时需求

关于 Adgentek

AdsMCP 由 Adgentek 构建并运营。

Adgentek 的创立源于这样一个事实：AI 应用是一种截然不同的发布者，值得拥有专为其打造的广告基础设施，而不是从展示广告网络改造而来的基础设施。对话式界面拥有更丰富的意图信号、更长的互动会话，也不受塑造传统广告技术的历史限制。

Adgentek 构建了原生适配这一环境的广告变现层：具备上下文感知能力、保护隐私、原生支持 MCP，并且旨在服务各种规模的 AI 应用 — 从单人开发者打造的 GPT，到拥有多个界面的对话平台。我们的需求合作关系覆盖程序化、直销和效果渠道，发布者还可以在我们的来源之外接入自己的广告来源。

如果你正在构建 AI 应用，希望获得广告收入，又不想构建广告基础设施，那么 AdsMCP 正是你所需要的。

[email protected] — adgentek.ai