AdsCove
文档目录

开始使用

知识库

参考资料

支持的平台

对话与智能体（MCP）

自动化与桥接

在 Windsurf 中使用 AdsCove

AdsCove 产品与工程团队 · 最后审核于 2026 年 8 月 5 日

已支持 · MCP

Windsurf 的 Cascade 智能体可通过标准 MCP 配置连接。请注意 Windsurf 使用 serverUrl 字段。

连接信息

连接所需的信息都在这里，你可以把任意一行复制到客户端或交给智能体：

MCP 端点：      https://adscove.com/api/mcp
传输方式：       Streamable HTTP
推荐授权：       OAuth 2.1（无需密钥）
备用授权：       HTTP 请求头 Authorization: Bearer sk_live_your_key（仅在 OAuth 不可用时）
REST 备用方式： POST https://adscove.com/api/v1/tools/{tool_name}，使用相同的 Bearer 请求头
完整工具目录：   https://adscove.com/api/mcp?tools=full（可选；默认端点更快，并包含 run_adscove_tool）
验证工具：       list_connections（免费、只读）

安装步骤

  1. 生成 API 密钥
  2. 编辑 ~/.codeium/windsurf/mcp_config.json，并加入下方配置
  3. 重启 Windsurf
{
  "mcpServers": {
    "adscove": {
      "serverUrl": "https://adscove.com/api/mcp",
      "headers": { "Authorization": "Bearer sk_live_your_key" }
    }
  }
}

或者：直接交给 AI 智能体

不想自己配置？把下面这段内容粘贴给正在使用的 AI 智能体（Claude、Cursor 或其他 MCP 智能体等），其中已经包含完成连接所需的全部信息。请将 sk_live_MY_KEY 替换为你生成的备用密钥。

请在 Windsurf 的 MCP 配置中添加名为 adscove 的远程服务器，serverUrl 为 https://adscove.com/api/mcp，并加入 Authorization: Bearer sk_live_MY_KEY 请求头。重启后调用 list_connections。

验证连接

在 Cascade 中说：“检查我的平台连接状态。”

Windsurf MCP 配置常见问题排查

Windsurf 的 MCP 配置文件在哪里？

Windsurf 从 ~/.codeium/windsurf/mcp_config.json 读取 MCP 服务器。可以直接编辑该文件，也可以在 Cascade 的 MCP 设置中打开；不同版本的菜单名称可能不同。

字段应该用 url 还是 serverUrl？

在 Windsurf 中请按上方配置使用 serverUrl。从 Cursor 等客户端复制、使用 url 字段的配置在 Windsurf 中可能无法连接。

Windsurf 一直卡在连接服务器，怎么解决？

检查 mcp_config.json 是否为有效 JSON（没有多余逗号），serverUrl 是否正好是 https://adscove.com/api/mcp，Authorization 请求头在 Bearer 后是否是完整密钥。保存后在 Cascade 中刷新 MCP 服务器或重启 Windsurf，并确认网络或代理允许访问 adscove.com。

如何确认 AdsCove MCP 服务器在 Windsurf 中可用？

在 Cascade 中让它检查平台连接状态。它会调用免费、只读的 list_connections，并列出你已连接的平台。

把 API 密钥放在 mcp_config.json 里安全吗？

该文件以明文保存在你的电脑上，请不要提交到代码仓库或分享给他人。如果密钥泄露，请在 AdsCove“密钥”页面撤销并重新生成。

Cascade 能通过 AdsCove 修改我的广告吗？

读取会直接执行；预算、状态等写入操作会先返回待审批动作，由你批准或拒绝，不会静默发布。

连接后可以做什么

查看业务报告、用真实 Shopify 订单核对平台 ROAS、创建暂停状态的广告草稿、提交预算变更；直接写入需要你的确认，另行启用的安全规则只能按设定自动暂停。可以试着问：“最近 7 天哪些广告在亏钱？”

开始使用