MCP服务器连接OpenAI Ads API:通过Claude和Codex查询ChatGPT广告
一款新的开源MCP服务器使Claude、Codex等AI助手能够通过自然语言查询OpenAI广告活动的各项数据。该只读工具支持11个API端点,涵盖广告账户、活动、广告组、广告及效果洞察。兼容Claude Desktop、Cursor、VS Code等客户端,可通过npx一键运行,需要Node.js 20+和OpenAI Ads API密钥。
近日,一款名为“openai-ads-mcp”的开源项目在Hacker News上亮相。该项目是一个模型上下文协议(MCP)服务器,专为OpenAI Ads(ChatGPT Ads)API设计,允许Claude、Codex等MCP兼容的AI助手通过自然语言查询广告数据。目前该工具为只读版本,不会创建、编辑或暂停任何广告活动,也不会消耗预算。它提供了11个只读工具,覆盖广告账户、广告活动、广告组、广告及效果洞察等层面。用户可以通过简单的自然语言提问,例如“列出我所有活跃的广告活动及其预算”或“显示最近30天每天的花费、点击次数和点击率”。这些工具的设计直接返回API的原始JSON,确保数据不被篡改;同时将HTTP状态码和错误信息清晰传递给模型,便于调试。此外,工具描述中明确解释了微单位(micros)的转换规则,帮助AI助手呈现人类可读的货币金额。安装非常简便,只需通过npx命令(npx -y @hypd-ai/openai-ads-mcp)即可运行,无需克隆仓库或构建项目。对于Claude Desktop、Cursor、VS Code等主流MCP客户端,均有详细的配置示例。值得注意的是,API中的金额字段以微单位表示,例如campaign的lifetime_spend_limit_micros字段,1,000,000微单位等于1个账户货币单位(如1美元)。但洞察指标如花费、每次点击费用等已经是货币小数形式,无需转换。项目采用MIT许可证发布,由HYPD AI社区开发,并非OpenAI官方产品。路线图中计划未来支持写入操作(创建、更新、暂停广告活动)、创意上传、地理位置定向、转化API支持以及远程HTTP传输等。对于希望利用AI管理广告投放的用户来说,这是一个非常实用的工具,能够大幅提升广告数据查询的效率。