你在 Meta 和 Google 各投了预算,周一最想知道的不是“AI 能连几家平台”,而是哪些活动花了多少钱、转化变化有多大,以及哪些数字可以放在一起比较。MCP 能简化取数和复盘,但不会替你统一指标口径。第一版不妨只读:选一个你有权限的广告账户,跑通一份报告,再扩展到其他平台。
MCP 和 API 各管什么?

原创架构图:客户端权限和平台授权可分开管理。只传汇总报表,不传患者个人记录。
广告平台的 API 决定能查哪些报表、有哪些字段,以及哪些操作需要授权。MCP(模型上下文协议)则规定 AI 客户端如何发现和调用工具。常见链路是:客户端 → MCP 服务 → 平台 API → 结构化结果。API 是数据和权限的来源;MCP 把这些能力以工具的形式交给模型,不会新增平台没有开放的字段,也不会让没有权限的账号获得访问权。
原生连接器由客户端直接提供或集成,开通和日常使用通常更方便,但不一定包含广告报表,更不保证支持你所用的账户类型。第三方适配器或自建 MCP 服务可以按需求限定平台、字段、账户和日期,有时还可以统一输出格式;代价是你要核查数据流向、存储策略、访问日志和维护责任。选型时,先验证它是否能返回指定广告账户的花费,而不是只看它是否能连接某个社交平台。
OAuth:登录不是授权的全部
OAuth 让用户在授权方的页面同意把限定的访问权交给应用。要分别确认三件事:MCP 客户端能否访问连接器;连接器是否取得平台要求的报表权限;实际登录的人是否有目标广告账户的查看权。前两项可能使用不同的令牌;客户端连接成功,不代表平台报表已经授权。授权后先拉取媒体账户清单,核对账户 ID 和币种,再拉一小段日期。遇到 401 或 403,应检查令牌、授权范围和账户角色,不要为了消除报错直接申请管理员权限。
只读应由服务端落实,而不是靠提示词:尽量使用报表权限,限定允许查询的账户,不向模型提供修改预算、发布素材、启停活动或上传受众的工具。令牌应留在服务端安全存储,不贴到聊天、截图或代码仓库。接入停用时,撤销授权并确认不再取数。想了解协议层和平台层的区别,可参考 MCP 授权规范。
报表可读,不等于数据可直接相加
先为每个平台保留账户、日期、时区、币种、花费、转化定义和归因窗口。周报最好比较两个完整周期;最近几天可能还有迟到转化,应标记为暂定。不同平台可能同时把同一次预约归到自己的广告上,不能把平台转化相加当作独立患者数。平台报表适合做渠道内诊断;跨渠道净结果应以获准使用、完成去重的 CRM 或预约系统汇总为准。不要混加不同币种;如换算,应说明汇率日期与来源。花费有效但转化为零时,CPA 应显示“不可计算”,而不是 0。
医疗场景尤其要清楚“线索、确认预约、到诊”是三个不同结果。只向模型提供足以决策的汇总数字,例如按周、渠道汇总的线索和到诊数。不要向 MCP 发送姓名、电话、病历、诊断、预约备注或患者级标识;细分样本过小就合并或隐藏。营销报告应支持发现流程问题,不应用来反推个人接受了哪项医疗服务。
用文末附录完成首次验收
先按附录核对平台、连接器和权限,用测试账户或低影响的只读账户执行示例。把账户 ID、日期区间、币种和转化口径换成你的实际值,不要把令牌填进对话。要求输出一行一个账户或活动,注明数据刷新时间、归因窗口,以及缺失字段。然后用广告后台的相同条件复查一段完整日期。出现差异时,先校对过滤条件、时区和归因口径,再判断数据是否确实有误。
首轮验收以三件事为准:数据来源可追溯、报表能对账、模型改不了广告。通过后再逐个平台接入。这样做虽没有“一键全自动”听起来快,却能避免把权限问题误判成零转化,也能确保团队在改变预算之前读懂数字。
逐个平台连接
Google Ads
官方本地软件包,也可自行部署 Streamable HTTP。准备有资格访问 Ads API 的 Cloud 项目、应用默认凭据(ADC)和广告账户权限。用 YAML 关闭 assets 和 labels,使用 search_search;需要时填写经理帐号 ID。
Meta Ads
Meta 托管 https://mcp.facebook.com/ads。使用受支持的连接器,或完成自有应用的 OAuth。自有应用参考 ads_mcp_management 和 ads_read,仅允许报表工具。先查花费最高的广告系列。
TikTok Ads
官方 MCP 支持读写。通过受支持的 OAuth 流程授权。可从下方 progressive 地址与报表工具开始。flat 与 progressive 的区别是工具发现,而不是权限隔离。
Snap Ads
官方只读 MCP:https://mcp.snapchat.com/ads。使用受支持的客户端,按要求完成组织审批与成员授权,并保留原有账户权限限制。先查单账户花费和曝光。
Microsoft Advertising
官方托管地址:https://partner.api.bingads.microsoft.com/ext/mcp/vnext。按客户端说明完成 Microsoft Entra OAuth。尽管权限名是 msads.manage,文档列出的 MCP 工具为只读。先试 get_campaigns。
Amazon Ads
官方开放测试面向符合条件的 Ads API 合作伙伴。按 Amazon 链接里的 Lite 指南获取适用地址,完成独立于 Seller Central 的 Ads 授权。Lite 不等于只读;先发现账户,再查询报表。
LinkedIn Ads
符合条件时可用只读 ChatGPT 测试版应用。未核实适用于通用客户端的公开 MCP 地址。自建请使用获准的 Advertising API、成员 OAuth 与 r_ads_reporting;示例调用 GET /rest/adAnalytics。
X Ads
官方地址:https://ads-api.x.com/mcp。用用户 OAuth 申请 ads.read;刷新增 offline.access。不授予 ads.write。先试 list_ads_accounts;可参考附带的 OpenAI 示例。
TikTok progressive MCP
https://business-api.tiktok.com/open_mcp/tt-ads-mcp-layer运行本地示例
在解压目录运行。stdio 冒烟测试不会访问广告平台。运行后,可复制 TOML 文件中的 ads_demo 并替换路径。请求 demo 账户 2026-11-01 至 2026-11-07 的报表。真实 LinkedIn 模式需从密钥库载入授权令牌,再设置 ADS_SOURCE=linkedin、LINKEDIN_AD_ACCOUNTS 和仍受支持的 LINKEDIN_VERSION。示例限制返回展示的行数,不是账户总计。
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r code/requirements.txt
python code/smoke_test.py代码文件与下一步
- `Codex Examples.toml`: 本地服务器、Google 和 X 的 Codex 配置。
- `Google Read Only.yaml + Google Campaign Report.gaql`: Google 只读配置和 GAQL API 查询。若 MCP 工具要求结构化字段,不要传入原始 GAQL。
- `Meta Insights.sh`: 与 MCP 分开的 Graph API 检查,只取首屏。
- `OpenAI Remote Example.py`: OpenAI Responses API:HTTPS 地址、OAuth 令牌和单一工具。审批时等待人工确认;示例不会自动批准。
- Codex MCP setup · OpenAI remote MCP · Approval flow
- LinkedIn Ads app · TikTok OAuth · Microsoft tool schemas · Meta Insights API
在 Codex 中连接 Snap Ads
在运行 Codex 的同一设备执行两条命令,然后自行完成 Snapchat 授权。文档权限为 snapads.read。如果组织尚未批准该客户端,需要管理员审批。
codex mcp add snap-ads --url https://mcp.snapchat.com/ads --oauth-client-id codex-snap-ads
codex mcp login snap-adsSnap for Developers: client setup
本地示例用合成数据测试,LinkedIn 适配器用模拟响应测试;未使用任何真实广告账户。

评论
暂无已发布的评论。