gtm-mcp

gtm-mcp 服务器为 LLM 环境（如 Claude Code 或 Codex CLI）与 Google Tag Manager (GTM) API 之间提供了强大的桥梁。此工具专为营销工程师、网站开发人员与数据分析师设计，无需手动操作仪表板即可进行追踪基础架构的程序化管理。用户可自动化部署营销标签、设定触发条件并定义动态变量，确保在复杂的网站属性中维持一致的实现。

• 完整的 GTM 资源生命周期支持：针对标签 (Tags)、触发器 (Triggers) 与变量 (Variables) 执行创建、读取、更新与删除 (CRUD) 操作。

• 认证管理：整合 OAuth 2.0 流程以进行安全的 Google Cloud 项目访问，包含同意链接生成与令牌交换。

• 通用 API 访问：使用 gtm_request 工具与任何 GTM API v2 端点互动，为边缘情况或未记载的 API 功能提供弹性。

• 多种注册范围：灵活的 MCP 设置支持本地、用户或项目级别安装，适用于隔离实验与团队共享存储库的工作流程。

• 资源探索工具：内置列出账户、容器与工作区的工具，帮助用户在修改设置前高效导航 GTM 层级架构。

• 前置需求：需要一个已启用 Tag Manager API 的 Google Cloud 项目与有效的 OAuth 客户端凭证（Client ID 与 Client Secret）。

• 设置：使用交互式设置脚本生成安全的 .env 文件；请确保重定向 URI 设置为 http://127.0.0.1:8085 以保持 OAuth 握手一致性。

• 使用顺序：请始终先使用账户与容器列出工具来探索资源，随后再执行具体的资源修改请求。

• 安全性：修改容器数据的操作需要 https://www.googleapis.com/auth/tagmanager.edit.containers 权限范围。

• 疑难排解：若在 IDE 或 CLI 中无法看到 MCP，请重新执行该特定范围的注册脚本；若重复项目导致无法更新，请手动清除现有设置。