关键词

Google Tag ManagerGTM营销自动化标签管理Web分析

项目简介

'GTM MCP 服务器' 是一个强大的后端服务，专为AI助手设计，使其能够理解并执行Google Tag Manager (GTM) 中的各项操作。通过将GTM的功能封装成标准化的工具，它允许AI助手帮助用户查询GTM数据、创建和修改GTM配置（如标签、触发器、变量），甚至发布容器版本。这极大地简化了GTM的管理和自动化，使得非技术人员也能通过自然语言轻松控制复杂的GTM配置。

主要功能点

  • GTM账户与容器管理：查询用户可访问的所有GTM账户及其下的容器。
  • 标签管理：列出、获取详细信息、创建、更新GTM工作区中的各种标签（如Google Analytics、GA4、自定义HTML等）。
  • 触发器管理：列出、创建GTM工作区中的触发器，定义标签何时触发。
  • 变量管理：列出、获取详细信息、创建GTM工作区中的变量（如常量、数据层变量、URL变量、Cookie变量等）。
  • 容器版本发布：创建并发布GTM容器的新版本，将更改部署到线上。
  • 安全认证：采用OAuth 2.0协议进行身份验证，确保安全访问用户的Google Tag Manager数据，且所有凭据和授权信息均存储在用户本地。

安装步骤

  1. Python 环境: 确保您的系统已安装 Python 3.10 或更高版本。
  2. 安装 GTM MCP 包: 打开您的终端或命令行工具，运行以下命令安装服务器： 
    pip install gtm-mcp
  3. 运行设置向导 (推荐): 
    gtm-mcp-setup
    该向导将指导您完成Google Cloud OAuth凭据的创建（约5分钟），并自动配置您的Claude Desktop客户端。
  4. 手动设置 Google Cloud OAuth 凭据 (如果选择手动):
    • 访问 Google Cloud Console，创建一个新的Google Cloud项目。
    • 在项目中启用 Tag Manager API。
    • 配置 OAuth 同意屏幕，选择“外部”用户类型，填写应用名称（如“My GTM MCP”）、用户支持邮箱和开发者联系邮箱，并将您自己添加为测试用户。
    • 创建 OAuth 客户端ID：选择“桌面应用”类型，获取“客户端ID”和“客户端密钥”，并记录您的“项目ID”。

MCP服务器配置 (供Claude Desktop等MCP客户端使用)

MCP客户端（如Claude Desktop或Claude Code）需要配置以下JSON信息来连接并使用'gtm-mcp'服务器。请将'your-client-id.apps.googleusercontent.com'、'GOCSPX-your-client-secret'和'your-project-id'替换为您在手动设置Google Cloud OAuth凭据时获取的实际值。

将以下JSON配置添加到您的Claude Desktop配置文件中（例如：'~/.config/Claude/claude_desktop_config.json' 或 '%APPDATA%\Claude\claude_desktop_config.json'）。

{
  "mcpServers": {
    "gtm-mcp": {
      "command": "gtm-mcp",
      "env": {
        "GTM_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
        "GTM_CLIENT_SECRET": "GOCSPX-your-client-secret",
        "GTM_PROJECT_ID": "your-project-id"
      }
    }
  }
}
  • "mcpServers": 这是MCP客户端配置文件中用于定义所有MCP服务器的顶级对象。
  • "gtm-mcp": 这是您为GTM MCP服务器定义的唯一名称。
  • "command": 指定启动GTM MCP服务器的命令，通常是'gtm-mcp'。
  • "env": 一个包含环境变量的JSON对象，这些变量将在启动GTM MCP服务器时传递给它。
    • "GTM_CLIENT_ID": 您在Google Cloud Console中创建的OAuth客户端ID。
    • "GTM_CLIENT_SECRET": 您在Google Cloud Console中创建的OAuth客户端密钥。
    • "GTM_PROJECT_ID": 您在Google Cloud Console中创建的项目ID。

基本使用方法

  1. 重启Claude Desktop：配置完成后，务必完全关闭并重新打开Claude Desktop。
  2. 首次授权：当您首次尝试使用GTM工具（例如，向Claude提问“列出我的GTM账户”）时，一个浏览器窗口将自动打开，引导您完成Google OAuth授权流程。按照指示登录Google账户，授权您的应用程序访问GTM。
  3. 开始交互：授权成功后，您就可以通过自然语言向Claude提问或请求执行GTM相关的任务了。例如：
    • "List my GTM accounts." (列出我的GTM账户)
    • "Show me all containers in account '12345'." (显示账户'12345'中的所有容器)
    • "Create a new GA4 tag named 'Purchase Event' in workspace 'accounts/123/containers/456/workspaces/7' that fires on custom event 'purchase'." (在工作区 'accounts/123/containers/456/workspaces/7' 中创建一个名为 'Purchase Event' 的GA4标签，并在自定义事件 'purchase' 上触发。)
    • "Publish a new version of container 'accounts/123/containers/456' with name 'Initial Setup' and notes 'First version with GA4 and enhanced conversions'." (发布容器 'accounts/123/containers/456' 的新版本，名称为 'Initial Setup'，备注为 '包含GA4和增强型转化的第一个版本'。)

信息

分类

开发者工具

访问项目