Как подключить Google Merchant Center к Meta Muse через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Google Merchant Center, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Google Merchant Center + Meta Muse

Управляйте Google Merchant Center из любого AI-агента через Merchant API v1: обработанные товары и входные данные товаров, фиды (источники данных), статусы и проблемы товаров, отчёты об эффективности, конкурентоспособности цен и бестселлерах на Merchant Center Query Language, остатки в магазинах и по регионам, промоакции и уведомления. Вход через OAuth с Google; удаление отключено при установке.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GOOGLE_MERCHANT_ACCOUNT_ID

Шаг 1 — Получите учётные данные

Настройка выполняется один раз и занимает около 15 минут. Нужны аккаунт Merchant Center, пользователь Google с доступом к нему (Admin для однократной регистрации проекта) и проект Google Cloud. Коннектор использует Merchant API v1 (https://merchantapi.googleapis.com), который пришёл на смену Content API for Shopping v2.1: Google прекратил поддержку этого API 18 августа 2026 года, с 1 сентября 2026 года его вызовы всё чаще завершаются ошибкой HTTP 410, а в начале 2027 года он будет полностью отключён.

1. Откройте https://console.cloud.google.com, выберите или создайте проект, затем APIs & Services, Library, и включите Merchant API.
2. В APIs & Services, OAuth consent screen выберите Internal для Google Workspace, иначе External со статусом публикации In production. Пока приложение в статусе Testing, Google отзывает его refresh-токены через 7 дней, и коннектор перестаёт работать каждую неделю.
3. В Credentials, Create credentials, OAuth client ID выберите тип Web application и добавьте разрешённый redirect URI <your AnythingMCP URL>/api/mcp-oauth/callback, в AnythingMCP Cloud https://cloud.anythingmcp.com/api/mcp-oauth/callback.
4. Вставьте client ID в GOOGLE_CLIENT_ID, а client secret в GOOGLE_CLIENT_SECRET. В GOOGLE_MERCHANT_ACCOUNT_ID укажите идентификатор аккаунта Merchant Center: число вверху Merchant Center рядом с названием магазина или значение после a= в адресе (merchants.google.com/mc/overview?a=123456789). В расширенном аккаунте (для нескольких клиентов) укажите id расширенного аккаунта, чтобы управлять им самим, или id субаккаунта для конкретного магазина.
5. На странице коннектора нажмите Authorize with Provider и войдите аккаунтом Google, который является пользователем аккаунта Merchant Center: Admin для настройки и записи, Standard для товаров и фидов, Read only для чтения (Performance reporting покрывает только отчёты об эффективности).
6. Один раз зарегистрируйте проект Cloud: запустите google_merchant_center_register_gcp_project, при желании с developer_email. Этот аккаунт Google станет техническим контактом и получит роль разработчика API; если он ещё не пользователь аккаунта, ему придёт приглашение, которое нужно принять в течение 14 дней. До регистрации любой другой вызов отвечает 401 GCP project with id ... is not registered with the merchant account. Нужен пользователь с правами Admin, а регистрация выполняется на основном аккаунте (расширенном или самостоятельном), а не на каждом субаккаунте. google_merchant_center_get_developer_registration показывает зарегистрированные номера проектов.
7. Запустите google_merchant_center_get_account, чтобы проверить подключение.

Один и тот же проект Cloud и OAuth-клиент подходят для всех коннекторов Google (Gmail, Google Calendar, Google Drive, Google Sheets, Search Console, Analytics, Ads, Merchant Center): включите в этом проекте каждый API, используйте те же GOOGLE_CLIENT_ID и GOOGLE_CLIENT_SECRET и авторизуйте каждый коннектор один раз.

Scope и аккаунт: коннектор запрашивает https://www.googleapis.com/auth/content, единственный scope Merchant API (чтение и запись). Возможности ИИ ограничены доступом к Merchant Center у вошедшего пользователя; для агента только на чтение войдите пользователем Read only и отключите все инструменты insert, update, create, fetch и register. Один коннектор работает с одним аккаунтом из GOOGLE_MERCHANT_ACCOUNT_ID. google_merchant_center_list_accounts перечисляет все аккаунты, которые может открыть пользователь, а google_merchant_center_list_subaccounts показывает субаккаунты расширенного аккаунта. Для другого аккаунта установите коннектор ещё раз с его id.

Что он читает: аккаунт с часовым поясом и языком, сведения о компании (адрес, телефон, служба поддержки), главную страницу и её статус подтверждения и заявки, проблемы аккаунта с их серьёзностью, программы (бесплатные объявления, торговые объявления, локальные объявления, checkout) с их доступностью, настройки доставки, регионы, пользователей с их правами доступа и квоты API. Обработанные товары, объединённые из всех источников данных, с атрибутами и productStatus по площадкам и странам, включая проблемы на уровне товара; количество товаров по статусам для каждого контекста отчётности и страны с самыми частыми проблемами. Источники данных (фиды) и результат последней загрузки файла. Остатки в магазинах и по регионам для каждого товара, промоакции со статусом одобрения и подписки на уведомления. Отчёты на Merchant Center Query Language: эффективность товаров (клики, показы, CTR, конверсии), статус и проблемы по товарам, конкурентоспособность цен и рекомендации по ценам (suggested_price), бестселлеры и видимость относительно конкурентов.

Что он записывает: входные данные товаров в источнике данных типа API (google_merchant_center_insert_product_input создаёт их или полностью заменяет, google_merchant_center_update_product_input меняет поля из update_mask, например product_attributes.price,product_attributes.availability), источники данных (создание, изменение, немедленная загрузка файлового фида), остатки в магазинах и по регионам (insert заменяет запись для этого магазина или региона), промоакции в источнике данных промоакций и подписки на уведомления, которые отправляют данные на HTTPS-callback при PRODUCT_STATUS_CHANGE или ACCOUNT_SERVICE_CHANGE. Товары из файловых фидов или добавленные в интерфейсе Merchant Center здесь редактировать нельзя; вместо этого переопределите их атрибуты дополнительным источником данных API. Изменения появляются в google_merchant_center_get_product через несколько минут, одобрение для объявлений и бесплатных объявлений может занять несколько дней, а каждую промоакцию проверяет Google (программа промоакций должна быть включена для страны).

Отключено при установке: google_merchant_center_delete_product_input, google_merchant_center_delete_local_inventory, google_merchant_center_delete_regional_inventory и google_merchant_center_delete_notification_subscription. Их действие нельзя отменить (удалённый товар теряет историю и статус), поэтому администратор включает их, когда они нужны команде.

Форматы данных: id товара имеет вид contentLanguage~feedLabel~offerId, например en~US~sku123; offer id, содержащие /, % или ~, передаются в виде base64url-кодировки всего id без выравнивания. Имена ресурсов представляют собой пути вида accounts/123/dataSources/456, а инструменты принимают последнюю часть как id. Суммы указаны в микроединицах: {"amountMicros": "19990000", "currencyCode": "EUR"} означает 19,99 EUR. Большие числа (микроединицы, количества, id) приходят строками JSON. Время указано в RFC 3339 в UTC; значения date в отчётах даны в часовом поясе аккаунта. Имена атрибутов записываются в camelCase (title, link, imageLink, availability, condition, gtins, brand, mpn, googleProductCategory, salePrice, shipping).

Отчёты: google_merchant_center_search_reports принимает SELECT fields FROM table WHERE ... ORDER BY ... LIMIT n с именами полей в snake_case. Условия объединяются только через AND (вместо OR используйте IN), а ORDER BY работает только по выбранным полям. product_performance_view и non_product_performance_view требуют условия по дате, например date DURING LAST_30_DAYS, и хотя бы одной метрики. Таблицам бестселлеров нужны report_granularity и report_country_code в фильтре. Строки приходят в results[], и в каждой лежит один объект с именем таблицы, например productPerformanceView.

Пагинация и лимиты: инструменты списков возвращают nextPageToken; ИИ вызывает их снова с page_token, пока он не исчезнет. google_merchant_center_list_products по умолчанию возвращает 25 товаров на страницу, максимум 1000; отчёты до 100000 строк на страницу (по умолчанию 1000). google_merchant_center_list_quotas показывает дневные и поминутные лимиты и сегодняшнее использование по группам методов. Запись товаров ограничена в день пропорционально размеру каталога: распределяйте массовые изменения во времени и предпочитайте один дополнительный фид тысячам отдельных обновлений.

Частые ошибки: 401 GCP project with id ... is not registered означает, что не выполнен шаг 6; любой другой 401 означает, что авторизация истекла или отозвана (всегда через 7 дней, пока экран согласия в статусе Testing): снова нажмите Authorize with Provider. 403 The caller does not have access to the accounts означает, что вошедший пользователь не является пользователем этого аккаунта или GOOGLE_MERCHANT_ACCOUNT_ID указан неверно; 403 Merchant API has not been used in project означает, что API не включён (шаг 1). 400 при записи товара означает, что обязательный атрибут отсутствует или написан с ошибкой либо источник данных не является источником API. 404 означает неизвестный id товара, источника данных или промоакции. 429 RESOURCE_EXHAUSTED означает, что квота исчерпана: проверьте google_merchant_center_list_quotas и повторите позже.

Коннектор не работает с заказами и возвратами, не меняет правила доставки и возврата, не создаёт аккаунты и не управляет пользователями, не читает отзывы о товарах и не управляет кампаниями Google Ads (для этого есть коннектор Google Ads).

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Muse

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Muse добавляет удалённые MCP-серверы как пользовательские коннекторы и входит в них через OAuth.

1. В Muse открой Settings → Connectors и выбери Add custom connector.
2. Вставь URL MCP-сервера https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
3. Muse откроет страницу входа AnythingMCP: войди и подтверди доступ.
4. В чате попроси Muse о том, для чего нужны инструменты Google Merchant Center.

Настроить коннектор можно и из чата: в вебе, в приложениях для iOS и Android или в WhatsApp. Отправь Muse это сообщение:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Muse подключается из облака Meta, поэтому localhost не подойдёт.

Доступные инструменты

Примеры запросов

• «Проверь состояние магазина: проблемы аккаунта и сколько товаров отклонено в каждой стране.»
• «Какие товары не допущены или отклонены, и что нужно исправить в каждом из них?»
• «Покажи 20 товаров с наибольшим числом кликов за последние 30 дней, с показами и CTR.»
• «Где моя цена выше эталонной? Перечисли товары с самой большой разницей.»
• «Поставь товару enUSsku123 статус OUT_OF_STOCK. Покажи изменение перед отправкой.»

FAQ

Где доступен Muse? Сейчас Meta предлагает Muse в США и Канаде: в вебе, в приложениях для iOS и Android и в WhatsApp.

Проверяет ли Meta этот коннектор? Нет. Meta не проверяет пользовательские коннекторы. Muse видит только те инструменты, которые ты включил для этого MCP-сервера в AnythingMCP, а отключить коннектор можно в любой момент в Settings → Connectors.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Cursor
• Подключить к Gemini
• Подключить к Microsoft Copilot