谷歌标签管理器mcp
A. 模型上下文协议(MCP) 服务器 Google标签管理器API,与Claude Desktop和Claude Code一起为个人使用而构建。
以当地人的身份跑步 stdio子流程 --没有托管服务器,没有OAuth代理,没有Docker。身份验证通过浏览器流处理一次,令牌存储在本地。
建造于 马克斯 西海 源自 paolobietolini/gtm mcp服务器 (麻省理工学院)-带有OAuth代理的原始HTTP服务器被重写为基于stdio的个人使用服务器。
______________________________________________________________________
你能做什么
连接后,Claude可以通过自然语言阅读和管理您的整个GTM工作区。
50工具
读取数据
| 工具 | 说明 |
|---|---|
list_accounts | 列出所有GTM帐户 |
list_containers | 列出帐户中的容器 |
list_workspaces | 列出容器中的工作区 |
get_workspace_status | 获取工作区中的待处理更改 |
list_tags / get_tag | 列出或检查标签 |
list_triggers / get_trigger | 列出或检查触发器 |
list_variables / get_variable | 列出或检查变量 |
list_folders / get_folder_entities | 浏览文件夹内容 |
list_templates / get_template | 列出或检查自定义模板 |
list_versions | 列出容器版本 |
list_built_in_variables | 列出已启用的内置变量 |
list_clients / get_client | 列出或检查服务器端客户端 |
list_transformations / get_transformation | 列出或检查转换 |
get_tag_templates / get_trigger_templates | 获取标签/触发器的正确参数格式 |
创建和更新
| 工具 | 说明 |
|---|---|
create_tag / update_tag | 创建或更新标签 |
create_trigger / update_trigger | 创建或更新触发器 |
create_variable / update_variable | 创建或更新变量 |
create_workspace | 创建新工作区 |
create_container | 创建新容器 |
create_template / update_template | 创建或更新自定义模板 |
create_client / update_client | 创建或更新服务器端客户端 |
create_transformation / update_transformation | 创建或更新转换 |
enable_built_in_variables | 启用内置变量 |
import_gallery_template | 从社区库导入模板 |
出版
| 工具 | 说明 |
|---|---|
create_version | 创建容器版本 |
publish_version | 发布一个实时版本 |
删除 *(所有要求 confirm: true)*
| 工具 | 说明 |
|---|---|
delete_tag | 删除标签 |
delete_trigger | 删除触发器 |
delete_variable | 删除变量 |
delete_template | 删除自定义模板 |
delete_container | 删除容器 |
delete_client | 删除服务器端客户端 |
delete_transformation | 删除转换 |
disable_built_in_variables | 禁用内置变量 |
效用
| 工具 | 说明 |
|---|---|
ping | 测试服务器连接 |
auth_status | 确认身份验证已激活 |
6资源
基于URI的实时GTM数据读取访问:
gtm://accounts--所有账户gtm://accounts/{accountId}/containers--帐户中的容器gtm://accounts/{accountId}/containers/{containerId}/workspaces--工作区gtm://accounts/{accountId}/containers/{containerId}/workspaces/{workspaceId}/tags--标签gtm://accounts/{accountId}/containers/{containerId}/workspaces/{workspaceId}/triggers--触发器gtm://accounts/{accountId}/containers/{containerId}/workspaces/{workspaceId}/variables--变量
4提示
Claude可以遵循的指导性多步骤工作流程:
| 提示 | 描述 |
|---|---|
audit_container | 对容器的标签、触发器和变量进行全面审核 |
generate_tracking_plan | 根据业务目标生成跟踪计划 |
suggest_ga4_setup | 建议GA4标签/触发器/变量设置 |
find_gallery_template | 查找并导入社区图库模板 |
______________________________________________________________________
设置
先决条件
- 转到1.24+--从安装 go.dev/dl
- Google Cloud项目 标签管理器API 启用
- OAuth 2.0凭据(桌面应用程序类型)
1.克隆和构建
git clone https://github.com/VasthavM/google-tag-manager-mcp
cd google-tag-manager-mcp
go build -o google-tag-manager-mcp .2.创建Google Cloud凭据
- 首选 谷歌云控制台 → API和服务 → 启用API和服务
- 搜索 标签管理器API 并启用它
- 首选 API和服务 → 凭证 → 创建凭证 → OAuth客户端ID
- 选择 桌面应用 作为应用程序类型
- 下载JSON文件
3.保存您的凭据
mkdir -p ~/.config/google-tag-manager-mcp
cp ~/Downloads/client_secret_*.json ~/.config/google-tag-manager-mcp/credentials.json4.身份验证(一次性浏览器流)
./google-tag-manager-mcp服务器将打印一个URL。在浏览器中打开它,授予GTM访问权限,令牌将自动保存到 ~/.config/google-tag-manager-mcp/token.json。之后,服务器启动——您可以用关闭它 Ctrl+C.
令牌会自动刷新。除非您撤销访问权限,否则您不需要重复此操作。
5.用克劳德代码注册
claude mcp add --scope user google-tag-manager /path/to/google-tag-manager-mcp或为 克劳德桌面版,添加到 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)或 %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"google-tag-manager": {
"command": "/path/to/google-tag-manager-mcp"
}
}
}______________________________________________________________________
配置
| 环境变量 | 默认值 | 描述 |
|---|---|---|
GTM_MCP_CREDENTIALS | ~/.config/google-tag-manager-mcp/credentials.json | 凭据文件的路径 |
GTM_MCP_TOKEN | ~/.config/google-tag-manager-mcp/token.json | 保存令牌的路径 |
GTM_MCP_CONFIG_DIR | ~/.config/google-tag-manager-mcp/ | 覆盖配置目录 |
GTM_DEBUG | _(未设置)_ | 设置为任何值以记录HTTP请求/响应体(仅限localhost) |
______________________________________________________________________
安全
credentials.json和token.json列在.gitignore绝不能承诺- 令牌文件存储在
0600权限(仅限所有者读/写) - 所有破坏性操作(
delete_*,disable_built_in_variables,publish_version)要求明确confirm: true参数 - 所有更新操作都使用基于指纹的并发控制来防止意外覆盖
______________________________________________________________________
归因
GTM API客户端、工具处理程序、资源和提示源自 paolobietolini/gtm mcp服务器 (MIT许可证)。
这个分叉重写了传输层:带有OAuth 2.1代理(专为托管多用户部署而设计)的原始HTTP服务器被替换为stdio传输和本地OAuth2浏览器流,使其适合与Claude Desktop和Claude Code一起使用。
______________________________________________________________________
许可证
麻省理工学院——见 许可证.
