gtm-mcp

gtm-mcp 伺服器為 LLM 環境（如 Claude Code 或 Codex CLI）與 Google Tag Manager (GTM) API 之間提供了強大的橋樑。此工具專為行銷工程師、網站開發人員與資料分析師設計，無需手動操作儀表板即可進行追蹤基礎架構的程式化管理。使用者可自動化部署行銷標籤、設定觸發條件並定義動態變數，確保在複雜的網站屬性中維持一致的實作。

• 完整的 GTM 資源生命週期支援：針對標籤 (Tags)、觸發器 (Triggers) 與變數 (Variables) 執行建立、讀取、更新與刪除 (CRUD) 操作。

• 認證管理：整合 OAuth 2.0 流程以進行安全的 Google Cloud 專案存取，包含同意連結生成與權杖交換。

• 通用 API 存取：使用 gtm_request 工具與任何 GTM API v2 端點互動，為邊緣情況或未記載的 API 功能提供彈性。

• 多種註冊範圍：靈活的 MCP 設定支援本機、使用者或專案層級安裝，適用於隔離實驗與團隊共享儲存庫的工作流程。

• 資源探索工具：內建列出帳戶、容器與工作區的工具，幫助使用者在修改設定前高效導航 GTM 層級架構。

• 前置需求：需要一個已啟用 Tag Manager API 的 Google Cloud 專案與有效的 OAuth 客戶端憑證（Client ID 與 Client Secret）。

• 設定：使用互動式設定腳本產生安全的 .env 檔案；請確保重新導向 URI 設定為 http://127.0.0.1:8085 以保持 OAuth 握手一致性。

• 使用順序：請始終先使用帳戶與容器列出工具來探索資源，隨後再執行具體的資源修改請求。

• 安全性：修改容器資料的操作需要 https://www.googleapis.com/auth/tagmanager.edit.containers 權限範圍。

• 疑難排解：若在 IDE 或 CLI 中無法看到 MCP，請重新執行該特定範圍的註冊腳本；若重複項目導致無法更新，請手動清除現有設定。