GTM MCP Server

Google Tag Manager 用の Model Context Protocol (MCP) サーバーです。サービスアカウント認証を使用するため、OAuth の手間は不要です。

特徴

• OAuth 不要 - Google サービスアカウントを使用して認証

• GTM の主要ワークフローを網羅 - アカウント、コンテナ、ワークスペース、タグ、トリガー、変数、組み込み変数、バージョン（29 ツール）

• ローカル＆プライベート - すべてお使いのマシン上で動作

• Claude Desktop、Cursor、その他の MCP クライアントに対応

クイックスタート

1. Google Cloud サービスアカウントを作成する

1. Google Cloud Console に移動します

2. プロジェクトを選択または作成します

3. Tag Manager API を有効にします:

   • [API とサービス] → [ライブラリ] に移動

   • 「Tag Manager API」を検索

   • [有効にする] をクリック

4. サービスアカウントを作成します:

   • [IAM と管理] → [サービス アカウント] に移動

   • [サービス アカウントを作成] をクリック

   • 名前を付けます（例: "gtm-mcp-server"）

   • [作成して続行] をクリック（オプションの権限はスキップ）

   • [完了] をクリック

5. キーを作成します:

   • 新しいサービスアカウントをクリック

   • [キー] タブに移動

   • [鍵を追加] → [新しい鍵を作成] → JSON

   • ダウンロードした JSON ファイルを安全な場所に保存します（例: ~/.config/gtm-service-account.json）

2. サービスアカウントに GTM アクセスを付与する

1. Google Tag Manager に移動します

2. [管理]（歯車アイコン）をクリック

3. アカウントの下で [ユーザー管理] をクリック

4. [+] ボタンをクリックしてユーザーを追加

5. サービスアカウントのメールアドレスを入力します（name@project-id.iam.gserviceaccount.com のような形式）

6. 適切な権限を設定します:

   • 閲覧 - 一覧表示・閲覧のみ

   • 編集 - タグ、トリガー、変数の作成・変更

   • 公開 - バージョンの公開

   • 管理 - ユーザー管理を含むフルアクセス

3. MCP クライアントを設定する

Claude Desktop

Claude Desktop の設定ファイルに追加します（Mac では ~/Library/Application Support/Claude/claude_desktop_config.json、Windows では %APPDATA%\Claude\claude_desktop_config.json）:

{
  "mcpServers": {
    "gtm": {
      "command": "npx",
      "args": ["-y", "gtm-mcp-server"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/your/service-account.json"
      }
    }
  }
}

Cursor

Cursor の MCP 設定に追加します:

{
  "mcpServers": {
    "gtm": {
      "command": "npx",
      "args": ["-y", "gtm-mcp-server"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/your/service-account.json"
      }
    }
  }
}

4. クライアントを再起動する

設定を保存したら、MCP クライアントを再起動します。GTM ツールが利用可能になるはずです。

利用可能なツール

アカウント管理

• gtm_list_accounts - アクセス可能なすべての GTM アカウントを一覧表示

コンテナ管理

• gtm_list_containers - アカウント内のコンテナを一覧表示

• gtm_get_container - コンテナの詳細を取得

ワークスペース管理

• gtm_list_workspaces - コンテナ内のワークスペースを一覧表示

• gtm_create_workspace - 新しいワークスペースを作成

• gtm_get_workspace_status - ワークスペース内の保留中の変更とマージ競合を表示

• gtm_sync_workspace - ワークスペースを最新のコンテナバージョンに同期

タグ管理

• gtm_list_tags - ワークスペース内のすべてのタグを一覧表示

• gtm_get_tag - パラメータを含むタグの完全な詳細を取得

• gtm_create_tag - 新しいタグを作成

• gtm_update_tag - 既存のタグを更新

• gtm_delete_tag - タグを削除

トリガー管理

• gtm_list_triggers - ワークスペース内のすべてのトリガーを一覧表示

• gtm_get_trigger - トリガーの完全な詳細を取得

• gtm_create_trigger - 新しいトリガーを作成

• gtm_update_trigger - 既存のトリガーを更新

• gtm_delete_trigger - トリガーを削除

変数管理

• gtm_list_variables - ワークスペース内のすべての変数を一覧表示

• gtm_get_variable - 変数の完全な詳細を取得

• gtm_create_variable - 新しい変数を作成

• gtm_update_variable - 既存の変数を更新

• gtm_delete_variable - 変数を削除

組み込み変数管理

• gtm_list_built_in_variables - 有効な組み込み変数を一覧表示

• gtm_enable_built_in_variables - 組み込み変数を有効にする（例: ページ URL、クリック クラス）

• gtm_disable_built_in_variables - 組み込み変数を無効にする

バージョン管理

• gtm_list_versions - コンテナのバージョンを一覧表示

• gtm_get_live_version - 現在公開中のバージョンを取得

• gtm_create_version - ワークスペースからバージョンを作成

• gtm_publish_version - バージョンを公開して公開状態にする

すべての一覧ツールは結果を 1 ページずつ返します。さらに結果がある場合、レスポンスには次の呼び出しに渡す page_token が含まれます。

使用例

設定後、Claude に次のような質問ができます:

• "GTM アカウントを一覧表示して"

• "アカウント 123456 のすべてのコンテナを表示して"

• "ウェブサイトのコンテナにはどのようなタグがありますか？"

• "「すべてのページ」という名前の新しいページビュートリガーを作成して"

• "すべてのページで発火するカスタム HTML タグを作成して"

• "バージョンを作成して公開して"

トラブルシューティング

"GOOGLE_APPLICATION_CREDENTIALS not set"

環境変数が MCP クライアント設定で設定され、有効な JSON キーファイルを指していることを確認してください。

"Permission denied" エラー

• サービスアカウントのメールアドレスが GTM アカウントに追加されていることを確認

• 操作に十分な権限レベルがあることを確認

"API not enabled" エラー

Google Cloud プロジェクトで Tag Manager API が有効になっていることを確認してください。

Claude Desktop にサーバーが表示されない

• 設定内のパスが正しいことを確認

• Claude Desktop の MCP ログでエラーを確認

• npx gtm-mcp-server を直接実行してエラーメッセージを確認

開発

# Clone the repository
git clone https://github.com/alexstansfield/gtm-mcp-server.git
cd gtm-mcp-server

# Install dependencies
npm install

# Build
npm run build

# Watch mode for development
npm run dev

# Test with MCP Inspector
npx @modelcontextprotocol/inspector node dist/index.js

ライセンス

MIT