MCP分析设置
使用Claude Desktop设置营销分析模型上下文协议（MCP）服务器的完整指南。
概述
此存储库包含了逐步指南，用于设置三台强大的MCP服务器，以便直接从Claude Desktop访问您的营销分析数据：
- 🔍 Google Analytics 4 (GA4) MCP（注：MCP在此处可能代表某种特定的认证、课程或计划，但具体含义需根据上下文确定，若无特定上下文，可直译为“Google Analytics 4 (GA4) MCP”，保持原样以保留其专业或特定含义） - 访问网站分析和见解
- 📱 Facebook MCP（注：MCP在此处可能是一个特定上下文中的缩写或特定术语，由于没有具体上下文，这里直接保留原样翻译。若MCP有具体含义，应根据具体含义进行翻译。） - 访问Facebook页面和Instagram商业数据
- 📧 Klaviyo MCP（注：MCP在此处可能代表某个特定职位或认证，但根据上下文无法确定具体含义，因此直接保留原样） - 访问电子邮件营销活动、流程和客户数据
特点/特性
- ✅ 实时访问Claude Desktop中的营销数据
- ✅ 使用自然语言进行查询分析
- ✅ 创建活动并管理内容
- ✅ 生成报告和见解
- ✅ 发布到社交媒体平台
- ✅ 自动化工作流程和数据检索
先决条件
- 操作系统Windows（已在Windows 10/11上测试）
- python3.13或更高版本
- Claude Desktop（可译为“Claude桌面版”或保持原样，根据上下文决定是否需要具体化为“Claude桌面应用程序”等）： 在此下载
- 包管理器pip，pipx，uv
所需账户
- Google Cloud 账户（用于 GA4）
- Meta开发者账户（适用于Facebook/Instagram）
- 拥有所有者、管理员或经理角色的Klaviyo账户
快速入门
# Install package managers
pip install pipx uv
pipx ensurepath
# Clone this repository
git clone https://github.com/YOUR_USERNAME/mcp-analytics-setup.git
cd mcp-analytics-setup
# Follow the setup guides for each service安装指南
📊 表格/数据图表 第一部分：Google Analytics 4 设置
- 创建Google Cloud项目
- 设置服务账户
- 配置GA4 API访问
- 安装GA4 MCP服务器
📱 代表智能手机或移动设备的符号，可翻译为“📱（智能手机/移动设备）”。不过，在实际应用中，这个符号本身通常不需要翻译，直接在文本中使用即可，以表示智能手机或移动设备。 第二部分：Facebook与Instagram设置
- 创建Meta开发者应用
- 生成页面访问令牌
- 配置Facebook MCP服务器
- 启用Instagram商业API
📧 表示电子邮件的图标，可翻译为“电子邮件”或“邮件”。 第三部分：Klaviyo设置
- 创建Klaviyo私有API密钥
- 配置权限
- 安装Klaviyo MCP服务器
- 测试连接
配置
完成所有设置指南后，您的 claude_desktop_config.json 应该看起来像这样：
{
"mcpServers": {
"google-analytics": {
"command": "pipx",
"args": ["run", "analytics-mcp"],
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "/path/to/ga4-credentials.json",
"GOOGLE_PROJECT_ID": "your-project-id"
}
},
"facebook": {
"command": "python",
"args": [
"-m",
"uv",
"--directory",
"/path/to/facebook-mcp-server",
"run",
"facebook-mcp-server"
]
},
"klaviyo": {
"command": "python",
"args": ["-m", "uv", "tool", "run", "klaviyo-mcp-server@latest"],
"env": {
"PRIVATE_API_KEY": "your_klaviyo_api_key",
"READ_ONLY": "false",
"ALLOW_USER_GENERATED_CONTENT": "false"
}
}
}
}示例查询
一旦配置完成，您就可以向Claude询问：
Google Analytics（谷歌分析）
- “给我展示过去30天的网站流量”
- “我的表现最佳页面有哪些？”
- “比较本月与上个月的流量”
Facebook/Instagram（脸书/照片墙）
- “在我的脸书主页上发帖：‘快来看看我们的新产品！’”
- “给我看看我最近帖子的互动数据”
- “获取我过去一周的Instagram数据分析”
Klaviyo
- “展示我过去30天电子邮件营销活动的表现”
- “哪个流量渠道在转化率方面表现最好？”
- “为我们的阵亡将士纪念日促销活动创建一封电子邮件营销邮件”
项目结构
mcp-analytics-setup/
├── README.md # This file
├── docs/
│ ├── GA4_SETUP.md # Google Analytics setup
│ ├── FACEBOOK_SETUP.md # Facebook/Instagram setup
│ ├── KLAVIYO_SETUP.md # Klaviyo setup
│ └── TROUBLESHOOTING.md # Common issues and solutions
├── examples/
│ ├── claude_desktop_config.example.json
│ ├── facebook.env.example
│ └── queries.md # Example queries to try
└── .gitignore安全最佳实践
⚠️ 重要永远不要将凭证提交到git中！
- 使用
.gitignore- 所有凭证文件均被排除 - 限制权限 仅授予必要的API权限
- 轮换令牌 - 定期生成新的访问令牌
- 监控使用情况 - 设置API使用警报
- 安全存储 - 在密码管理器中存储凭据
见 SECURITY.md 翻译为中文是“安全指南.md”或“安全声明文件.md”，具体翻译可能根据上下文有所调整，但通常指的是一个包含安全相关信息的Markdown文件 以获取详细的安全指南。
故障排除
常见问题
MCP服务器未出现在Claude中
- 验证配置文件中的JSON语法
- 检查所有路径是否使用了适合您操作系统的正确格式
- 完全重启Claude桌面版
Facebook“无效令牌”错误
- 令牌可能已过期 - 生成新的页面访问令牌
- 确保您使用的是页面令牌，而不是用户令牌
Klaviyo连接失败
- 验证API密钥是否具有正确的权限
- 检查一下
uv已安装：pip install uv
看见 《故障排除指南.md》 以获取更多解决方案。
API速率限制
谷歌分析数据API
- 每个项目支持10个并发请求
- 每个项目每天20万个代币
脸书图谱API
- 每用户每小时200次呼叫
- 每个用户每天4,800次通话
Klaviyo API
- 速率限制因计划层级而异
- 在Klaviyo账户设置中监控使用情况
资源
MCP 服务器存储库
- GA4（Google Analytics 4，即谷歌分析4）: 分析-MCP（或“分析-多控制点”）
- 脸书： Facebook MCP 服务器
- Klaviyo： Klaviyo MCP 服务器
做出贡献
欢迎投稿！请阅读 CONTRIBUTING.md 翻译为中文是“贡献指南/贡献说明文件”。这个文件通常用于说明如何为开源项目做出贡献，包括提交代码、报告问题、参与讨论等具体指南 有关我们的行为准则以及提交拉取请求的流程的详细信息，请参阅。
许可证
这个项目采用MIT许可证授权——详见 许可证 文件中有详细信息。
致谢
- “Anthropic” 翻译成中文是“类人（的）”或根据上下文可译为“具有人类特征的”、“类似人类的”等，具体含义需结合语境来确定 为克劳德和MCP（注：MCP可能代表某个特定的人名、组织名或项目名，具体含义需根据上下文确定）
- MCP服务器开发者们，感谢你们提供的卓越工具
- 社区贡献者
支持
______________________________________________________________________
专为使用Claude Desktop的营销团队倾心打造
最后更新时间2025年10月