Google Tag Manager MCP

English | Русский

A1 Google Tag Manager MCP を使用すると、AI アプリが平易な言葉で Google Tag Manager コンテナを調査・管理できます。ページ上で何が発火するかを確認し、ドラフトワークスペースでタグ、トリガー、変数を操作し、準備ができたら意図的にバージョンをコンパイルして公開できます。

Google アカウントを通じて Google Tag Manager API v2 に接続します。AI に GTM 構成を推測させるのとは異なり、選択した実際のコンテナ、ワークスペース、バージョンに対して動作します。

• 19 のツール。 10 の操作は GTM データの読み取りのみ、4 つはドラフトの作成または組み込み変数の変更、5 つは本番設定の変更、削除、コンパイル、公開を行います。

• ドラフト優先。 タグ、トリガー、変数はワークスペース内で作成されます。公開は別の、明示的に破壊的な操作です。

• クォータ対応。 GTM はプロジェクトごとに 1 秒あたり 0.25 リクエストを許可しています。サーバーは API を圧迫せず、リクエスト間隔を少なくとも 4.2 秒確保します。

• あなたの Google アクセス。 サーバーはあなたの OAuth 認証情報を使用し、読み取り、編集、バージョン管理、公開に必要な Tag Manager スコープのみをリクエストします。

読み取り専用の質問から始めましょう。

私のコンテナ内のどのタグがページビュートリガーで発火しますか？

サーバーに接続 · ユースケースを確認 · 技術ドキュメントを開く

1 分で動作を確認

あなた: 私の GTM コンテナを一覧表示し、ページビューで発火するタグを表示してください。

アシスタント: コンテナ、そのワークスペース、関連するトリガー、それらに接続されたタグを一覧表示します。何も変更しません。

あなた: GTM-ABC123 のデフォルトワークスペースで、全ページの測定 ID G-XXXXXXX 用の GA4 設定タグを準備してください。

アシスタント: ワークスペース、提案されたタグとトリガー構成を表示し、ドラフト作成前に確認を求めます。

あなた: ドラフトを確認します。

アシスタント: ワークスペース内にタグを作成します。コンテナは公開しません。バージョンのコンパイルと公開は別のステップです。

Related MCP server: unboundai-gtm-mcp-server

目次

• クイックスタート

• 依頼できること

• GTM の変更がどのように接続されるか

• 変更できるもの

• アクセス権の取得

• 設定

• データとテレメトリ

• 制限とバックグラウンド処理

• 技術ドキュメント

• サポート

クイックスタート

Node.js 20+、GTM コンテナにアクセスできる Google アカウント、および Tag Manager API が有効になっている Google Cloud プロジェクトの OAuth 認証情報が必要です。

1. Google OAuth アクセスを準備します。

2. AI アプリにサーバーを追加します。

3. 上記の読み取り専用の質問から始めます。

アプリ内:

1. 設定 → プラグイン → MCP サーバーを開きます。

2. サーバーを追加を選択します。

3. 以下の 3 つの環境変数とともに npx -y mcp-google-tagmanager@latest を追加します。

コマンドラインから:

codex mcp add google-tagmanager \
  --env GOOGLE_TAGMANAGER_CLIENT_ID=your_client_id \
  --env GOOGLE_TAGMANAGER_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_TAGMANAGER_REFRESH_TOKEN=your_refresh_token \
  -- npx -y mcp-google-tagmanager@latest

codex mcp list

Codex MCP ドキュメント

claude mcp add \
  --env GOOGLE_TAGMANAGER_CLIENT_ID=your_client_id \
  --env GOOGLE_TAGMANAGER_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_TAGMANAGER_REFRESH_TOKEN=your_refresh_token \
  --transport stdio \
  --scope user \
  google-tagmanager \
  -- npx -y mcp-google-tagmanager@latest

claude mcp list

Claude Code MCP ドキュメント

1. 設定 → 開発者 → 設定を編集を開きます。

2. このエントリを mcpServers に追加します。

{
  "mcpServers": {
    "google-tagmanager": {
      "command": "npx",
      "args": ["-y", "mcp-google-tagmanager@latest"],
      "env": {
        "GOOGLE_TAGMANAGER_CLIENT_ID": "your_client_id",
        "GOOGLE_TAGMANAGER_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_TAGMANAGER_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

設定を編集 が利用できない場合は、macOS では ~/Library/Application Support/Claude/claude_desktop_config.json、Windows では %APPDATA%\Claude\claude_desktop_config.json を編集します。

Claude Desktop MCP ドキュメント

macOS/Linux では ~/.cursor/mcp.json、Windows では %USERPROFILE%\.cursor\mcp.json にユーザーレベルのサーバーを追加します:

{
  "mcpServers": {
    "google-tagmanager": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-tagmanager@latest"],
      "env": {
        "GOOGLE_TAGMANAGER_CLIENT_ID": "your_client_id",
        "GOOGLE_TAGMANAGER_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_TAGMANAGER_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

Cursoor MCP ドキュメント

コマンドパレットから MCP: ユーザー設定を開く を実行して追加します:

{
  "servers": {
    "google-tagmanager": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-tagmanager@latest"],
      "env": {
        "GOOGLE_TAGMANAGER_CLIENT_ID": "${input:gtm_client_id}",
        "GOOGLE_TAGMANAGER_CLIENT_SECRET": "${input:gtm_client_secret}",
        "GOOGLE_TAGMANAGER_REFRESH_TOKEN": "${input:gtm_refresh_token}"
      }
    }
  },
  "inputs": [
    { "type": "promptString", "id": "gtm_client_id", "description": "Google OAuth client ID" },
    { "type": "promptString", "id": "gtm_client_secret", "description": "Google OAuth client secret", "password": true },
    { "type": "promptString", "id": "gtm_refresh_token", "description": "Google OAuth refresh token", "password": true }
  ]
}

MCP: サーバー一覧 で確認します。

VS Code MCP ドキュメント

依頼できること

現在の設定を把握する

• アクセスできる GTM アカウントとコンテナを一覧表示します。

• このワークスペースではどのタグがページビューで発火しますか？

• このタグのトリガーと変数の構成を表示します。

• どの組み込み変数が有効になっていますか？

ドラフトでトラッキング変更を準備する

• チェックアウトトラッキング変更用のワークスペースを作成します。

• 特定のイベント用の GA4 タグとトリガーを準備します。

• このトリガーに必要なクリック変数を有効にします。

• 完全な置き換え構成を表示した上で、このタグを更新します。

意図的にバージョンをリリースする

• このワークスペースを April release という名前のバージョンにコンパイルします。

• コンパイラエラーがあれば表示します。

• バージョンとその変更内容を確認した後、バージョン 42 を公開します。

GTM の変更がどのように接続されるか

GTM には明確なリリースパスがあります。

1. アカウントには 1 つ以上のコンテナが含まれます。

2. コンテナにはドラフト変更用のワークスペースがあります。

3. タグ、トリガー、変数はワークスペースに属します。

4. ワークスペースをコンパイルするとコンテナバージョンが作成され、元のワークスペースは削除されます。GTM は代替ワークスペースを提供します。

5. 公開すると、選択したコンテナバージョンが本番に反映されます。

このサーバーは各ステップを検査できます。ドラフトをリリースとは見なさず、バージョン作成と公開は別々の操作です。

変更できるもの

AI クライアントは確認の求め方を決定します。サーバーは読み取り専用、書き込み、破壊的操作をマークし、クライアントが調査と実際の変更を区別できるようにします。

アクセス権の取得

サーバーは Google OAuth 2.0 を使用します。Google Tag Manager はこのユーザーデータ用の API キーを提供しません。

1. Google Cloud プロジェクトを作成または選択し、Tag Manager API を有効にします。この API が有効でないプロジェクトにはクォータが割り当てられません。

2. OAuth 同意画面を設定し、OAuth クライアントを作成します。ローカルでの使用には デスクトップアプリ クライアントが適しています。

3. Google アカウントを承認し、リフレッシュトークンを取得します。OAuth 2.0 Playground で 独自の OAuth 認証情報を使用 を有効にすると、これを行うことができます。

4. 次のスコープをまとめてリクエストします。

   https://www.googleapis.com/auth/tagmanager.readonly
   https://www.googleapis.com/auth/tagmanager.edit.containers
   https://www.googleapis.com/auth/tagmanager.edit.containerversions
   https://www.googleapis.com/auth/tagmanager.publish

スコープはそれぞれ独立しています。読み取り、編集、バージョンのコンパイル、公開には、それぞれ対応する権限が必要です。クライアントシークレットとリフレッシュトークンはパスワードと同じように扱ってください。

設定

* OAuth 3 点セットまたはアクセストークンのいずれかを指定します。アクセストークンは約 1 時間で有効期限が切れ、自動的には更新されません。

データとテレメトリ

サーバーはローカルで実行され、GTM API リクエストと OAuth 更新リクエストを Google に送信します。匿名テレメトリには、ランダムなインストール ID、パッケージバージョン、AI クライアント、Node.js/オペレーティングシステムのバージョン、ツール名が含まれます。OAuth トークン、GTM データ、ツール引数、プロンプトは送信されません。

A1 MCP サーバーのテレメトリを無効にするには:

ASKADS_TELEMETRY=0

制限とバックグラウンド処理

• GTM はレート制限があります。 API はプロジェクトごとに 1 秒あたり 0.25 リクエストしか許可しないため、サーバーは呼び出しを少なくとも 4.2 秒間隔で直列化します。そのため、広範囲の監査には時間がかかる場合があります。

• 一時的な制限は慎重に再試行されます。 429 と Google のクォータ 403 応答には指数バックオフと Retry-After を使用します。読み取りはネットワークおよび 5xx 障害の後に再試行されます。書き込みは不確実な障害の後に再実行されません。

• バックグラウンド監視はありません。 サーバーは AI アプリが呼び出したときだけ実行されます。アプリがスケジュールタスクをサポートしている場合は、コンテナまたはその本番バージョンを定期的に検査できます。

• ワークスペースはコンパイル時に削除されます。 create_version を呼び出す前に、ワークスペースから必要なものを保存し、返された置き換えワークスペースのパスを確認してください。

技術ドキュメント

• MCP 機能カタログ — すべてのツール向けのタスク指向ページ。

• すべてのツールと入力

• 開発ドキュメント

• 公開ドキュメント

• Google Tag Manager API v2 リファレンス

サポート

バグを見つけましたか、またはシナリオが必要ですか？ Issue を作成 するか、Telegram でご連絡ください。