Google Tag Manager 用 MCP

Tag Manager 専用の MCP コネクタ。「Gustavo google ads- mcp」と同じ基準で構築されています。各アクションはアカウント / コンテナ / ワークスペース（またはバージョン）を明示的に要求します — 暗黙的なものは一切ありません — そして本番環境に影響を与えるアクション（タグの一時停止、バージョンの公開）には confirm=true が必要です。これは以前の「Chrome を開いて画面を読む」というアプローチを置き換えるもので、Web インターフェースではなく型付けされた API に依存していたため、パネルの中で最も不安定なタブでした。

コスト: Tag Manager API は無料です（通常の使用で Google からの課金はありません）。これは「Gustavo google ads- mcp」と同じく、Render の無料 Web Service として 2 つ目にデプロイされます — 同じプラン、同じコスト（ゼロ）で、すでに今日お使いのものと同じです。

認証情報の整理方法（標準化されたパターン）

このサーバーは本番環境では token.json ファイルを使用しません — 他の Render 上のコネクタと同じく、環境変数を使用します:

• GOOGLE_ADS_CLIENT_ID / GOOGLE_ADS_CLIENT_SECRET — 再利用します。「Gustavo google ads- mcp」がすでに使用しているのと同じ OAuth クライアントです。ツールごとに新しいクライアントを作成する必要はありません。

• GTM_REFRESH_TOKEN — 唯一の新しい値で、Tag Manager 固有のものです。

将来、Tag Manager 専用の別の OAuth クライアントを希望する場合は、GTM_CLIENT_ID / GTM_CLIENT_SECRET を定義でき、これらは Google Ads のものより優先されます。

Related MCP server: Samarth GTM MCP Server

1. コードを GitHub にアップロード

1. リポジトリは作成済み: github.com/gustavomkt/mcp-tagmanager（公開）。

2. このフォルダのすべてのファイルをアップロードします。ただし client_secret.json、token.json、.flow_state.json は除きます（これらはローカルテスト専用です。決してアップロードしてはいけません — .gitignore がすでに除外しています）。

2. Render にデプロイ

1. Render → New → Web Service → mcp-tagmanager リポジトリを接続。

2. Runtime: Docker（Dockerfile を自動検出）。

3. Plan: Free。

4. Environment Variables（Render のダッシュボードでご自身で追加してください — 認証情報のため、私が代わりに入力することはできません）:

   • GOOGLE_ADS_CLIENT_ID = Google Ads サービスで既にお持ちの値と同じもの。

   • GOOGLE_ADS_CLIENT_SECRET = Google Ads サービスで既にお持ちの値と同じもの。

   • GTM_REFRESH_TOKEN = Tag Manager 用にすでに生成したリフレッシュトークン（チャットで別途共有しました）。

5. Create Web Service。ビルドが完了したら、公開 URL をコピーします（例: https://mcp-tagmanager.onrender.com）。

3. Claude に接続

新しいリモート MCP コネクタとして追加し、前の手順の Render URL を指定します（末尾に /mcp を付けます。例: https://mcp-tagmanager.onrender.com/mcp — これは標準の streamable-http エンドポイントです）。接続できたら、お知らせください。コントロールパネルの Tag Manager タブを更新して、ブラウザベースの手順の代わりにこれらの実際のツールを使用するようにします。

代替案: ファイルを使ったローカル実行（Render なし）

Render ではなくラップトップで実行したい場合は:

pip install -r requirements.txt
python auth_setup.py   # una vez, abre tu navegador
python server.py       # sin PORT definido, corre por stdio

server.py は最初に環境変数の GTM_REFRESH_TOKEN + client_id/secret を探します。見つからない場合は、token.json にフォールバックします。

利用可能なツール

読み取り（何も変更しません）:

• list_accounts()

• list_containers(account_id)

• list_workspaces(account_id, container_id)

• list_tags(account_id, container_id, workspace_id)

• get_tag(account_id, container_id, workspace_id, tag_id)

• list_triggers(account_id, container_id, workspace_id)

• list_variables(account_id, container_id, workspace_id)

• audit_workspace(account_id, container_id, workspace_id) — トリガーなしのタグ、タグなしのトリガー、重複の可能性、Consent Mode が設定されているかどうか。以前 Chrome 内の Claude に「画面を読んで推測する」よう依頼していたことの信頼できるバージョンです。

• list_versions(account_id, container_id)

書き込み（confirm=true が必要）:

• pause_tag(...) / resume_tag(...) — ワークスペース内のタグを一時停止または再開します。コンテナは公開しません。

• create_version(...) — ワークスペースからバージョンを作成します。公開はしません。

• publish_version(account_id, container_id, version_id, confirm=true) — バージョンを公開します（本番環境に反映されます）。ロールバックにも使用できます: list_versions から以前のバージョンの version_id を渡してください。

安定性に関するメモ

• Google API への各呼び出しはエラーハンドリングでラップされており、MCP 接続を説明なしに落とす代わりに、明確なメッセージ（{"ok": false, "error": "..."}）を返します — その種のサイレント障害は、他のコネクタが警告なしに「落ちる」理由の一部でした。

• トークンは各呼び出しでリフレッシュトークンを使用して自動的に更新されます。将来失効した場合（パスワード変更、myaccount.google.com での手動失効）、エラーが明示的に表示され、新しい GTM_REFRESH_TOKEN を生成するだけで済みます。

• Render の無料 Web Service であるため、しばらく使用しないと「スリープ」し、その後の最初の呼び出しは応答に約 50 秒かかります — 今日の「Gustavo google ads- mcp」と同じです。コネクタが「落ちた」ように見える最も可能性の高い原因です: エラーではなく、無料プランのコールドスタートです。この遅延をなくしたい場合は、Render の有料プランしか方法がありません — あなたの判断です。私があなたの依頼なしに変更することはありません。