Google Business Profile MCP

English | Русский

A1 Google Business Profile MCP 让 AI 应用可以用自然语言管理你的 Google Business Profile 商家地点。查看商家地点和效果数据，回复评价，准备本地帖子，并在确认后审慎地更新商家资料信息。

它连接 Google 当前的 Business Profile API，以及仍然承载评价和帖子的旧版 API。仅有 Google 账号和 OAuth 凭据还不够：Google 必须为 Google Cloud 项目批准 Basic API Access。

• 20 个工具。 商家地点与账号数据、效果数据、评价、本地帖子、类别和属性。

• 真实的审批门槛。 项目从 0 QPM 开始；在 Google 批准 Basic API Access 申请之前，每次 API 调用都会失败。

• 独立的发布边界。 准备好的回复、帖子或商家地点更新只有在客户端确认写入操作后，才会更改公开的商家信息。

• 四组 API 接口。 Account Management、Business Information、Performance 和旧版 v4 都通过一个 business.manage OAuth 范围工作。

从一个只读问题开始：

列出我的商家地点，并显示还没有回复的最新评价。

连接服务器 · 探索使用场景 · 查看技术文档

一分钟查看效果

你： 列出我的商家地点，并显示还没有回复的最新评价。

助手： 显示商家地点和近期评价。不会更改任何内容。

你： 为市中心门店的最新一条三星评价草拟回复。道歉并表示愿意提供帮助。

助手： 显示商家地点、评价和拟定的回复，然后征求你的确认后再发布。

你： 确认。

助手： 发布回复。不会改动评价、其他商家地点或帖子。

Related MCP server: Local Business Data MCP Server

目录

• 快速开始

• 你可以让它做什么

• 哪些内容会被更改

• 获取访问权限

• 配置

• 数据、限制与后台工作

• 技术文档

• 支持

快速开始

你需要 Node.js 20+、一个已验证的 Google Business Profile、一个 Google Cloud OAuth 客户端，以及一份已获批准的 Basic API Access 申请。

1. 获取已批准的访问权限。

2. 将服务器添加到你的 AI 应用。

3. 用上面的只读问题开始。

在 Settings → Plugins → MCP servers 中，选择 Add server，然后使用 GOOGLE_BUSINESS_CLIENT_ID、GOOGLE_BUSINESS_CLIENT_SECRET 和 GOOGLE_BUSINESS_REFRESH_TOKEN 添加 npx -y mcp-google-business@latest。

codex mcp add google-business \
  --env GOOGLE_BUSINESS_CLIENT_ID=your_client_id \
  --env GOOGLE_BUSINESS_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_BUSINESS_REFRESH_TOKEN=your_refresh_token \
  -- npx -y mcp-google-business@latest
codex mcp list

Codex MCP 文档

claude mcp add \
  --env GOOGLE_BUSINESS_CLIENT_ID=your_client_id \
  --env GOOGLE_BUSINESS_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_BUSINESS_REFRESH_TOKEN=your_refresh_token \
  --transport stdio --scope user google-business \
  -- npx -y mcp-google-business@latest
claude mcp list

Claude Code MCP 文档

打开 Settings → Developer → Edit Config 并添加：

{"mcpServers":{"google-business":{"command":"npx","args":["-y","mcp-google-business@latest"],"env":{"GOOGLE_BUSINESS_CLIENT_ID":"your_client_id","GOOGLE_BUSINESS_CLIENT_SECRET":"your_client_secret","GOOGLE_BUSINESS_REFRESH_TOKEN":"your_refresh_token"}}}}

如果 Edit Config 不可用，请在 macOS 上编辑 ~/Library/Application Support/Claude/claude_desktop_config.json，或在 Windows 上编辑 %APPDATA%\Claude\claude_desktop_config.json。Claude Desktop MCP 文档

在 macOS/Linux 上，将 {"mcpServers":{"google-business":{"type":"stdio","command":"npx","args":["-y","mcp-google-business@latest"],"env":{"GOOGLE_BUSINESS_CLIENT_ID":"your_client_id","GOOGLE_BUSINESS_CLIENT_SECRET":"your_client_secret","GOOGLE_BUSINESS_REFRESH_TOKEN":"your_refresh_token"}}}} 添加到 ~/.cursor/mcp.json；在 Windows 上，添加到 %USERPROFILE%\.cursor\mcp.json。Cursor MCP 文档

运行 MCP: Open User Configuration 并添加：

{"servers":{"google-business":{"type":"stdio","command":"npx","args":["-y","mcp-google-business@latest"],"env":{"GOOGLE_BUSINESS_CLIENT_ID":"${input:gbp_client_id}","GOOGLE_BUSINESS_CLIENT_SECRET":"${input:gbp_client_secret}","GOOGLE_BUSINESS_REFRESH_TOKEN":"${input:gbp_refresh_token}"}}},"inputs":[{"type":"promptString","id":"gbp_client_id","description":"Google OAuth client ID"},{"type":"promptString","id":"gbp_client_secret","description":"Google OAuth client secret","password":true},{"type":"promptString","id":"gbp_refresh_token","description":"Google OAuth refresh token","password":true}]}

使用 MCP: List Servers 检查。VS Code MCP 文档

你可以让它做什么

• 列出商家地点、类别、属性和当前的商家资料信息。

• 显示所选时间段内的来电、路线请求和搜索关键字展示次数。

• 查找新评价，草拟回复，并在确认后发布。

• 准备、更新或移除本地帖子。

• 在显示确切变更后，更新选定的商家地点字段或属性。

哪些内容会被更改

AI 客户端控制确认；服务器会对工具进行标记，以便客户端区分检查操作与实际变更。

获取访问权限

Google 要求 同时 获得 OAuth 和 Basic API Access 的批准。

1. 使用一个已验证且处于活跃状态的 Business Profile，且该资料已存在至少 60 天；请从所有者或管理员账号申请，并提供与申请相符的企业网站。

2. 创建一个 Google Cloud 项目，启用 My Business Account Management API、Business Information API、Business Profile Performance API 和 Google My Business API（旧版 v4）。

3. 提交 GBP API 联系表单，申请类型为 Application for Basic API Access。获批前配额为 0 QPM；获批项目每个 API 可获得 300 QPM。

4. 创建 OAuth 客户端，获取 https://www.googleapis.com/auth/business.manage 的刷新令牌，并设置 GOOGLE_BUSINESS_* 这三个变量。

请将客户端密钥和刷新令牌视为密码。访问令牌是用于一次性使用的短期替代方案。

配置

* 请提供 OAuth 三件套或访问令牌。API 主机覆盖项参见工具参考。

数据、限制与后台工作

• Google 会收到商家资料的请求。 匿名遥测包括安装和版本数据以及工具名称，绝不包含 OAuth 密钥、商家资料数据、参数或提示词。设置 ASKADS_TELEMETRY=0 可选择退出。

• 实际的编辑上限。 获批项目每个 API 可获得 300 QPM；Google 还将每个 Business Profile 限制为每分钟 10 次编辑。效果指标可能会滞后几天，评价回复需要已验证的商家地点。

• 没有后台监控。 服务器只在被调用时运行。如果你的 AI 应用支持计划任务，它可以定期查看新的反馈或指标。

技术文档

• MCP 能力目录 — 面向任务、介绍每个工具的页面。

• 所有工具与输入

• 开发文档

• 发布文档

• Google Business Profile API 文档

支持

发现 bug 或需要某个场景？请创建 issue 或在 Telegram 中联系我们。