Google Business Profile MCP

English | Русский

A1 Google Business Profile MCP permite que una aplicación de IA trabaje con las ubicaciones de tu Google Business Profile en lenguaje natural. Inspecciona ubicaciones y rendimiento, responde a reseñas, prepara publicaciones locales y actualiza la información del perfil de forma deliberada.

Se conecta a las API actuales de Business Profile de Google y a la API heredada donde todavía se encuentran las reseñas y las publicaciones. Una cuenta de Google y las credenciales OAuth por sí solas no son suficientes: Google debe aprobar Basic API Access para el proyecto de Google Cloud.

• 20 herramientas. Datos de ubicaciones y cuentas, rendimiento, reseñas, publicaciones locales, categorías y atributos.

• Puerta de aprobación real. Los proyectos comienzan con 0 QPM; cada llamada a la API falla hasta que Google aprueba la solicitud de Basic API Access.

• Límite de publicación independiente. Una respuesta, publicación o actualización de ubicación preparada cambia la información pública de la empresa solo después de que el cliente confirme la operación de escritura.

• Cuatro superficies de API. Account Management, Business Information, Performance y la v4 heredada funcionan a través de un único ámbito OAuth business.manage.

Comienza con una pregunta de solo lectura:

Enumera mis ubicaciones y muestra las reseñas más recientes que no tienen respuesta.

Conectar el servidor · Explorar casos de uso · Abrir documentación técnica

Compruébalo en un minuto

Tú: Enumera mis ubicaciones y muestra las reseñas más recientes que no tienen respuesta.

Asistente: Muestra las ubicaciones y las reseñas recientes. No cambia nada.

Tú: Redacta una respuesta a la reseña de tres estrellas más reciente de la ubicación del centro. Pide disculpas y ofrece ayuda.

Asistente: Muestra la ubicación, la reseña y la respuesta propuesta, y luego pide confirmación antes de publicarla.

Tú: Confirma.

Asistente: Publica la respuesta. No altera la reseña, otras ubicaciones ni publicaciones.

Related MCP server: Local Business Data MCP Server

Contenido

• Inicio rápido

• Qué puedes pedirle que haga

• Qué puede cambiar

• Cómo obtener acceso

• Configuración

• Datos, límites y trabajo en segundo plano

• Documentación técnica

• Soporte

Inicio rápido

Necesitas Node.js 20 o superior, un Google Business Profile verificado, un cliente OAuth de Google Cloud y una solicitud aprobada de Basic API Access.

1. Obtén acceso aprobado.

2. Añade el servidor a tu aplicación de IA.

3. Comienza con la pregunta de solo lectura anterior.

En Configuración → Plugins → Servidores MCP, elige Añadir servidor y añade npx -y mcp-google-business@latest con GOOGLE_BUSINESS_CLIENT_ID, GOOGLE_BUSINESS_CLIENT_SECRET y GOOGLE_BUSINESS_REFRESH_TOKEN.

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

Documentación de MCP de Codex

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

Documentación de MCP de Claude Code

Abre Configuración → Desarrollador → Editar Config y añade:

{"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"}}}}

Si Editar Config no está disponible, edita ~/Library/Application Support/Claude/claude_desktop_config.json en macOS o %APPDATA%\Claude\claude_desktop_config.json en Windows. Documentación de MCP de Claude Desktop

Añade {"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"}}}} a ~/.cursor/mcp.json en macOS/Linux o %USERPROFILE%\.cursor\mcp.json en Windows. Documentación de MCP de Cursor

Ejecuta MCP: Open User Configuration y añade:

{"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}]}

Verifícalo con MCP: List Servers. Documentación de MCP de VS Code

Qué puedes pedirle que haga

• Enumera ubicaciones, categorías, atributos e información actual del perfil.

• Muestra llamadas, solicitudes de indicaciones e impresiones de palabras clave de búsqueda para un período elegido.

• Encuentra reseñas recientes, redacta una respuesta y publícala tras la confirmación.

• Prepara, actualiza o elimina una publicación local.

• Actualiza un campo o atributo específico de una ubicación después de mostrar el cambio exacto.

Qué puede cambiar

El cliente de IA controla las confirmaciones; el servidor marca las herramientas para que el cliente pueda distinguir la inspección de un cambio real.

Cómo obtener acceso

Google exige tanto la aprobación de OAuth como la de Basic API Access.

1. Usa un Google Business Profile verificado y activo que exista desde hace al menos 60 días; solicita el acceso desde una cuenta de propietario o administrador y ten un sitio web de empresa que coincida con la solicitud.

2. Crea un proyecto en Google Cloud y habilita My Business Account Management API, Business Information API, Business Profile Performance API y Google My Business API (v4 heredada).

3. Envía el formulario de contacto de la API de GBP como Solicitud de Basic API Access. Antes de la aprobación, la cuota es de 0 QPM; los proyectos aprobados reciben 300 QPM por API.

4. Crea un cliente OAuth, obtén un token de actualización para https://www.googleapis.com/auth/business.manage y configura las tres variables GOOGLE_BUSINESS_*.

Trata el secreto de cliente y el token de actualización como contraseñas. Un token de acceso es una alternativa de corta duración para un uso puntual.

Configuración

* Proporciona el trío OAuth o un token de acceso. Las anulaciones del host de la API se documentan en la referencia de herramientas.

Datos, límites y trabajo en segundo plano

• Google recibe las solicitudes del perfil. La telemetría anónima incluye datos de instalación y versión además de los nombres de las herramientas, nunca secretos OAuth, datos de perfil, argumentos o mensajes. Establece ASKADS_TELEMETRY=0 para no participar.

• Límites de edición reales. Los proyectos aprobados reciben 300 QPM por API; Google también limita cada Google Business Profile a 10 ediciones por minuto. Las métricas de rendimiento pueden retrasarse unos días, y las respuestas a reseñas requieren ubicaciones verificadas.

• Sin supervisión en segundo plano. El servidor solo se ejecuta cuando se le llama. Si tu aplicación de IA admite tareas programadas, puede revisar periódicamente nuevos comentarios o métricas.

Documentación técnica

• Catálogo de capacidades de MCP — páginas orientadas a tareas para cada herramienta.

• Todas las herramientas y entradas

• Documentación de desarrollo

• Documentación de publicación

• Documentación de la API de Google Business Profile

Soporte

¿Has encontrado un error o necesitas un escenario? Crea un issue o escribe en Telegram.