# 
Google Business Profile MCP
[English](./README.md) | **Русский**
[](https://www.npmjs.com/package/mcp-google-business)
[](https://github.com/A1-x-Tech/mcp-google-business/actions/workflows/ci.yml)
[](https://glama.ai/mcp/servers/A1-x-Tech/mcp-google-business)
[](./LICENSE)
**A1 Google Business Profile MCP** позволяет AI-приложению работать с вашими локациями Google Business Profile на естественном языке. Проверяйте локации и показатели, отвечайте на отзывы, готовьте локальные публикации и осознанно обновляйте информацию о профиле.
Сервер подключается к актуальным API Google Business Profile и legacy API, в котором всё ещё находятся отзывы и публикации. Одного Google-аккаунта и OAuth-данных недостаточно: Google должен одобрить Basic API Access для проекта Cloud.
- **20 инструментов.** Локации и аккаунты, показатели, отзывы, локальные публикации, категории и атрибуты.
- **Реальный барьер одобрения.** Проекты начинают с 0 QPM; каждый вызов API будет ошибкой, пока Google не одобрит заявку Basic API Access.
- **Отдельная граница публикации.** Подготовленный ответ, пост или изменение локации меняет публичную информацию только после подтверждения операции записи в клиенте.
- **Четыре поверхности API.** Account Management, Business Information, Performance и legacy v4 работают через один OAuth scope `business.manage`.
Начните с запроса, который только читает данные:
> Покажи мои локации и самые новые отзывы без ответа.
[Подключить сервер](#быстрый-старт) · [Посмотреть сценарии](#что-можно-поручить) · [Открыть техническую документацию](#техническая-документация)
---
## Увидеть работу за минуту
> **Вы:** Покажи мои локации и самые новые отзывы без ответа.
>
> **Ассистент:** Показывает локации и свежие отзывы. Ничего не меняется.
>
> **Вы:** Подготовь ответ на последний отзыв с тремя звёздами для локации в центре. Извинись и предложи помочь.
>
> **Ассистент:** Показывает локацию, отзыв и предлагаемый ответ, затем запрашивает подтверждение перед публикацией.
>
> **Вы:** Подтверждаю.
>
> **Ассистент:** Публикует ответ. Другие отзывы, локации и посты не изменяются.
## Содержание
- [Быстрый старт](#быстрый-старт)
- [Что можно поручить](#что-можно-поручить)
- [Что может измениться](#что-может-измениться)
- [Как получить доступ](#как-получить-доступ)
- [Конфигурация](#конфигурация)
- [Данные, лимиты и работа в фоне](#данные-лимиты-и-работа-в-фоне)
- [Техническая документация](#техническая-документация)
- [Поддержка](#поддержка)
## Быстрый старт
Нужны Node.js 20+, подтверждённый Google Business Profile, OAuth-клиент Google Cloud и одобренная заявка Basic API Access.
1. [Получите одобренный доступ](#как-получить-доступ).
2. Добавьте сервер в AI-приложение.
3. Начните с запроса, который только читает данные.
Codex
В **Settings → MCP servers** нажмите **Add server**, выберите **STDIO**, укажите команду `npx -y mcp-google-business@latest` и переменные окружения `GOOGLE_BUSINESS_CLIENT_ID`, `GOOGLE_BUSINESS_CLIENT_SECRET`, `GOOGLE_BUSINESS_REFRESH_TOKEN`, затем нажмите **Save**, потом **Restart**.
```bash
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](https://learn.chatgpt.com/docs/extend/mcp?surface=cli)
Claude Code
```bash
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](https://code.claude.com/docs/en/mcp)
Claude Desktop
Актуальный официальный путь — **Settings → Extensions**. Для пользовательского desktop extension откройте **Advanced settings → Extension Developer → Install Extension…**, выберите файл `.mcpb` и следуйте подсказкам.
Этот репозиторий сейчас публикует npm-пакет со stdio и пока не содержит `.mcpb`. Поэтому используйте приведённый ниже JSON stdio-конфиг как fallback только в сборках Claude Desktop, где ещё поддерживается локальная конфигурация:
```json
{"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"}}}}
```
В таких сборках сохраните его в `~/Library/Application Support/Claude/claude_desktop_config.json` на macOS или `%APPDATA%\Claude\claude_desktop_config.json` на Windows.
[Документация Claude Desktop MCP](https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop)
Cursor
Добавьте `{"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` на macOS/Linux или `%USERPROFILE%\.cursor\mcp.json` на Windows. [Документация Cursor MCP](https://cursor.com/docs/mcp)
VS Code
Запустите **MCP: Open User Configuration** и добавьте:
```json
{"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](https://code.visualstudio.com/docs/agent-customization/mcp-servers)
Вы дочитали до конца!