ReputeMap MCP — управление отзывами Google для агентов ИИ

Поверхность Model Context Protocol у ReputeMap: Google Business Profile отзывы — фильтруемый входящий ящик отзывов, статистика по локациям и честные кампании запроса отзывов — для Claude, Cursor, Codex, Gemini CLI и любого другого MCP‑совместимого агента.

"Show me every unanswered review under 3 stars from the last week, worst first."

"Draft replies to the three newest negative reviews in a calm tone."

"We just finished the Hendersons' job — send them a review request."

Вам, вероятно, не нужно ничего запускать. Сервер размещён:

https://api.reputemap.com/mcp          Streamable HTTP · JSON-RPC 2.0
Authorization: Bearer rmk_YOUR_KEY     app.reputemap.com → Settings → API keys

Реестр: com.reputemap/reputemap · любой платный план (учитывается 14-дневная бесплатная пробная версия).

Настройка для каждого клиента

Claude Code — одна команда, перезапуск не требуется:

claude mcp add --transport http reputemap https://api.reputemap.com/mcp \
  --header "Authorization: Bearer rmk_YOUR_KEY"

Cursor — .cursor/mcp.json (проект) или ~/.cursor/mcp.json (глобально):

{
  "mcpServers": {
    "reputemap": {
      "url": "https://api.reputemap.com/mcp",
      "headers": { "Authorization": "Bearer rmk_YOUR_KEY" }
    }
  }
}

Claude Desktop — claude_desktop_config.json, затем полностью перезапустите приложение:

{
  "mcpServers": {
    "reputemap": {
      "command": "npx",
      "args": ["-y", "@reputemap/mcp"],
      "env": { "REPUTEMAP_API_KEY": "rmk_YOUR_KEY" }
    }
  }
}

VS Code (Copilot агент‑режим) — .vscode/mcp.json:

{
  "servers": {
    "reputemap": {
      "type": "http",
      "url": "https://api.reputemap.com/mcp",
      "headers": { "Authorization": "Bearer rmk_YOUR_KEY" }
    }
  }
}

Windsurf — ~/.codeium/windsurf/mcp_config.json (поле называется serverUrl):

{
  "mcpServers": {
    "reputemap": {
      "serverUrl": "https://api.reputemap.com/mcp",
      "headers": { "Authorization": "Bearer rmk_YOUR_KEY" }
    }
  }
}

Codex CLI — ~/.codex/config.toml, затем экспортируйте REPUTEMAP_API_KEY:

[mcp_servers.reputemap]
url = "https://api.reputemap.com/mcp"
bearer_token_env_var = "REPUTEMAP_API_KEY"

Gemini CLI — ~/.gemini/settings.json (поле httpUrl):

{
  "mcpServers": {
    "reputemap": {
      "httpUrl": "https://api.reputemap.com/mcp",
      "headers": { "Authorization": "Bearer rmk_YOUR_KEY" }
    }
  }
}

ChatGPT — Настройки → Подключатели → создать собственный коннектор (Developer mode), укажите https://api.reputemap.com/mcp и выберите аутентификацию по API‑ключу, затем вставьте ваш ключ.

Полные пошаговые руководства со скриншотами: reputemap.com/docs/mcp.

Другие рецепты ( cron‑дайджесты, синхронизация CRM ): reputemap/examples.

Сопутствующие навыки агента:

reputemap/review-skills

(npx skills add reputemap/review-skills).

Что внутри этого репозитория

Беззависимый мост stdio для клиентов, говорящих MCP over stdio и не умеющих отправлять HTTP‑заголовки — в двух вариантах: bin/cli.mjs

(Node 18+, публикуется как @reputemap/mcp) и server.py (Python 3.9+, только stdlib). Оба перенаправляют каждое сообщение JSON-RPC на хостед‑эндпойнт по TLS и возвращают ответы в потоковом режиме.

# Node — однострочник, без установки
REPUTEMAP_API_KEY="rmk_..." npx -y @reputemap/mcp

# Python — без зависимостей
REPUTEMAP_API_KEY="rmk_..." python3 server.py

server.json — манифест, опубликованный в официальный MCP registry как com.reputemap/reputemap.

Будучи примерно в 120 читаемых строках, мост служит и как справочник того, что проходит по проводам: ваш API‑ключ попадает только в заголовок Authorization TLS‑запросов к api.reputemap.com — больше ничего, нигде больше.

Инструменты

Инструмент	Что делает	Credits
list_locations	Каждую локацию организации, с идентификаторами	1
list_reviews	Отзывы, фильтруемые (локация, диапазон рейтинга, без ответа, последние N дней) — включает текст опубликованного ответа	1
get_review_stats	По локациям + итоги: счётчики, средний рейтинг, разбивка 1–5, безответственные, активность за скользящее окно	1
send_review_request	Отправляет реальный запрос на отзыв через движок кампании (учитывает отписки; идемпотентно)	1
get_usage	Расход кредитов за текущий месяц	free

Кредиты идут с любым планом ReputeMap (1 000/мес, разделяются с REST API); get_usage бесплатен и говорит, где вы находитесь. Ограничение скорости: 60 запросов в минуту на организацию.

Единственное действие на запись — send_review_request — проходит через тот же механизм подавления/отключения, что и внутри кампаний, поэтому слишком настойчивый агент не сможет заспамить ваших клиентов. Инструменты несут MCP‑метки (readOnlyHint/destructiveHint) и обнаружение (initialize, tools/list) работает без ключа, чтобы клиенты могли отрендерить каталог до аутентификации.

Отзовите ключ в любое время — доступ немедленно прекращается.

Примечания к протоколу

Методы: initialize → notifications/initialized → tools/list / tools/call. Ошибки протокола используют стандартные коды JSON‑RPC; ошибки на уровне инструментов (некорректный id, недостаточно кредитов) возвращаются как результаты инструментов, которые может читать ваш агент.
Сервер не сохраняет состояние — сессия не требуется; мост по‑прежнему учитывает Mcp-Session-Id и принимает как JSON, так и SSE‑обрамлённые ответы.
Пакетные запросы отклоняются (удалены в MCP 2025-11-25); чужие заголовки Origin отклоняются.

Ссылки

🌐 reputemap.com — управление отзывами Google для агентств и локального бизнеса
📚 Документация API · Документация MCP
LinkedIn
✉️ yaro@reputemap.com

Лицензия

MIT — см. LICENSE.