GTM MCP Server

Сервер Model Context Protocol (MCP) для Google Tag Manager с использованием аутентификации через сервисный аккаунт — без процедуры OAuth.

Возможности

• OAuth не требуется — для аутентификации используется сервисный аккаунт Google

• Покрывает основной рабочий процесс GTM — аккаунты, контейнеры, рабочие области, теги, триггеры, переменные, встроенные переменные и версии (29 инструментов)

• Локальный и приватный — работает полностью на вашем компьютере

• Совместим с Claude Desktop, Cursor и другими MCP-клиентами

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

1. Создайте сервисный аккаунт Google Cloud

1. Перейдите в Google Cloud Console

2. Выберите или создайте проект

3. Включите Tag Manager API:

   • Перейдите в APIs & Services → Library

   • Найдите "Tag Manager API"

   • Нажмите Enable

4. Создайте сервисный аккаунт:

   • Перейдите в IAM & Admin → Service Accounts

   • Нажмите "Create Service Account"

   • Дайте ему имя (например, "gtm-mcp-server")

   • Нажмите Create and Continue (пропустите необязательные разрешения)

   • Нажмите Done

5. Создайте ключ:

   • Нажмите на ваш новый сервисный аккаунт

   • Перейдите на вкладку Keys

   • Add Key → Create new key → JSON

   • Сохраните загруженный JSON-файл в безопасном месте (например, ~/.config/gtm-service-account.json)

2. Предоставьте доступ к GTM сервисному аккаунту

1. Перейдите в Google Tag Manager

2. Нажмите Admin (значок шестерёнки)

3. В разделе Account нажмите "User Management"

4. Нажмите кнопку +, чтобы добавить пользователя

5. Введите email сервисного аккаунта (выглядит как name@project-id.iam.gserviceaccount.com)

6. Установите соответствующие разрешения:

   • Read — только для просмотра/перечисления

   • Edit — для создания/изменения тегов, триггеров, переменных

   • Publish — для публикации версий

   • Admin — полный доступ, включая управление пользователями

3. Настройте ваш MCP-клиент

Claude Desktop

Добавьте в конфигурацию Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json на Mac, %APPDATA%\Claude\claude_desktop_config.json на Windows):

{
  "mcpServers": {
    "gtm": {
      "command": "npx",
      "args": ["-y", "gtm-mcp-server"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/your/service-account.json"
      }
    }
  }
}

Cursor

Добавьте в настройки MCP в Cursor:

{
  "mcpServers": {
    "gtm": {
      "command": "npx",
      "args": ["-y", "gtm-mcp-server"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/your/service-account.json"
      }
    }
  }
}

4. Перезапустите клиент

После сохранения конфигурации перезапустите ваш MCP-клиент. Вы должны увидеть доступные инструменты GTM.

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

Управление аккаунтами

• gtm_list_accounts — список всех доступных аккаунтов GTM

Управление контейнерами

• gtm_list_containers — список контейнеров в аккаунте

• gtm_get_container — получение сведений о контейнере

Управление рабочими областями

• gtm_list_workspaces — список рабочих областей в контейнере

• gtm_create_workspace — создание новой рабочей области

• gtm_get_workspace_status — отображение ожидающих изменений и конфликтов слияния в рабочей области

• gtm_sync_workspace — синхронизация рабочей области с последней версией контейнера

Управление тегами

• gtm_list_tags — список всех тегов в рабочей области

• gtm_get_tag — получение полных сведений о теге с параметрами

• gtm_create_tag — создание нового тега

• gtm_update_tag — обновление существующего тега

• gtm_delete_tag — удаление тега

Управление триггерами

• gtm_list_triggers — список всех триггеров в рабочей области

• gtm_get_trigger — получение полных сведений о триггере

• gtm_create_trigger — создание нового триггера

• gtm_update_trigger — обновление существующего триггера

• gtm_delete_trigger — удаление триггера

Управление переменными

• gtm_list_variables — список всех переменных в рабочей области

• gtm_get_variable — получение полных сведений о переменной

• gtm_create_variable — создание новой переменной

• gtm_update_variable — обновление существующей переменной

• gtm_delete_variable — удаление переменной

Управление встроенными переменными

• gtm_list_built_in_variables — список включённых встроенных переменных

• gtm_enable_built_in_variables — включение встроенных переменных (например, Page URL, Click Classes)

• gtm_disable_built_in_variables — отключение встроенных переменных

Управление версиями

• gtm_list_versions — список версий контейнера

• gtm_get_live_version — получение текущей опубликованной версии

• gtm_create_version — создание версии из рабочей области

• gtm_publish_version — публикация версии, чтобы сделать её активной

Все инструменты для вывода списков возвращают результаты по одной странице за раз; если есть дополнительные результаты, ответ содержит page_token, который нужно передать в следующий вызов.

Примеры использования

После настройки вы можете задавать Claude такие вопросы, как:

• "Список моих аккаунтов GTM"

• "Покажи все контейнеры в аккаунте 123456"

• "Какие теги есть в моём контейнере для сайта?"

• "Создай новый триггер просмотра страницы под названием 'All Pages'"

• "Создай пользовательский HTML-тег, который срабатывает на всех страницах"

• "Создай версию и опубликуй её"

Устранение неполадок

"GOOGLE_APPLICATION_CREDENTIALS not set"

Убедитесь, что переменная окружения задана в конфигурации вашего MCP-клиента и указывает на действительный JSON-файл ключа.

Ошибки "Permission denied"

• Проверьте, что email сервисного аккаунта добавлен в ваш аккаунт GTM

• Убедитесь, что уровень разрешений достаточен для выполнения операции

Ошибки "API not enabled"

Убедитесь, что Tag Manager API включён в вашем проекте Google Cloud.

Сервер не отображается в Claude Desktop

• Проверьте, что пути в вашей конфигурации указаны верно

• Просмотрите журналы MCP в Claude Desktop на предмет ошибок

• Попробуйте запустить npx gtm-mcp-server напрямую, чтобы увидеть сообщения об ошибках

Разработка

# Clone the repository
git clone https://github.com/alexstansfield/gtm-mcp-server.git
cd gtm-mcp-server

# Install dependencies
npm install

# Build
npm run build

# Watch mode for development
npm run dev

# Test with MCP Inspector
npx @modelcontextprotocol/inspector node dist/index.js

Лицензия

MIT