使用说明
谷歌标签管理器MCP服务器
建造于 Growthers.io --数据驱动型增长机构。
开源MCP(模型上下文协议)服务器,为人工智能代理提供对Google Tag Manager API v2的完全访问。
适用于Claude Code、Claude Desktop、Cursor和任何兼容MCP的客户端。管理帐户、容器、工作区、标签、触发器、变量、同意模式和容器版本——所有这些都可以通过您的AI助手完成。
不需要外部服务。使用您自己的Google凭据在您的计算机上本地运行。
先决条件
- Python 3.10+
- pipx (推荐)或pip
- Google Cloud项目 标签管理器API 启用
- gcloud命令行界面 用于凭据设置
设置
1.启用标签管理器API
- 首选 谷歌云控制台
- 选择或创建项目
- 首选 API和服务>启用API
- 搜索 标签管理器API 并启用它
2.身份验证
gcloud auth application-default login \
--scopes="https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/tagmanager.readonly,https://www.googleapis.com/auth/tagmanager.edit.containers,https://www.googleapis.com/auth/tagmanager.edit.containerversions"
这将在以下位置创建凭据文件 ~/.config/gcloud/application_default_credentials.json.
提示: 如果默认的gcloud客户端阻止了某些作用域,请在您的Google Cloud项目中创建一个自定义OAuth客户端ID(API和服务>凭据>创建OAuth客户端>桌面应用程序),然后使用
--client-id-file=<path-to-client-secret.json>使用上面的命令。
3.安装
选项A:带pipx(推荐)
pipx install git+https://github.com/CarC96/google-tag-manager-mcp.git
选项B:来源
git clone https://github.com/CarC96/google-tag-manager-mcp.git
cd google-tag-manager-mcp
pip install .
4.配置您的MCP客户端
添加到MCP客户端配置中(例如。 ~/.claude.json 克劳德代码):
{
"mcpServers": {
"gtm-mcp": {
"type": "stdio",
"command": "pipx",
"args": ["run", "gtm-mcp"],
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "<path-to>/application_default_credentials.json"
}
}
}
}
替换 <path-to> 带有凭据文件的实际路径(通常 ~/.config/gcloud/application_default_credentials.json).
运作原理
尽管名称为“服务器”,但它作为一个 本地进程 在你的机器上。您的MCP客户端将其作为子进程启动,并通过stdin/stdout进行通信。没有打开网络端口,也不需要云托管——它本质上是一个插件。
MCP Client (Claude Code, etc.) ←— stdin/stdout —→ gtm-mcp (local process) ——→ Google Tag Manager API
可用工具(30)
账户
| 工具 | 说明 |
|---|---|
list_accounts |
列出所有GTM帐户 |
get_account |
获取帐户详细信息 |
list_user_permissions |
列出帐户的权限 |
容器
| 工具 | 说明 |
|---|---|
list_containers |
列出帐户中的所有容器 |
get_container |
获取容器详细信息 |
get_container_snippet |
获取网站的安装代码片段 |
工作区
| 工具 | 说明 |
|---|---|
list_workspaces |
列出容器中的工作区 |
get_workspace |
获取工作区详细信息 |
get_workspace_status |
检查冲突和修改的实体 |
create_workspace |
创建新工作区 |
标签
| 工具 | 说明 |
|---|---|
list_tags |
列出所有标签 |
get_tag |
获取标签详细信息 |
create_tag |
创建新标签 |
update_tag |
更新标签 |
delete_tag |
删除标签 |
触发器
| 工具 | 说明 |
|---|---|
list_triggers |
列出所有触发器 |
get_trigger |
获取触发器详细信息 |
create_trigger |
创建新触发器 |
update_trigger |
更新触发器 |
delete_trigger |
删除触发器 |
变量
| 工具 | 说明 |
|---|---|
list_variables |
列出所有变量 |
get_variable |
获取变量详细信息 |
create_variable |
创建新变量 |
update_variable |
更新变量 |
delete_variable |
删除变量 |
内置变量
| 工具 | 说明 |
|---|---|
list_built_in_variables |
列出所有已启用的内置变量 |
版本
| 工具 | 说明 |
|---|---|
list_version_headers |
列出所有版本头(摘要) |
get_live_version |
获取所有实体的已发布版本(非常适合审计) |
get_version |
按ID获取特定版本 |
用例
- 同意模式审核 --在几秒钟内分析所有标签及其同意设置
- 批量标签管理 --以编程方式创建、更新或删除标签/触发器/变量
- GDPR合规性 --验证所有标签的同意配置
- 容器迁移 --跨容器读取和复制配置
- 文档 --自动生成GTM设置报告
关于Growthers.io
Growthers.io 是一家数据驱动的增长机构,专门从事分析、跟踪基础设施和营销自动化。我们构建的工具使数字营销更加高效和合规。
许可证
阿帕奇-2.0