Google Tag Manager MCP

Google Tag Manager MCP

English | Русский

A1 Google Tag Manager MCP 让 AI 应用能够通过自然语言检查和管理 Google Tag Manager 容器。查看页面上触发了哪些内容，在草稿工作区中处理代码、触发器和变量，并在准备就绪后有意地编译和发布版本。

它通过你的 Google 账号连接到 Google Tag Manager API v2。与让 AI 猜测 GTM 配置不同，它操作的是你选择的实际容器、工作区和版本。

• 25 个工具。 10 项操作只读取 GTM 数据；4 项操作会创建草稿或更改内置变量；5 项操作可能更改、删除、编译或发布线上配置。
• 在对话中连接。 说“连接 Google Tag Manager”：服务会引导你配置 OAuth 客户端，通过 PKCE 在 127.0.0.1 接收 Google 的重定向，并自行保存令牌——无需配置文件，也无需重启。
• 先创建草稿。 代码、触发器和变量都在工作区中创建。发布是独立且明确的破坏性操作。
• 考虑配额限制。 GTM 每个项目每秒允许 0.25 次请求；服务会将请求间隔至少设为 4.2 秒，避免给 API 造成过大压力。
• 使用你的 Google 访问权限。 服务使用你的 OAuth 凭据，并且只请求读取、编辑、版本管理和发布所需的 Tag Manager 权限范围。

从只读问题开始：

我的容器中，哪些代码会在网页浏览触发器上触发？

连接服务 · 探索使用场景 · 查看技术文档

一分钟了解它的工作方式

你： 列出我的 GTM 容器，并显示哪些代码会在网页浏览时触发。

助手： 列出容器、对应的工作区、相关触发器以及关联的代码。不会进行任何更改。

你： 在 GTM-ABC123 的 Default Workspace 中，为所有页面准备一个测量 ID 为 G-XXXXXXX 的 GA4 配置代码。

助手： 显示工作区、拟议的代码和触发器配置，然后在创建草稿前请求确认。

你： 确认草稿。

助手： 在工作区中创建代码。它不会发布容器；编译和发布版本仍是单独的步骤。

目录

• 快速开始
• 你可以让它做什么
• GTM 更改的执行方式
• 可以更改的内容
• 获取访问权限
• 配置
• 数据和遥测
• 限制和后台工作
• 技术文档
• 支持

快速入门

你需要 Node.js 20+ 和一个 Google 账号。安装时无需凭据——服务会在对话过程中连接。

1. 将服务添加到你的 AI 应用。
2. 说“连接 Google Tag Manager”：助手会引导你创建 OAuth 客户端并批准访问，无需编辑配置文件。
3. 从上面的只读问题开始。

codex mcp add google-tagmanager \
  -- npx -y mcp-google-tagmanager@latest

codex mcp list

claude mcp add \
  --transport stdio \
  --scope user \
  google-tagmanager \
  -- npx -y mcp-google-tagmanager@latest

claude mcp list

{
  "mcpServers": {
    "google-tagmanager": {
      "command": "npx",
      "args": ["-y", "mcp-google-tagmanager@latest"]
    }
  }
}

{
  "mcpServers": {
    "google-tagmanager": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-tagmanager@latest"]
    }
  }
}

{
  "servers": {
    "google-tagmanager": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-tagmanager@latest"]
    }
  }
}

你可以让它做什么

了解当前设置

• 列出我可以访问的 GTM 账号和容器。
• 此工作区中哪些标签会在页面浏览时触发？
• 显示此标签的触发器和变量配置。
• 启用了哪些内置变量？

在草稿中准备跟踪变更

• 为结账跟踪变更创建一个工作区。
• 为特定事件准备一个 GA4 标签和触发器。
• 启用此触发器所需的点击变量。
• 在向我展示完整的替换配置后更新此标签。

有计划地发布版本

• 将此工作区编译为名为 April release 的版本。
• 显示编译错误（如果有）。
• 在我确认版本及其变更后发布版本 42。

GTM 变更的关联方式

GTM 有清晰的发布流程：

1. 一个账号包含一个或多个容器。
2. 容器拥有用于草稿变更的工作区。
3. 标签、触发器和变量属于某个工作区。
4. 编译工作区会创建一个容器版本并移除源工作区。GTM 会提供一个替代工作区。
5. 发布操作会使选定的容器版本正式生效。

此服务可以检查每个步骤。它不会将草稿视为正式发布：创建版本和发布是两个独立操作。

可执行的更改

AI 客户端决定如何请求确认。服务会标记只读、写入和具有破坏性的操作，以便客户端区分查看与实际更改。

获取访问权限

Google Tag Manager 需要 OAuth 2.0；仅有 API 密钥并不足够。有两种接入方式，第一种无需配置文件。

在聊天中连接（推荐）

说“连接 Google Tag Manager”，助手就会与你一起完成流程：

1. setup_instructions 会显示检查清单：创建或选择 Google Cloud 项目、启用 Tag Manager API、配置同意屏幕并创建 Desktop app OAuth 客户端。
2. 下载该客户端的 JSON（“Download JSON”），并将其路径提供给助手——set_client 会以仅所有者可访问的权限保存它。密钥不会经过对话传递。
3. start_login 会返回 Google 授权链接。在此设备上打开链接并批准；授权码会返回到 127.0.0.1 上的一次性监听器（PKCE），不会经过聊天传递。
4. finish_login 会交换授权码，并将令牌保存到 ~/.config/mcp-google-tagmanager/credentials.json（模式为 0600），然后通过实际的 Tag Manager API 调用验证令牌——因此，如果 API 仍处于关闭状态，会立即发现。

每次调用时都会重新读取令牌，因此连接会立即生效——无需重启 AI 应用。auth_status 会显示已连接的信息，logout 会撤销连接并删除令牌。

环境变量（CI、无人值守安装）

1. 创建或选择 Google Cloud 项目，并启用 Tag Manager API。未启用该 API 的项目不会获得配额。

2. 配置 OAuth 同意屏幕并创建 OAuth 客户端。Desktop app 客户端适用于本地使用。

3. 授权你的 Google 账号并获取刷新令牌。如果启用 Use your own OAuth credentials，OAuth 2.0 Playground 可以完成此操作。

4. 同时请求以下范围：

   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
   

这些范围各不相同：读取、编辑、编译版本和发布分别需要对应的权限。请将客户端密钥和刷新令牌视为密码。

配置

所有变量都是可选的——即使不设置任何变量，服务也会从聊天中连接。

* 提供 OAuth 三项参数或访问令牌即可。访问令牌约一小时后过期，且不会自动刷新。

数据和遥测

该服务在本地运行，并向 Google 发送 GTM API 请求和 OAuth 刷新请求。其匿名遥测数据包含随机安装 ID、软件包版本、AI 客户端以及 Node.js/操作系统版本和工具名称。它不会发送 OAuth 令牌、GTM 数据、工具参数或提示词。

使用以下设置可为 A1 MCP 服务停用遥测：

ASKADS_TELEMETRY=0

限制和后台工作

• GTM 有速率限制。 API 对每个项目每秒允许 0.25 个请求，因此该服务会将调用串行化，间隔至少为 4.2 秒。因此，范围较广的审计可能需要一些时间。
• 临时限制会谨慎重试。 对于 429 和 Google 配额 403 响应，会使用指数退避和 Retry-After。网络故障和 5xx 故障后会重试读取操作；发生结果不确定的故障后不会重放写入操作。
• 没有后台监控。 只有当你的 AI 应用调用该服务时，它才会运行。如果应用支持计划任务，则可定期检查容器或其实时版本。
• 编译后工作区会消失。 调用 create_version 前，请保存工作区中需要保留的内容，并检查返回的替代工作区路径。

技术文档

• MCP 功能目录 — 每个工具对应的任务导向页面。
• 所有工具和输入
• 开发文档
• 发布文档
• Google Tag Manager API v2 参考

支持

发现 Bug 或需要处理某种场景？创建 Issue 或在 Telegram 上留言。

你已经读到了最后！