分析MCP服务器——WordPress插件
一个WordPress插件,它公开了一个 模型上下文协议(MCP) 端点,让克劳德桌面直接以自然语言查询您的谷歌搜索控制台和谷歌分析4数据。
______________________________________________________________________
目录
______________________________________________________________________
它的作用
- 在以下位置添加REST端点
https://yoursite.com/wp-json/mcp/v1/mcp - 通过共享的API密钥验证Claude Desktop
- 使用服务帐户连接到Google API服务器端——凭据永远不会离开您的服务器
- 在GSC和GA4中提供7个工具,所有工具均具有 只读 访问
______________________________________________________________________
安装
- 上传
wp-analytics-mcp文件夹到/wp-content/plugins/ - 通过以下方式激活插件 WP管理员→ 插件
- 首选 设置→ 分析MCP 配置
______________________________________________________________________
Google服务帐户设置
你只做一次。 您的整个团队通过一个共享服务帐户连接。
谷歌云服务帐户就像一个机器人用户——它有自己的电子邮件地址和凭据,你授予它对你的分析属性的只读访问权限。
第一步——创建或选择谷歌云项目
- 首选 console.cloud.google.com 并登录
- 点击 项目下拉列表 在页面顶部
- 选择一个现有项目,或单击 新项目,命名它(例如。
FooPlugins Analytics),然后单击 创建
步骤2——启用所需的API
- 在左侧边栏中,转到 API和服务→ 图书馆
- 搜索 谷歌分析数据API → 点击它→ click 启用
- 搜索 谷歌搜索控制台API → 点击它→ click 启用
如果您看到“API已经启用”-无需执行任何操作,请继续。
步骤3——创建服务帐户
- 在左侧边栏中,转到 IAM和管理员→ 服务账户
- 点击 +创建服务帐户
- 填写a 服务帐户名称 --使用类似的东西
fooplugins-mcp - 这 服务帐户ID (电子邮件)将自动填写-- 复制此电子邮件,在接下来的两节中,您将需要它
- 点击 创建并继续
- 跳过可选的角色/权限步骤——只需单击 继续那么 完成
步骤4——下载JSON密钥文件
- 在服务帐户列表中,单击您的新服务帐户 名字
- 去 钥匙 标签
- 点击 添加关键点→ 创建新密钥
- 选择 JSON 然后单击 创建
- A.
.json文件自动下载-- 这是您粘贴到插件中的文件
⚠️ 请确保此文件的安全。 永远不要将其提交到公共Git仓库或通过电子邮件/Slack共享。任何拥有它的人都可以读取您的分析数据。把它当作密码。
______________________________________________________________________
谷歌分析4设置
您需要步骤3中的服务帐户电子邮件(看起来像 fooplugins-mcp@your-project.iam.gserviceaccount.com).
步骤5——将服务帐户添加到GA4
- 首选 analytics.google.com 并登录
- 点击 管理员 左下角的齿轮图标
- 在 账户 列,单击 帐户访问管理 (授予对所有财产的访问权限),或 物业出入管理 仅限于一处房产
- 点击蓝色 + 按钮→ 添加用户
- 将服务帐户电子邮件粘贴到 电子邮件地址 领域
- 将角色设置为 观众 --只读,无法修改任何内容
- 点击 添加
💡 查找您的GA4房产ID: 转到管理员→ 财产→ 属性设置。这是一个数字,就像 123456789。当提示Claude运行GA4报告时,您将需要此信息。______________________________________________________________________
谷歌搜索控制台设置
与上述服务帐户电子邮件相同。
步骤6--将服务帐户添加到搜索控制台
- 首选 search.google.com/search-console 并登录
- 从左侧边栏中选择您希望Claude访问的属性
- 首选 设置→ 用户和权限
- 点击 添加用户
- 将服务帐户电子邮件粘贴到 电子邮件地址 领域
- 将权限设置为 满的 — _不_ 受限(受限阻止URL检查)
- 点击 添加
💡 对您希望Claude访问的每个GSC属性重复步骤6。每个属性都需要单独添加。
______________________________________________________________________
插件配置
步骤7--添加您的凭据
- 首选 WP管理员→ 设置→ 分析MCP
- 打开您下载的
.json在任何文本编辑器中选择文件,选择全部,然后复制 - 将完整的JSON粘贴到 服务帐户JSON 领域
- 点击 保存设置 --该页面将确认它加载的服务帐户电子邮件
步骤8-生成API密钥
- 在同一设置页面上,单击 生成新的API密钥
- 页面顶部的配置块将使用您的密钥进行更新
- 复制完整的配置块——这是每个队友粘贴到Claude Desktop中的内容
______________________________________________________________________
团队设置--克劳德桌面
每个队友做一次。大约需要5分钟。他们不需要设置谷歌帐户。
步骤9——配置Claude桌面
- 打开克劳德桌面→ 设置→ 开发者→ 编辑配置
- 将插件设置页面中的配置块粘贴到JSON文件中:
{
"mcpServers": {
"analytics-mcp": {
"command": "npx",
"args": [
"-y",
"mcp-remote@latest",
"https://yoursite.com/wp-json/mcp/v1/mcp",
"--header",
"Authorization: Bearer YOUR_API_KEY"
]
}
}
}- 保存文件并 完全退出并重新启动 克劳德桌面版
- 转到“设置”→ 开发者——你应该看看
analytics-mcp与状态 跑步
______________________________________________________________________
可用工具
| 工具 | 来源 | 描述 |
|---|---|---|
gsc_list_sites | GSC | 列出服务帐户可以访问的所有Search Console属性 |
gsc_query_search_analytics | GSC | 查询点击次数、展示次数、点击率和平均位置 |
gsc_inspect_url | GSC | 检查特定URL的索引状态 |
gsc_list_sitemaps | GSC | 列出提交的房产地图 |
ga4_run_report | GA4 | 运行一份完整的分析报告——会话、用户、转化率等。 |
ga4_run_realtime_report | GA4 | 过去30分钟内的实时活跃用户 |
ga4_list_metadata | GA4 | 列出所有可用的GA4维度和指标 |
______________________________________________________________________
示例提示
Google搜索控制台
- “列出我的所有搜索控制台属性”
- “显示上个月fooplugins.com的前20个查询,显示次数超过50次”
- “哪些页面的展示率高,但点击率低?”
- “是https://fooplugins.com/foogallery/在谷歌中索引?"
谷歌分析4
- “给我一份过去30天GA4属性123456789的流量摘要”
- “本月我的前10页是什么?”
- “按设备类别比较过去90天的会话”
- “按国家分列,我现在有多少活跃用户?”
______________________________________________________________________
故障排除
| 错误 | 修复 |
|---|---|
"No service account JSON configured" | 粘贴完整 .json 将文件内容保存到插件设置中并保存 |
"Could not load private key" | 确保你复制了整个JSON——不要截断 private_key 现场 |
| 来自Google的HTTP 403 | 服务帐户尚未添加到GA4或GSC属性中——请检查上面的设置部分 |
"Invalid or missing API key" | Claude Desktop配置中的键与设置页面上的键不匹配——重新生成并更新 |
| Claude Desktop中的状态显示“失败” | 转到WP管理员→ 设置→ 固定链接和点击 保存更改 刷新路线 |
| 工具出现但不返回数据 | 验证服务帐户电子邮件是否在GA4中添加为查看器,在GSC中添加为完全用户 |
rest_no_route 在 /mcp endpoint | 插件未处于活动状态,或永久链接需要刷新——见上文 |
健康检查URL: https://yoursite.com/wp-json/mcp/v1/health --应该回来 {"status":"ok"} 如果插件运行正常。
