Google Tag Manager MCP

English | Русский

A1 Google Tag Manager MCP позволяет ИИ-приложению просматривать контейнеры Google Tag Manager и управлять ими на естественном языке. Смотрите, что срабатывает на странице, работайте с тегами, триггерами и переменными в черновом рабочем пространстве, а затем осознанно компилируйте и публикуйте версию, когда будете готовы.

Он подключается к Google Tag Manager API v2 через ваш Google-аккаунт. Отличие от того, чтобы просто попросить ИИ угадать настройку GTM, в том, что инструмент работает с настоящим контейнером, рабочим пространством и версией, которые вы выбрали.

• 19 инструментов. 10 операций только читают данные GTM; 4 создают черновики или изменяют встроенные переменные; 5 могут изменять, удалять, компилировать или публиковать рабочую конфигурацию.

• Сначала черновик. Теги, триггеры и переменные создаются в рабочем пространстве. Публикация — отдельная, явно разрушительная операция.

• Учёт квоты. GTM разрешает 0,25 запроса в секунду на проект; сервер отправляет запросы с интервалом не менее 4,2 секунды, не перегружая API.

• Ваш доступ к Google. Сервер использует ваши OAuth-учётные данные и запрашивает только те области доступа Tag Manager, которые нужны для чтения, редактирования, создания версий и публикации.

Начните с вопроса, доступного только для чтения:

Какие теги в моих контейнерах срабатывают по триггеру просмотра страниц?

Подключить сервер · Возможные сценарии · Открыть техническую документацию

Как это работает за минуту

Вы: Выведи список моих контейнеров GTM и покажи, какие теги срабатывают при просмотре страницы.

Ассистент: Перечисляет контейнеры, их рабочие пространства, соответствующие триггеры и привязанные к ним теги. Ничего не изменяется.

Вы: В Default Workspace контейнера GTM-ABC123 подготовь тег конфигурации GA4 для идентификатора измерения G-XXXXXXX на всех страницах.

Ассистент: Показывает рабочее пространство, предлагаемую конфигурацию тега и триггера, а затем запрашивает подтверждение перед созданием черновика.

Вы: Подтверждаю черновик.

Ассистент: Создаёт тег в рабочем пространстве. Контейнер не публикуется; компиляция и публикация версии остаются отдельным шагом.

Related MCP server: unboundai-gtm-mcp-server

Содержание

• Быстрый старт

• Что можно попросить

• Как связаны изменения GTM

• Что может измениться

• Получение доступа

• Конфигурация

• Данные и телеметрия

• Ограничения и фоновая работа

• Техническая документация

• Поддержка

Быстрый старт

Вам понадобятся Node.js 20+, Google-аккаунт с доступом к контейнеру GTM и OAuth-учётные данные из проекта Google Cloud, в котором включён Tag Manager API.

1. Подготовьте доступ через Google OAuth.

2. Добавьте сервер в своё ИИ-приложение.

3. Начните с приведённого выше вопроса, доступного только для чтения.

В приложении:

1. Откройте Settings → Plugins → MCP servers.

2. Выберите Add server.

3. Добавьте npx -y mcp-google-tagmanager@latest и три переменные окружения ниже.

Из командной строки:

codex mcp add google-tagmanager \
  --env GOOGLE_TAGMANAGER_CLIENT_ID=your_client_id \
  --env GOOGLE_TAGMANAGER_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_TAGMANAGER_REFRESH_TOKEN=your_refresh_token \
  -- npx -y mcp-google-tagmanager@latest

codex mcp list

Документация Codex MCP

claude mcp add \
  --env GOOGLE_TAGMANAGER_CLIENT_ID=your_client_id \
  --env GOOGLE_TAGMANAGER_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_TAGMANAGER_REFRESH_TOKEN=your_refresh_token \
  --transport stdio \
  --scope user \
  google-tagmanager \
  -- npx -y mcp-google-tagmanager@latest

claude mcp list

Документация Claude Code MCP

1. Откройте Settings → Developer → Edit Config.

2. Добавьте эту запись в mcpServers:

{
  "mcpServers": {
    "google-tagmanager": {
      "command": "npx",
      "args": ["-y", "mcp-google-tagmanager@latest"],
      "env": {
        "GOOGLE_TAGMANAGER_CLIENT_ID": "your_client_id",
        "GOOGLE_TAGMANAGER_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_TAGMANAGER_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

Если Edit Config недоступна, отредактируйте файл ~/Library/Application Support/Claude/claude_desktop_config.json на macOS или %APPDATA%\Claude\claude_desktop_config.json на Windows.

Документация Claude Desktop MCP

Добавьте сервер уровня пользователя в ~/.cursor/mcp.json на macOS/Linux или %USERPROFILE%\.cursor\mcp.json на Windows:

{
  "mcpServers": {
    "google-tagmanager": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-tagmanager@latest"],
      "env": {
        "GOOGLE_TAGMANAGER_CLIENT_ID": "your_client_id",
        "GOOGLE_TAGMANAGER_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_TAGMANAGER_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

Документация Cursor MCP

Выполните команду MCP: Open User Configuration из палитры команд и добавьте запись:

{
  "servers": {
    "google-tagmanager": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-tagmanager@latest"],
      "env": {
        "GOOGLE_TAGMANAGER_CLIENT_ID": "${input:gtm_client_id}",
        "GOOGLE_TAGMANAGER_CLIENT_SECRET": "${input:gtm_client_secret}",
        "GOOGLE_TAGMANAGER_REFRESH_TOKEN": "${input:gtm_refresh_token}"
      }
    }
  },
  "inputs": [
    { "type": "promptString", "id": "gtm_client_id", "description": "Google OAuth client ID" },
    { "type": "promptString", "id": "gtm_client_secret", "description": "Google OAuth client secret", "password": true },
    { "type": "promptString", "id": "gtm_refresh_token", "description": "Google OAuth refresh token", "password": true }
  ]
}

Проверьте с помощью MCP: List Servers.

Документация VS Code MCP

Что попросите сделать

Разобраться в текущей настройке

• Вывести список аккаунтов Google SE и контейнеры, к которым у меня есть доступ.

• Какие теги срабатывают при просмотре страницы в этом рабочем пространстве?

• Показать конфигурацию триггера и переменных для этого тега.

• Какие встроенные переменные включены?

Подготовить изменения в черновике

• Создать новое рабочее пространство под изменение трекинга оформления чекаута.

• Подготовить тег GA4 и триггер для конкретного события.

• Включить переменные кликов, необходимые для этого триггера.

• Обновить этот тег после показа полной конфигурации замены.

Сознательно выпускать версию

• Скомпилировать это рабочее пространство в версию April release.

• Показать ошибки компилятора, если они есть.

• Опубликовать версию 42 после подтверждения версии и её изменений.

Как связаны изменения GTM

У GTM есть понятный путь выпуска:

1. Аккаунты содержит одной из нескольких контейнеров.

2. В контейнер есть рабочие пространства для черновых изменений.

3. Теги, триггеры и переменные владельцу рабочего пространства.

4. Компиляция рабочего пространства создаёт версию контейнера и удаляет исходное рабочее пространство. GTM предоставляет новое рабочее пространство.

5. Публикация делает выбранную версию контейнера рабочей.

Данное сервис может проверять каждый шаг. Он не считает черновик готовым к выпуску: создание и публикация версии — это отдельные операции.

Что может измениться

The AI client decides how to confirm operations. The server labels read-only, writing, and destructive operations so that the client can distinguish inspection from real changes.

Obtaining access

The server uses Google OAuth 2.0. Google Tag Manager does not provide API keys for this user data.

1. Rule Google Cloud project and enable the Tag Manager API. If this API is not enabled, the project receives no quota.

2. Set up the OAuth consent screen and create an OAuth client. For local use, a Desktop app-type client is convenient.

3. authorizes the Google account and receive a refresh token. OAuth 2.0 Playground allows it if you enable Use your own OAuth credentials.

4. Ask these scopes together:

   https://www.googleapis.com/auth/tagmanager.readonly
   https://www.googleapis.com/auth/tagmanager.edit.containers
   https://www.googleapis.com/auth/tagmanager.edit.containerversions
   https://www.googleapis.com/auth/tagmanager.publish

These domains are separate: reading, editing, compiling releases and publishing each require their own permission. Consider the secret client and the refresh token as password.

Configuration

* Provide a trio of OAuth or access token. Access tokens expire in about an hour and are not automatically renewed.

Data and telemetry

The server works locally and sends a request to GTM API and OAuth refresh requests to Google. Its anonymous telemetry contains a random installation ID, package version, AI client, Node.js/OS versions, and tool names. It does not send OAuth tokens, GTM data, tool arguments, or input prompts.

Disable telemetry for A1 MCP servers.

ASKADS_TELEMETRY=0

Limits and background processing

• GTM is limited by request frequency. The API permits 0.25 requests per second per project, so the server distributes calls with an interval of at least 4.2 seconds. Therefore, scale аудит can take time.

• Temporary restrictions are handled carefully. 429 and 403 quota responses use exponential backoff and Retry-After. Films are retried after network and 5xx failures; capable writes are not re-played after an uncertain failure.

• No background monitoring. The server executes only when your AI app contacts it. Real, if the application supports scheduled tasks, it can periodically inspect a container or its live version.

• When compiling, the workspace disappears. Before calling create_version, save everything you need from the workspace and inspect the new workspace's replacement path.

Technical documentation

• Каталог возможностей MCP — страницы, ориентированные на задачи, для каждого инструмента.

• Все инструменты и входные данные

• Документация для разработчиков

• Документация по публикации

• Справочник Google Tag Manager API v2

Поддержка

Нашли ошибку или нужен сценарий? Создайте issue или напишите в Telegram.