ADCP Sales Agent MCP Server

MCP 服务器，用于通过 Claude Desktop 或 Cline 访问 ADCP Sales Agent 的 12 个广告工具。

安装

npm install -g adcp-sales-agent-mcp

或使用 npx（无需安装）：

npx adcp-sales-agent-mcp

前置要求: Node.js >= 18.0.0

配置

1. 获取认证令牌

1. 访问 https://sales-agent.zeabur.app
2. 登录账号
3. 进入账户设置或 API 凭据部分
4. 生成或复制认证令牌

2. Claude Desktop 配置

编辑配置文件：

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

添加配置：

{
  "mcpServers": {
    "adcp-sales-agent": {
      "command": "npx",
      "args": ["adcp-sales-agent-mcp"],
      "env": {
        "ADCP_AUTH_TOKEN": "你的认证令牌"
      }
    }
  }
}

3. Cline (VS Code) 配置

编辑文件：C:\Users\你的用户名\AppData\Roaming\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

{
  "mcpServers": {
    "adcp-sales-agent": {
      "command": "npx",
      "args": ["adcp-sales-agent-mcp"],
      "env": {
        "ADCP_AUTH_TOKEN": "你的认证令牌"
      }
    }
  }
}

重新加载 VS Code 窗口：Ctrl+Shift+P → "Developer: Reload Window"

可用工具（12 个）

工作流管理

• list_tasks - 列出所有任务
• get_task - 获取特定任务详情
• complete_task - 标记任务为已完成

产品与创意

• get_products - 搜索广告产品
• list_creative_formats - 列出可用的创意格式
• sync_creatives - 同步创意资源
• list_creatives - 列出创意库存

媒体购买

• list_authorized_properties - 列出授权的发布商域名
• create_media_buy - 创建新的媒体购买活动
• update_media_buy - 更新现有媒体购买
• get_media_buy_delivery - 获取投放指标
• update_performance_index - 更新性能数据

使用示例

配置完成后，在 Claude Desktop 或 Cline 中直接对话：

列出所有可用的创意格式

搜索"咖啡"相关的广告产品

列出我的所有任务

环境变量

| 变量 | 必需 | 说明 | |------|------|------| | ADCP_AUTH_TOKEN | 是 | ADCP 认证令牌 | | ADCP_BACKEND_URL | 否 | 后端 URL（默认：https://sales-agent.zeabur.app/mcp） |

故障排除

错误：ADCP_AUTH_TOKEN environment variable is required

解决: 确保在配置文件中正确设置了 ADCP_AUTH_TOKEN

错误：Connection closed

解决:

1. 检查认证令牌是否有效
2. 检查网络连接
3. 重启 Claude Desktop 或 VS Code

查看日志

• Claude Desktop: ~/Library/Application Support/Claude/logs/ (macOS)
• Windows: %APPDATA%\Claude\logs\
• Cline: VS Code 输出面板 → 选择 "Cline"

许可证

MIT License - 详见 LICENSE 文件

技术支持

• 检查故障排除部分
• 查看工具文档
• 联系 ADCP 管理员获取访问权限