内容
# 🚀 NotSet GTM MCP 服务器（社区版）
[](https://pkg.go.dev/github.com/notset-es/gtm-mcp-community)
[](https://opensource.org/licenses/MIT)
**NotSet GTM MCP 服务器**是一款模型上下文协议（MCP）网关，为您的 AI 代理（Cursor、Claude Desktop、Windsurf）提供超级权限级别的访问 **Google Tag Manager**。
无需点击 50 个菜单来审计 dataLayer 或配置标签。让您的 AI 代理直接通过代码读取、写入、审计和编排跟踪部署。
---
## ⚡ 快速开始（零配置）
我们为您完成了繁琐的设置工作，您可以立即连接您喜欢的 AI 代理：
### 选项 A：本地 STDIO（Cursor、Windsurf、Claude CLI）
在您的 IDE 中使用我们的 Node 包装器添加一个新的 MCP 服务器。我们通过 STDIO 安全地处理 OAuth 路由。
```json
{
"mcpServers": {
"gtm-community": {
"command": "npx",
"args": ["-y", "@notset/gtm-mcp-community"]
}
}
}
```
### 选项 B：远程 SSE（Cloud AI、Glama、ChatGPT）
如果您的 AI 在浏览器中运行或通过云 SSE 运行，只需指向我们的端点。
```text
https://gtm-mcp.notset.es/sse
```
## 🔑 身份验证
NotSet GTM MCP 服务器自动处理身份验证。
- **选项 A（NPX 包装器）：** 它将在第一次运行期间在您的浏览器中启动安全的 Google OAuth 流。
- **选项 B（源代码/自行托管）：** 它原生支持 `GOOGLE_APPLICATION_CREDENTIALS` 环境变量，如果您更喜欢为您的代理使用严格的服务帐户。
---
## 🛡️ 社区版 vs 企业版专业版（您需要哪一个？）
社区版永久免费且开源。它包含 **完整的 GTM CRUD 功能**，并使用临时/易失性内存。当您的 AI 守护程序重新启动时，您的会话将断开以保持您的工作站安全。
如果您是严重的数据代理机构、企业或只是某个讨厌重新身份验证的人，并且需要高级审计，您可能需要 **企业专业版**，具有 **静息状态下的零信任加密**、**持久会话** 和 **跨审计**。
| 功能 | 社区版 | ✨ 企业专业版 |
| --- | --- | --- |
| **GTM 功能** | 标准 CRUD | ✅ 完全访问 + 蓝图/SDR 和迁移 |
| **GA4 功能** | ❌ 无 | ✅ 完全访问 |
| **GTM ↔ GA4 跨审计** | ❌ 无 | ✅ 自动差距分析和孤立检测 |
| **属性复制** | ❌ 无 | ✅ 1-点击克隆 GA4 配置 |
| **连接方式** | 本地 STDIO 和云 SSE | 本地、云和 M2M 代理 |
| **安全令牌存储** | ❌ 临时易失性 | ✅ 静息状态下的零信任（AES-256-GCM） |
| **代理自主性** | 适合临时任务 | 不间断的 24/7 背景 CRON |
| **多层治理** | ❌ 无 | ✅ 集中式仪表板（团队管理） |
| **高级审计** | ❌ 基本 CRUD | ✅ 旅程模拟、同意验证、PII 检测 |
| **浏览器执行** | ❌ 无 | ✅ 高级隐身云浏览器和本地 CDP |
**👉 对企业专业版感兴趣？**
请直接联系我：[raul@measuremesh.io](mailto:raul@measuremesh.io) 或 [raul.fernandez@notset.es](mailto:raul.fernandez@notset.es)，讨论您的需求。
---
## 🎯 AI 示例提示
连接后，尝试询问您的代理：
- *"审计我的 GTM 工作区 `WS_ID`，并告诉我是否有任何标签缺少触发器。"*
- *"创建一个新的自定义 HTML 标签，该标签在所有页面上触发，包含一个简单的 console.log。"*
- *"从查找变量 `VAR_ID` 中提取所有 RegEx 模式，并将它们格式化为表格。"*
- *"删除工作区 `WS_ID`。是的，我确认此操作。"*
---
## 🏎️ 从源代码构建（适用于 Gophers）
您很谨慎吗？很好，您应该这样做。以下是您自己构建服务器的方法，而不是信任我们的 NPX 包装器：
```bash
git clone https://github.com/notset-es/gtm-mcp-community
cd gtm-mcp-community
go mod tidy
go build -o gtm-mcp main.go
# 在_stdio 模式下本地运行（允许带上您的服务帐户！）
./gtm-mcp -stdio
```
## 🧠 功能（工具参考）
此服务器作为单个网关（`gtm` 工具）运行，以避免超出 MCP 令牌限制。操作是部分更新。
| 资源 | 支持的操作 |
| --- | --- |
| `workspace` | list, create, status, delete |
| `tag` | list, get, create, update, delete, revert, append_list_entry, remove_list_entry, list_entries |
| `variable` | list, get, create, update, delete, revert, add_lookup_entry, remove_lookup_entry, list_lookup_entries, append_list_entry, remove_list_entry, list_entries |
| `trigger` | list, get, create, update, delete, revert |
| `folder` | list, get, create, update, delete, move, audit, revert |
| `template` | list, get, create, update, delete, import, revert |
| `version` | list, get, create, publish, compare, export, import |
| `gtag_config` | list, get, create, update, delete |
> **注意：** 社区模板标签使用特定的数字 ID。由于高级元数据发现（`templates_ref`）是专业版功能，您可能需要为您的代理提供确切的模板 ID，以便在创建自定义标签时使用。
---
## 🤝 贡献
发现了一个错误？想要包装另一个 Google API？欢迎提交 PR。只是不要破坏 `auth` 中间件；我们喜欢我们的秘密被保密。
## 📄 许可证
MIT 许可证 - 有关详细信息，请参见 [LICENSE](LICENSE) 文件。不提供任何保证。
