Gtm MCP Server

🚀 GTM MCP Server

AIによるGoogle Tag Managerコンテナの管理を可能にします。

Claude、ChatGPT、またはGeminiとの自然な会話を通じて、タグの作成、設定の監査、トラッキングプランの生成、変更の公開などを行うことができます。

URL: https://mcp.gtmeditor.com

🚀 クイックスタート

Claude (Web & Desktop)

Claude.ai:

1. 設定 → コネクタ → カスタムコネクタの追加 へ移動します。
2. https://mcp.gtmeditor.com を入力します。
3. 追加 をクリックし、Googleアカウントでサインインします。

Claude Code (CLI):

claude mcp add -t http gtm https://mcp.gtmeditor.com

ChatGPT

1. OpenAI Apps Platform へアクセスします。
2. URL https://mcp.gtmeditor.com でMCP統合を追加します。
3. Googleアカウントで認証します。

Gemini CLI

gemini mcp add --transport http --url https://mcp.gtmeditor.com gtm

✨ 主な機能

タグ管理

任意のGTMタグタイプを作成および変更できます。

• GA4設定とイベント — 適切な測定IDでGoogle Analytics 4を設定します。
• 電子商取引トラッキング — 購入、カートへの追加、商品閲覧イベントを追跡します。
• カスタムHTML — スクリプト、ピクセル、およびカスタムコードを注入します。
• カスタム画像 — キャッシュバスティング付きのトラッキングピクセルを設定します。

トリガー管理

あらゆるシナリオに対応するトリガーを構築できます。

• ページビュー（すべてのページまたは特定のURL）
• カスタムdataLayerイベント
• クリックトラッキング
• フォーム送信
• タイマーベースのトリガー
• 複雑な条件のトリガーグループ

コンテナ操作

• アカウント、コンテナ、およびワークスペースを閲覧します。
• ワークスペースの変更からバージョンを作成します。
• バージョンを公開して運用を開始します。
• フォルダで整理します。
• 組み込み変数の有効化/無効化を行います。

サーバーサイドコンテナ

サーバーサイドのGTMコンテナを完全にサポートします。

• クライアント — サーバーサイドクライアント（例: GA4クライアント）の作成、更新、および削除を行います。
• 変換 — 許可、除外、および拡張ルールでイベントパラメータを制御します。

コミュニティテンプレートギャラリー

Googleのコミュニティテンプレートギャラリーからテンプレートをインポートできます。

• "iubendaのCookie同意テンプレートをインポートする"
• "Cookiebotをコンテナに追加する"
• "ギャラリーテンプレートを使用してFacebook Pixelを設定する"

AIがテンプレートを検索し、GitHubリポジトリを見つけて自動的にインポートします。

AI駆動のワークフロー

コンテナ監査 "コンテナの問題を監査する" — ワークスペースを分析して、以下の問題を検出します。

• 名前の不一致
• 重複するタグ
• 孤立したトリガー
• セキュリティ上の懸念
• ベストプラクティスの違反

トラッキングプラン生成 "トラッキングプランを生成する" — 以下の内容のMarkdownドキュメントを作成します。

• すべてのイベントとそのトリガー
• データレイヤーの要件
• 変数の定義
• 実装メモ

GA4設定推奨事項 "電子商取引のためにGA4を設定するのを手伝って" — 以下の推奨事項を提供します。

• 作成するタグ
• トリガーの設定
• 必要な変数
• データレイヤーの実装コード

📦 使用例

完全なトラッキングセットアップの構築

AIに依頼して、GA4の電子商取引実装を最初から作成できます。

• "私の店舗のGA4電子商取引トラッキングを設定する"
• 12以上のタグ（設定 + すべての電子商取引イベント）を作成します。
• 各dataLayerイベントに対応するトリガーを作成します。
• 商品、通貨、価値、取引IDのデータレイヤー変数を作成します。
• Googleの推奨イベント名とパラメータに従います。

同意管理の実装

OneTrustなどのプライバシーツールをトラッキングに統合できます。

• "分析の同意が与えられた場合のみGA4を起動する"
• 同意チェック変数を作成します。
• 条件付きトリガーを設定します。
• 既存のタグを更新してユーザーの選択を尊重します。

一括操作と名前の変更

大規模なコンテナを管理できます。

• "すべての電子商取引トリガーに 'ecom -' の接頭辞を追加する"
• "すべてのタグを測定ID変数を使用するように更新する"
• 会話を通じて数十の項目の名前を変更、更新、または整理します。

カスタム変数とロジック

高度なトラッキングロジックを作成できます。

• "ローカルタイムスタンプを返す変数を作成する"
• "購入タグにカスタムパラメータを追加する"
• カスタムJavaScript変数、データレイヤーマッピングなどを作成します。

エージェンシー向け

• 複数のクライアントコンテナを管理できます（デモでは7以上のアカウントが表示されます）。
• クライアント間で実装を標準化します。
• 新しいプロジェクトを迅速にセットアップします。
• バージョン管理と安全な変更の公開を行います。

🔧 技術詳細

GTM MCP Serverは、Model Context Protocol を使用してAIアシスタントをGoogle Tag Manager APIに接続します。ClaudeまたはChatGPTにGTMを管理するよう依頼すると、以下の手順が実行されます。

1. Googleアカウントで認証します（OAuth 2.1）。
2. コンテナの設定を読み取ります。
3. 要求した変更を実行します。
4. 破壊的な操作の前に確認を求めます。

あなたの資格情報は保存されません — サーバーはトークンベースの認証を使用しており、Googleアカウントからいつでも取り消すことができます。

📚 詳細ドキュメント

セキュリティ機能

• 削除と公開には確認が必要です。
• ワークスペースのみの変更 — 公開するまでは運用に反映されません。
• バージョン管理 — すべての変更は最初にバージョンを作成します。
• 監査ログ — 変更内容を追跡します。

セルフホスティング

Dockerセットアップ

git clone https://github.com/paolobietolini/gtm-mcp-server.git
cd gtm-mcp-server

# .envファイルを作成します
cat > .env << 'EOF'
GOOGLE_CLIENT_ID=your-client-id.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=your-client-secret
JWT_SECRET=$(openssl rand -base64 32)
BASE_URL=http://localhost:8080
EOF

# サーバーを起動します
docker compose up -d

# Claudeに追加します
claude mcp add -t http gtm http://localhost:8080

Docker間通信

別のコンテナが内部Dockerネットワークエイリアスを介してMCPサーバーにアクセスする必要がある場合、.env に ALLOWED_HOSTS を追加します。

ALLOWED_HOSTS=gtm-mcp:8080

これにより、信頼できる内部ホスト名の動的URL解決が可能になり、サーバーをホストヘッダーインジェクションから保護します。

Google Cloudセットアップ

1. Google Cloud Console にアクセスします。
2. Tag Manager API を有効にします。
3. OAuth 2.0認証情報（Webアプリケーション）を作成します。
4. リダイレクトURIを追加します。

   https://claude.ai/api/mcp/auth_callback
   https://claude.com/api/mcp/auth_callback
   https://chatgpt.com/connector_platform_oauth_redirect
   https://your-domain.com/oauth/callback
   

利用可能なツール

読み取り操作

ユーティリティ

書き込み操作

サーバーサイドコンテナツール

公開

テンプレート

リソースとプロンプト

リソース（URIベースのアクセス）

構造化されたURIを介してGTMデータにアクセスできます。

gtm://accounts
gtm://accounts/{id}/containers
gtm://accounts/{id}/containers/{id}/workspaces
gtm://accounts/.../workspaces/{id}/tags
gtm://accounts/.../workspaces/{id}/triggers
gtm://accounts/.../workspaces/{id}/variables

プロンプト（ワークフローテンプレート）

より良いAIコンテキスト

最適な結果を得るために、GTM APIスキル をインストールすると、AIアシスタントがGTMのAPI構造、パラメータ形式、および検証ルールを理解できるようになります。

Claude Code

# ワンライナーでインストール
curl -sL https://github.com/paolobietolini/gtm-api-for-llms/archive/main.tar.gz | tar xz && \
  mkdir -p ~/.claude/skills && \
  cp -r gtm-api-for-llms-main/skills/gtm-api ~/.claude/skills/ && \
  rm -rf gtm-api-for-llms-main

または、クローンしてコピーすることもできます。

git clone https://github.com/paolobietolini/gtm-api-for-llms.git
cp -r gtm-api-for-llms/skills/gtm-api ~/.claude/skills/

OpenAI Codex

curl -sL https://github.com/paolobietolini/gtm-api-for-llms/archive/main.tar.gz | tar xz && \
  mkdir -p ~/.codex/skills && \
  cp -r gtm-api-for-llms-main/skills/gtm-api ~/.codex/skills/ && \
  rm -rf gtm-api-for-llms-main

スキルに含まれる内容

GTM API for LLMs リポジトリは、LLMに最適化されたドキュメントを提供します。リクエストテンプレート、検証ルール、ワークフローアルゴリズム、およびサーバーサイドコンテナを含むすべてのGTMエンティティタイプの完全なスキーマが含まれています。

アーキテクチャ

• プロトコル: HTTP上のModel Context Protocol (MCP)
• 認証: PKCE付きのOAuth 2.1
• 標準: RFC 8414、RFC 7591、RFC 9728

既知の問題

🐛 autoEventFilter がGoogle Tag Manager APIによって無視される

APIを介して linkClick、click、または formSubmission トリガーを作成または更新する際、autoEventFilter フィールド（"一部のリンククリック"/"一部のフォーム送信"条件に使用）がGoogle Tag Manager APIによって無視されます。APIは新しいフィンガープリントで 200 OK を返しますが、autoEventFilter は保存されません。

HTTPレベルのデバッグにより、リクエストボディに正しいJSONが送信されていることが確認されていますが、Googleのレスポンスにはこのフィールドが含まれていません。filter および customEventFilter フィールドは正常に機能します。

回避策: GTMウェブインターフェイス を通じて autoEventFilter 条件を手動で設定してください。MCPサーバーは、UIを介して autoEventFilter が設定されたトリガーを読み取ることができます。

ステータス: #33

リンク

• GitHubリポジトリ
• GTM APIリファレンス
• MCP仕様

作者

Paolo Bietolini

mcp@paolobietolini.com

📄 ライセンス

BSD-3-Clause