Gtm MCP

🚀 GTM MCP Server

このModel Context Protocol (MCP)サーバーは、ClaudeがGoogle Tag Managerとやり取りできるようにします。

🚀 クイックスタート

前提条件

• Python 3.10以上
• Claude Desktop（またはCursorのようなMCP互換クライアント）
• Google Tag ManagerにアクセスできるGoogleアカウント

✨ 主な機能

• GTMアカウントとコンテナの一覧表示
• タグ、トリガー、変数の管理
• コンテナバージョンの作成と公開
• 完全なワークスペース管理

📦 インストール

パート1: パッケージのインストール

pip install gtm-mcp

PyPiを参照してください。

パート2: Google Cloud OAuth認証情報の作成

ステップ1: Google Cloudプロジェクトの作成

1. Google Cloud Consoleにアクセスします。
2. 左上のプロジェクトドロップダウンをクリックします。
3. "新しいプロジェクト" をクリックします。
4. プロジェクト名（例: "My GTM MCP Server"）を入力します。
5. "作成" をクリックします。
6. プロジェクトが作成されるのを待ち、選択します。

ステップ2: Tag Manager APIの有効化

1. プロジェクト内で、"APIとサービス" → "ライブラリ" に移動します。
2. "Tag Manager API" を検索します。
3. クリックして、"有効化" をクリックします。
4. 有効化されるのを待ちます（1分程度かかる場合があります）。

ステップ3: OAuth同意画面の設定

1. "APIとサービス" → "OAuth同意画面" に移動します。
2. （Google Workspaceを持っていない場合は）"外部" を選択します。
3. "作成" をクリックします。
4. 必要なフィールドを入力します。
   • アプリ名: My GTM MCP（または好きな名前）
   • ユーザーサポートメール: あなたのメールアドレス
   • 開発者連絡先メール: あなたのメールアドレス
5. "保存して次へ" をクリックします。
6. "更新" をクリックしてから "保存して次へ" をクリックします。
7. あなたのメールアドレスを テストユーザー として追加します。
8. "保存して次へ" をクリックします。

ステップ4: OAuth認証情報の作成

1. "APIとサービス" → "認証情報" に移動します。
2. "認証情報を作成" → "OAuthクライアントID" をクリックします。
3. アプリケーションの種類として "デスクトップアプリ" を選択します。
4. 名前を入力します: "GTM MCP Desktop Client"
5. "作成" をクリックします。
6. 重要: 認証情報が表示されるダイアログが表示されます - まだ閉じないでください。

ステップ5: 認証情報の保存

表示されたダイアログから:

1. クライアントID（例: 123456789-abc123.apps.googleusercontent.com）をコピーします。
2. クライアントシークレット（例: GOCSPX-...）をコピーします。
3. Google Cloud Consoleの上部バーで、プロジェクト名の横にある プロジェクトID を確認します。
4. これらを安全な場所に保存します - 次のステップで必要になります。

JSONファイルをダウンロードすることもできますが、上記の3つの値だけが必要です。

パート3: Claude Desktopの設定

Claude Desktopの設定ファイルを編集します。

• Linux: ~/.config/Claude/claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Claude Code ~/.claude.json

認証情報を追加します。

{
  "mcpServers": {
    "gtm-mcp": {
      "command": "gtm-mcp",
      "env": {
        "GTM_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
        "GTM_CLIENT_SECRET": "GOCSPX-your-client-secret",
        "GTM_PROJECT_ID": "your-project-id"
      }
    }
  }
}

値を置き換えてください - パート2、ステップ5で取得した実際の認証情報を使用します。

注意: 他のMCPサーバーが設定されている場合は、既存の "mcpServers" オブジェクトに "gtm-mcp" エントリを追加してください。

パート4: 再起動と認可

1. Claude Desktopを完全に再起動します（閉じて再開します）。

2. ClaudeにGTMツールを使用するように依頼します（例: "List my GTM accounts"）。

3. 初回認可 - ブラウザウィンドウが自動的に開きます。

   • Googleアカウントでサインインします。
   • "Googleがこのアプリを検証していません" という警告が表示されます。
   • "詳細" → "[あなたのアプリ名] (安全ではない) に移動" をクリックします。
   • これは安全です。なぜなら あなたがアプリを自分で作成したからです。
   • 要求されたパーミッションを付与します。
   • "The authentication flow has completed" と表示されます。
   • Claude Desktopに戻ります。

4. 認可情報はローカルに保存されます - 再度この手順を行う必要はありません！

💻 使用例

基本的な使用法

ClaudeにGTMツールを使用するように依頼するだけです。例えば、"List my GTM accounts" と依頼します。

📚 ドキュメント

利用可能なツール

設定が完了すると、Claudeは以下のGTMツールにアクセスできます。

認証の仕組み

このMCPサーバーは、Google Tag Managerに安全にアクセスするために OAuth 2.0 を使用します。

1. あなたが自分のGoogle CloudプロジェクトでOAuth認証情報を作成します。
2. Claude Desktopでそれらの認証情報を設定します。
3. 初回使用時: ブラウザが開き、GTMアカウントへのアクセスを承認します。
4. あなたのトークン は、将来使用するためにローカルマシンに保存されます (~/.gtm-mcp-token.json)。

なぜ自分自身のOAuth認証情報が必要なのか？

セキュリティとプライバシーのためです。

• ✅ OAuthアプリを完全にコントロールできます。
• ✅ ユーザー間で認証情報が共有されません。
• ✅ いつでもアクセスを取り消すことができます。
• ✅ あなたの認証情報はプライベートに保たれます。
• ✅ GoogleのOAuthポリシーに準拠しています。

アップグレード

pip install --upgrade gtm-mcp

トラブルシューティング

"Missing required OAuth credentials" エラー

問題: MCPサーバーがあなたの認証情報を見つけることができません。 解決策: 以下を確認してください。

• claude_desktop_config.json（または ~/.claude.json）で環境変数を正しく設定していること。
• 設定ファイルを編集した後にClaude Desktopを再起動したこと。
• 正しい形式を使用していること（JSON内に余分な引用符がないこと）。
• 設定ファイルが有効なJSONであること（不確かな場合はJSONバリデーターを使用してください）。

"Google hasn't verified this app" 警告

問題: 初回認証時にGoogleがセキュリティ警告を表示します。 解決策: これは個人用のOAuthアプリにとっては 完全に正常です。あなたがOAuthアプリを自分で作成したため、Googleがこの警告を表示します。

進むには: "詳細" → "[アプリ名] (安全ではない) に移動" をクリックします。

これは安全です。なぜなら あなたがアプリをコントロールしているからです。

GTMアカウントにアクセスできない

考えられる原因:

• あなたのGoogleアカウントがGTMアカウントにアクセスできない。
• 認証時に要求されたすべてのパーミッションを付与していない。
• Google CloudプロジェクトでTag Manager APIが有効になっていない。

解決策:

1. あなたのGoogleアカウントがGTMにアクセスできることを確認します。
2. ~/.gtm-mcp-token.json を削除して、再度認証を試みます。
3. Google Cloud ConsoleでTag Manager APIが有効になっていることを確認します。

接続エラー

デバッグ手順:

1. Claude Desktopが完全に再起動されたことを確認します。
2. Claude DesktopのログでMCPサーバーのエラーを確認します。
3. gtm-mcp コマンドが機能することを確認します: ターミナルで gtm-mcp を実行します。
4. 設定ファイルが有効なJSONであることを確認します。
5. すべての3つの環境変数が正しく設定されていることを確認します。

インストール後にパッケージが見つからない

問題: インストール後に gtm-mcp コマンドが見つかりません。 解決策:

# pip installの場所がPATHに含まれていることを確認する
pip install --user gtm-mcp

# または、isolatedインストールにpipxを使用する
pipx install gtm-mcp

アクセスの取り消し

GTMアカウントへのアクセスを取り消すには:

1. Googleアカウントのパーミッションにアクセスします。
2. リストからあなたのアプリ名を見つけます。
3. "アクセスを削除" をクリックします。
4. ローカルのトークンファイルを削除します: rm ~/.gtm-mcp-token.json

いつでもClaudeでGTMツールを使用することで、再度認証することができます。

🔧 技術詳細

テストの実行

pip install -e ".[dev]"
pytest

📄 ライセンス

詳細については、LICENSE ファイルを参照してください。

🤝 コントリビューション

コントリビューションは歓迎されます！以下の手順を実行してください。

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更を加えます。
4. プルリクエストを送信します。

バグや機能要求については、issueを作成 してください。

🆘 ヘルプの取得

問題が発生した場合は:

1. 上記の トラブルシューティング セクションを確認します。
2. Claude Desktopのログでエラーメッセージを確認します。
3. あなたのGoogle CloudプロジェクトでTag Manager APIが有効になっていることを確認します。
4. 設定ファイルで環境変数が正しく設定されていることを確認します。
5. GitHubで issueを作成 してください。
   • あなたのオペレーティングシステム
   • Pythonのバージョン (python --version)
   • Claude Desktopのログからのエラーメッセージ
   • 問題を再現する手順