营销MCP服务器(Meta+Shopify+GA4)
此服务器通过HTTP+SSE实现了模型上下文协议(MCP),因此ChatGPT可以作为自定义连接器进行连接。
快速启动
- 安装deps
npm install- 设置环境变量
创建 .env 基于 .env.example.
- 在本地运行
npm run build && node dist/index.js服务器启动于 http://localhost:3030MCP SSE端点为 http://localhost:3030/mcp.
在ChatGPT中连接(开发人员模式)
- 设置→ 连接器→ 创建→ URL:您的公共HTTPS URL
/mcp(在开发中使用ngrok)
ngrok示例:
ngrok http 3030复制 https://*.ngrok-free.app/mcp 指向ChatGPT连接器的URL。
元应用程序(初学者步骤)
- 前往Meta开发者专区→ 创建应用程序→ 选择业务(用于营销API)
- 在您的应用仪表板中→ 添加产品→ 添加“营销API”
- 在Facebook登录(稍后用户身份验证可选)下,您现在可以跳过(我们将从开发中的长期系统用户令牌开始)
- 创建业务应用程序或使用您的业务经理;创建系统用户并分配广告帐户访问权限
- 为系统用户生成具有以下作用域的长期访问令牌:
ads_management,ads_read,read_insights(最低阅读量) - 把它放入……
.env作为META_ACCESS_TOKEN - 对于生产和客户端访问,您需要:对权限进行适当的应用程序审查、业务验证,最好是每个客户端的OAuth流
Shopify(初级步骤)
- 在客户的Shopify管理员中→ Apps → 开发应用程序→ 创建应用程序
- 配置管理员API访问作用域(read_orders、read_products;如果需要,更多)
- 将应用程序安装到商店并复制管理员API访问令牌
- 将存储域和令牌放入
.env作为SHOPIFY_STORE,SHOPIFY_ACCESS_TOKEN
GA4(初级步骤)
- 在谷歌云中→ 创建服务帐户
- 授予其访问GA4属性的权限(管理员→ 物业出入管理)
- 下载服务帐户JSON并将其粘贴(原始或base64)到
.env作为GA4_SERVICE_ACCOUNT_JSON
可用工具(现在)
health-check,echo,time-now,sum- 树桩:
meta.list-campaigns,meta.create-campaign,shopify.list-orders,shopify.list-products,ga4.run-report
下一步
- 用真正的API调用替换存根(Meta Graph、Shopify Admin、GA4 Data API)
- 添加写入操作的确认流程(例如,创建活动)
- 添加每个客户端的身份验证存储和作用域
