使用说明

元广告MCP服务器

使用模型上下文协议（MCP）直接从Claude查询元广告（Facebook/Instagram）数据

🎯 概述

此MCP服务器使您的整个团队能够通过与Claude的自然语言对话访问Meta广告数据。不再需要手动导出、API调用或复杂的脚本-只需询问Claude您需要了解的关于您的活动的信息。

主要优势：

✅ 自然语言查询-无需编码
✅ 从Meta Graph API实时访问数据
✅ 全团队标准化
✅ 即时报告生成
✅ 跨活动和时间段的比较分析

🚀 快速开始

先决条件

Python 3.10+
克劳德桌面
元业务经理帐户
Meta Graph API访问令牌

易于安装（推荐）

在终端中运行此命令以自动设置所有内容（安装Python、依赖项和配置Claude）：

curl -fsSL https://raw.githubusercontent.com/Sola-Wood-Flowers/meta-mcp-server/main/install.sh | bash

注：安装后，您必须完全重新启动Claude Desktop（Cmd+Q）才能使更改生效。

手动安装

克隆或下载 此存储库
安装依赖项：
```
pip install -r requirements.txt
```
获取您的Meta代币 从元开发人员

配置环境：

echo "META_ACCESS_TOKEN=your_token_here" > .env

测试连接：
```
python test_connection.py
```
配置Claude桌面 （参见安装指南)
重新启动克劳德 并开始查询！

📊 你能做什么？

基本查询

Show me all my Meta ad accounts
List active campaigns for account 123456789
What's the performance of campaign X this week?

分析

Compare my campaigns from January vs February
Which campaigns have the best CTR this month?
Show me Instagram insights for the last 7 days

报告

Generate an executive summary for account 123456789
Audit my campaigns and identify optimization opportunities
Create a weekly performance report

看使用示例更多！

🛠️ 可用工具

服务器提供了Claude可以使用的6个工具：

工具	说明
`get_ad_accounts`	列出所有可用的广告帐户
`get_campaigns`	获取具有可选状态筛选的活动
`get_campaign_insights`	检索日期范围的性能指标
`get_instagram_insights`	获取Instagram商业帐户指标
`get_facebook_page_insights`	获取Facebook页面统计信息
`get_ad_creative`	检索广告创意细节

📁 项目结构

meta-mcp-server/
├── meta_ads_mcp.py           # Main MCP server
├── test_connection.py        # Connection test script
├── requirements.txt          # Python dependencies
├── pyproject.toml           # Package configuration
├── .env                     # Environment variables (create this)
├── .gitignore              # Git ignore file
├── README.md               # This file
├── INSTALLATION_GUIDE.md   # Detailed setup instructions
└── USAGE_EXAMPLES.md       # Query examples and use cases

🔐 安全最佳实践

对于个人团队成员

从不共享代币 -每个人都有自己的
使用长期代币 -避免每小时重新生成令牌
最低权限 -只给需要的东西
定期轮换 -定期更新令牌

对于团队

选项A（推荐）：带有个人代币的个人装置
选项B：具有安全令牌管理的集中式服务器

必需的权限

您的Meta令牌需要以下权限：

ads_read -读取广告帐户数据
business_management -访问业务经理
pages_read_engagement -阅读页面见解
instagram_basic -访问Instagram数据
instagram_manage_insights -阅读Instagram见解

🆘 故障排除

常见问题

“未配置META_ACCESS_TOKEN”

检查你的 .env 文件存在并包含令牌
验证Claude Desktop配置中的路径是否正确

“OAuth访问令牌无效”

您的令牌已过期（临时令牌过去1小时）
生成新令牌或切换到长期令牌

“权限不足”

在Graph API资源管理器中添加所需权限
添加权限后重新生成令牌

克劳德无法识别服务器

验证中的绝对路径 claude_desktop_config.json
完全重新启动克劳德桌面
检查日志： ~/Library/Logs/Claude/ （Mac）或 %APPDATA%\Claude\logs\ （Windows）

看安装指南了解详细的故障排除。

📚 文档

安装指南 -完整的设置说明
使用示例 -查询示例和工作流
Meta Graph API文档
MCP文件

🤝 团队使用情况

标准化查询

使用常见查询创建共享文档：

Weekly Report: "Show performance for account X from [dates]"
Campaign Check: "List active campaigns with spend > $100/day"
Quick Status: "Account X status and top 3 campaigns"

分享见解

团队成员可以参考彼此的查询：

"Use the same analysis Sarah did for Q4 campaigns"
"Run the budget check workflow on my accounts"

最佳实践

记录常用查询
为定期报告创建模板
分享优化结果
保持一致的日期格式（YYYY-MM-DD）

🔄 更新和维护

更新服务器

git pull origin main
pip install -r requirements.txt --upgrade

令牌续订

在元开发人员中生成新令牌
更新 .env 文件或Claude桌面配置
重新启动克劳德桌面

添加新功能

服务器是用MCP构建的——添加新工具很简单：

在中添加工具定义 handle_list_tools()
实现逻辑 handle_call_tool()
测试用 test_connection.py

📊 指标和数据

可用指标

战役级别：展示次数、点击次数、支出、覆盖范围、频率、点击率、点击成本、CPM、转化率
Instagram：关注者数量、印象、影响力、参与度、个人资料浏览量
Facebook页面：页面粉丝、印象、参与用户、帖子参与度

日期范围

指定自定义范围： YYYY-MM-DD 格式
常用短语有效：“上周”、“本月”、“2024年第一季度”
Claude自动处理日期解析

🎓 训练你的团队

非技术用户

向他们展示以下示例查询使用示例
从简单的查询开始：“显示我的帐户”
构建复杂：“比较活动并推荐优化”

分析师

在一个问题中组合多个查询
请求特定的数据格式（CSV、表格）
用于临时分析和探索

对于管理者

定期生成报告
跨账户比较
预算跟踪和预测

📝 更新日志

版本1.0.0（2026年2月）

初始版本
Meta Ads数据的6个核心工具
Instagram和Facebook页面见解
全面的错误处理
连接测试工具

📄 许可证

MIT许可证-有关详细信息，请参阅许可证文件

🙋 支持

安装程序有问题吗？

跑 python test_connection.py 诊断
检查克劳德桌面日志
验证Meta中的令牌权限

问题？

内置于❤️ 对于那些想花更少的时间提取数据、花更多时间做决策的营销团队来说。