MCP Server for Google Tag Manager

托管服务，自定义连接器（推荐）。

1. 前往 Customize → Connectors → Add custom connector。对于 Team 和 Enterprise 计划，Owner 应改为前往 Organization settings → Connectors → Add → Custom 添加，然后每位成员再在 Customize → Connectors 下选择该连接器上的 Connect，并使用自己的 Google 账号登录。
2. 设置名称（例如 gtm-mcp-server）和 URL：https://gtm-mcp.stape.io/mcp。如果对话框询问如何进行身份验证，请选择 Sign in now；如果询问 OAuth 客户端，请选择 Register automatically（服务端不支持 Use Claude's published identity）。
3. 选择 Add，然后选择 Connect，并使用 Google 账号登录。

该连接器也可在 claude.ai 上使用。

托管服务，mcp-remote。 要通过 claude_desktop_config.json（Settings → Developer → Edit Config）进行配置，请改为：

{
  "mcpServers": {
    "gtm-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gtm-mcp.stape.io/mcp"
      ]
    }
  }
}

本地 CLI — 不需要 OAuth 流程，不会通过他人的服务传输数据，你需要提供服务账号密钥或刷新令牌。打开 Settings → Developer → Edit Config 并添加：

{
  "mcpServers": {
    "gtm-mcp-server": {
      "command": "npx",
      "args": ["-y", "google-tag-manager-mcp-server"],
      "env": {
        "GOOGLE_SERVICE_ACCOUNT_KEY": "{\"type\":\"service_account\", ... }"
      }
    }
  }
}

请参阅 CLI README，了解所有凭据选项。

Claude Code 原生支持 HTTP，包括 OAuth 握手，因此托管服务无需桥接。

托管服务：

claude mcp add --transport http gtm-mcp-server https://gtm-mcp.stape.io/mcp

然后在 Claude Code 中运行 /mcp（或在 shell 中运行 claude mcp login gtm-mcp-server），并使用 Google 账号登录。运行 claude mcp list 可查看是否已连接。

本地 CLI：

claude mcp add gtm-mcp-server -e GOOGLE_SERVICE_ACCOUNT_KEY='{"type":"service_account", ... }' -- npx -y google-tag-manager-mcp-server

两种方式都会仅将服务添加到当前项目。添加 --scope user 可在每个项目中使用。--scope project 会将其写入项目的 .mcp.json，适用于托管服务（其中不包含机密信息，每位队友都使用自己的 Google 账号登录），但不适用于本地 CLI，其配置项包含你的凭据。

VS Code 的 MCP 客户端原生支持 HTTP 服务及其 OAuth 流程，无需使用 mcp-remote。将以下内容添加到 .vscode/mcp.json（此工作区），或添加到 MCP: Open User Configuration 打开的文件中（所有工作区）：

托管服务：

{
  "servers": {
    "gtm-mcp-server": {
      "type": "http",
      "url": "https://gtm-mcp.stape.io/mcp"
    }
  }
}

服务首次启动时，VS Code 会提示你使用 Google 账号登录。

本地 CLI：

{
  "servers": {
    "gtm-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "google-tag-manager-mcp-server"],
      "env": {
        "GOOGLE_SERVICE_ACCOUNT_KEY": "{\"type\":\"service_account\", ... }"
      }
    }
  }
}

VS Code 中的 GitHub Copilot Chat 使用 VS Code 自带的 MCP 客户端，因此会读取相同的 MCP 配置 — 请参阅上文的 VS Code。无需单独配置。

托管服务 — Copilot CLI 可原生为远程 HTTP 服务完成 OAuth 流程：

copilot mcp add --transport http gtm-mcp-server https://gtm-mcp.stape.io/mcp

Copilot CLI 提示时，使用 Google 账号登录。

本地 CLI：

copilot mcp add --env GOOGLE_SERVICE_ACCOUNT_KEY='{"type":"service_account", ... }' gtm-mcp-server -- npx -y google-tag-manager-mcp-server

两种方式都会将服务配置项写入 ~/.copilot/mcp-config.json。运行 copilot mcp get gtm-mcp-server 进行检查。在交互式会话中，/mcp add 可通过表单完成相同操作。更多信息请参阅 GitHub 的文档。

Cursor 原生支持 HTTP，包括 OAuth 流程，无需使用 mcp-remote。将以下内容添加到 .cursor/mcp.json（此项目）或 ~/.cursor/mcp.json（所有项目）：

托管服务：

{
  "mcpServers": {
    "gtm-mcp-server": {
      "url": "https://gtm-mcp.stape.io/mcp"
    }
  }
}

然后在 Cursor 侧边栏 Customize 下的服务配置项中，使用 Google 账号登录。

本地 CLI：

{
  "mcpServers": {
    "gtm-mcp-server": {
      "command": "npx",
      "args": ["-y", "google-tag-manager-mcp-server"],
      "env": {
        "GOOGLE_SERVICE_ACCOUNT_KEY": "{\"type\":\"service_account\", ... }"
      }
    }
  }
}

Antigravity 对远程 HTTP 服务的 OAuth 支持目前还无法将令牌发送到服务端（antigravity-cli#25），因此这里请使用 mcp-remote 连接托管服务。将以下内容添加到 ~/.gemini/config/mcp_config.json。Antigravity 编辑器和 CLI 共用此配置文件。在编辑器中，可通过 Agent 面板中的 … → MCP 服务 → 管理 MCP 服务 → 查看原始配置 打开：

托管服务：

{
  "mcpServers": {
    "gtm-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gtm-mcp.stape.io/mcp"
      ]
    }
  }
}

本地 CLI：

{
  "mcpServers": {
    "gtm-mcp-server": {
      "command": "npx",
      "args": ["-y", "google-tag-manager-mcp-server"],
      "env": {
        "GOOGLE_SERVICE_ACCOUNT_KEY": "{\"type\":\"service_account\", ... }"
      }
    }
  }
}

或者，在 Antigravity CLI 中运行以下任一命令（agy mcp add 会替换同名条目）：

托管服务：

agy mcp add gtm-mcp-server -- npx -y mcp-remote https://gtm-mcp.stape.io/mcp

本地 CLI：

agy mcp add --env GOOGLE_SERVICE_ACCOUNT_KEY='{"type":"service_account", ... }' gtm-mcp-server -- npx -y google-tag-manager-mcp-server

mcp-remote 首次连接时，会在浏览器中打开 Google 登录页面。

1. 在网页端 ChatGPT 中，前往 插件，选择 +，然后选择 添加自定义 MCP 服务。
2. 输入名称（例如 gtm-mcp-server），并在 连接 下将服务 URL 设为 https://gtm-mcp.stape.io/mcp。
3. 将身份验证设为 OAuth。该服务支持动态客户端注册，因此无需客户端 ID 或密钥。
4. 确认风险警告（我了解并希望继续），然后选择 创建为插件。
5. 从个人插件中安装该插件，使用 Google 登录，然后在提示词框中输入 @ 并选择它。

ChatGPT 只能访问公共互联网中的服务，因此这里没有本地 CLI 选项，只能使用托管服务。工作区管理员可以限制自定义 MCP 服务。详情请参阅 OpenAI 文档。

如果你的客户端支持使用 OAuth 的远程 HTTP MCP 服务，请像 Cursor 配置示例那样，将其指向 https://gtm-mcp.stape.io/mcp。否则，请使用 mcp-remote 连接托管服务：

{
  "mcpServers": {
    "gtm-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gtm-mcp.stape.io/mcp"
      ]
    }
  }
}

或者，使用你的凭据直接运行本地 CLI：

{
  "mcpServers": {
    "gtm-mcp-server": {
      "command": "npx",
      "args": ["-y", "google-tag-manager-mcp-server"],
      "env": {
        "GOOGLE_SERVICE_ACCOUNT_KEY": "{\"type\":\"service_account\", ... }"
      }
    }
  }
}