Google Tag Manager MCP

English | Русский

A1 Google Tag Manager MCP를 사용하면 AI 앱이 자연어로 Google Tag Manager 컨테이너를 검사하고 관리할 수 있습니다. 페이지에서 무엇이 실행되는지 확인하고, 초안 작업공간에서 태그, 트리거, 변수를 작업한 다음, 준비가 되면 버전을 의도적으로 컴파일하고 게시할 수 있습니다.

이 서버는 Google 계정을 통해 Google Tag Manager API v2에 연결합니다. AI에게 GTM 구성을 추측하도록 요청하는 것과 달리, 사용자가 선택한 실제 컨테이너, 작업공간, 버전을 대상으로 작동합니다.

• 19가지 도구. 10개 작업은 GTM 데이터를 읽기만 하고, 4개는 초안을 만들거나 기본 제공 변수를 변경하며, 5개는 라이브 구성을 변경, 삭제, 컴파일 또는 게시할 수 있습니다.

• 초안 우선. 태그, 트리거, 변수는 작업공간에서 생성됩니다. 게시는 별도의 명시적 파괴적 작업입니다.

• 할당량 인식. GTM은 프로젝트당 초당 0.25개의 요청을 허용하므로, 서버는 API에 과부하를 주는 대신 요청 간격을 최소 4.2초로 유지합니다.

• 사용자의 Google 액세스. 서버는 사용자의 OAuth 자격 증명을 사용하며 읽기, 편집, 버전 관리, 게시에 필요한 Tag Manager 범위만 요청합니다.

읽기 전용 질문부터 시작하세요:

내 컨테이너에서 어떤 태그가 페이지뷰 트리거에서 실행되나요?

서버 연결 · 사용 사례 살펴보기 · 기술 문서 열기

1분 만에 작동 확인하기

사용자: 내 GTM 컨테이너를 나열하고 페이지뷰에서 실행되는 태그를 보여줘.

어시스턴트: 컨테이너, 해당 작업공간, 관련 트리거 및 연결된 태그를 나열합니다. 아무것도 변경되지 않습니다.

사용자: GTM-ABC123의 Default Workspace에서 모든 페이지에 대한 측정 ID G-XXXXXXX용 GA4 구성 태그를 준비해 줘.

어시스턴트: 작업공간, 제안된 태그 및 트리거 구성을 보여준 다음 초안을 만들기 전에 확인을 요청합니다.

사용자: 초안을 확인할게.

어시스턴트: 작업공간에 태그를 생성합니다. 컨테이너를 게시하지는 않으며, 버전 컴파일과 게시는 별도의 단계로 남아 있습니다.

Related MCP server: unboundai-gtm-mcp-server

목차

• 빠른 시작

• 요청할 수 있는 작업

• GTM 변경사항이 연결되는 방식

• 변경할 수 있는 것

• 액세스 권한 얻기

• 구성

• 데이터 및 원격 분석

• 제한 사항 및 백그라운드 작업

• 기술 문서

• 지원

빠른 시작

Node.js 20+, GTM 컨테이너에 액세스할 수 있는 Google 계정, Tag Manager API가 활성화된 Google Cloud 프로젝트의 OAuth 자격 증명이 필요합니다.

1. Google OAuth 액세스 준비.

2. AI 앱에 서버를 추가합니다.

3. 위의 읽기 전용 질문으로 시작합니다.

앱에서:

1. Settings → Plugins → MCP servers를 엽니다.

2. Add server를 선택합니다.

3. 아래의 세 환경 변수와 함께 npx -y mcp-google-tagmanager@latest를 추가합니다.

명령줄에서:

codex mcp add google-tagmanager \
  --env GOOGLE_TAGMANAGER_CLIENT_ID=your_client_id \
  --env GOOGLE_TAGMANAGER_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_TAGMANAGER_REFRESH_TOKEN=your_refresh_token \
  -- npx -y mcp-google-tagmanager@latest

codex mcp list

Codex MCP 문서

claude mcp add \
  --env GOOGLE_TAGMANAGER_CLIENT_ID=your_client_id \
  --env GOOGLE_TAGMANAGER_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_TAGMANAGER_REFRESH_TOKEN=your_refresh_token \
  --transport stdio \
  --scope user \
  google-tagmanager \
  -- npx -y mcp-google-tagmanager@latest

claude mcp list

Claude Code MCP 문서

1. Settings → Developer → Edit Config를 엽니다.

2. mcpServers에 다음 항목을 추가합니다:

{
  "mcpServers": {
    "google-tagmanager": {
      "command": "npx",
      "args": ["-y", "mcp-google-tagmanager@latest"],
      "env": {
        "GOOGLE_TAGMANAGER_CLIENT_ID": "your_client_id",
        "GOOGLE_TAGMANAGER_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_TAGMANAGER_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

Edit Config를 사용할 수 없으면 macOS에서는 ~/Library/Application Support/Claude/claude_desktop_config.json, Windows에서는 %APPDATA%\Claude\claude_desktop_config.json을 편집합니다.

Claude Desktop MCP 문서

macOS/Linux에서는 ~/.cursor/mcp.json, Windows에서는 %USERPROFILE%\.cursor\mcp.json에 사용자 수준 서버를 추가합니다:

{
  "mcpServers": {
    "google-tagmanager": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-tagmanager@latest"],
      "env": {
        "GOOGLE_TAGMANAGER_CLIENT_ID": "your_client_id",
        "GOOGLE_TAGMANAGER_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_TAGMANAGER_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

Cursor MCP 문서

명령 팔레트에서 MCP: Open User Configuration을 실행하고 다음을 추가합니다:

{
  "servers": {
    "google-tagmanager": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-tagmanager@latest"],
      "env": {
        "GOOGLE_TAGMANAGER_CLIENT_ID": "${input:gtm_client_id}",
        "GOOGLE_TAGMANAGER_CLIENT_SECRET": "${input:gtm_client_secret}",
        "GOOGLE_TAGMANAGER_REFRESH_TOKEN": "${input:gtm_refresh_token}"
      }
    }
  },
  "inputs": [
    { "type": "promptString", "id": "gtm_client_id", "description": "Google OAuth client ID" },
    { "type": "promptString", "id": "gtm_client_secret", "description": "Google OAuth client secret", "password": true },
    { "type": "promptString", "id": "gtm_refresh_token", "description": "Google OAuth refresh token", "password": true }
  ]
}

MCP: List Servers로 확인합니다.

VS Code MCP 문서

요청할 수 있는 작업

현재 구성 파악하기

• 액세스할 수 있는 GTM 계정과 컨테이너를 나열합니다.

• 이 작업공간에서 페이지뷰에 실행되는 태그는 무엇인가요?

• 이 태그의 트리거 및 변수 구성을 보여줍니다.

• 어떤 기본 제공 변수가 활성화되어 있나요?

초안으로 추적 변경 준비하기

• 결제 추적 변경을 위한 작업공간을 만듭니다.

• 특정 이벤트에 대한 GA4 태그와 트리거를 준비합니다.

• 이 트리거에 필요한 클릭 변수를 활성화합니다.

• 완전한 교체 구성을 보여준 후 이 태그를 업데이트합니다.

버전을 의도적으로 릴리스하기

• 이 작업공간을 April release라는 이름의 버전으로 컴파일합니다.

• 컴파일러 오류가 있으면 보여줍니다.

• 버전과 변경사항을 확인한 후 버전 42를 게시합니다.

GTM 변경사항이 연결되는 방식

GTM에는 명확한 릴리스 경로가 있습니다:

1. 계정에는 하나 이상의 컨테이너가 포함됩니다.

2. 컨테이너에는 초안 변경을 위한 작업공간이 있습니다.

3. 태그, 트리거, 변수는 작업공간에 속합니다.

4. 작업공간을 컴파일하면 컨테이너 버전이 생성되고 원본 작업공간이 제거됩니다. GTM은 대체 작업공간을 제공합니다.

5. 게시하면 선택한 컨테이너 버전이 라이브로 전환됩니다.

이 서버는 각 단계를 검사할 수 있습니다. 초안을 릴리스로 취급하지 않으며, 버전 생성과 게시는 별도의 작업입니다.

변경할 수 있는 것

AI 클라이언트는 확인을 요청하는 방식을 결정합니다. 서버는 읽기 전용, 쓰기, 파괴적 작업을 표시하여 클라이언트가 검사와 실제 변경을 구분할 수 있게 합니다.

액세스 권한 얻기

서버는 Google OAuth 2.0을 사용합니다. Google Tag Manager는 이 사용자 데이터에 대한 API 키를 제공하지 않습니다.

1. Google Cloud 프로젝트를 만들거나 선택하고 Tag Manager API를 활성화합니다. 해당 API가 활성화되지 않은 프로젝트에는 할당량이 부여되지 않습니다.

2. OAuth 동의 화면을 구성하고 OAuth 클라이언트를 만듭니다. Desktop app 클라이언트는 로컬 사용에 적합합니다.

3. Google 계정을 승인하고 갱신 토큰을 얻습니다. OAuth 2.0 Playground에서 Use your own OAuth credentials를 활성화하면 이 작업을 수행할 수 있습니다.

4. 다음 범위를 함께 요청합니다:

   https://www.googleapis.com/auth/tagmanager.readonly
   https://www.googleapis.com/auth/tagmanager.edit.containers
   https://www.googleapis.com/auth/tagmanager.edit.containerversions
   https://www.googleapis.com/auth/tagmanager.publish

범위는 별개입니다. 읽기, 편집, 버전 컴파일, 게시는 각각 해당 권한이 필요합니다. 클라이언트 시크릿과 갱신 토큰을 비밀번호처럼 취급하세요.

구성

* OAuth 3종 세트 또는 액세스 토큰 중 하나를 제공하세요. 액세스 토큰은 약 1시간 후 만료되며 자동으로 갱신되지 않습니다.

데이터 및 원격 분석

서버는 로컬에서 실행되며 GTM API 요청과 OAuth 갱신 요청을 Google에 보냅니다. 익명 원격 분석에는 무작위 설치 ID, 패키지 버전, AI 클라이언트 및 Node.js/운영 체제 버전, 도구 이름이 포함됩니다. OAuth 토큰, GTM 데이터, 도구 인수 또는 프롬프트는 전송하지 않습니다.

다음으로 A1 MCP 서버의 원격 분석을 비활성화합니다:

ASKADS_TELEMETRY=0

제한 사항 및 백그라운드 작업

• GTM에는 속도 제한이 있습니다. API는 프로젝트당 초당 0.25개의 요청을 허용하므로, 서버는 호출 간격을 최소 4.2초로 직렬화합니다. 따라서 광범위한 감사에는 시간이 걸릴 수 있습니다.

• 일시적 제한은 신중하게 재시도됩니다. 429 및 Google 할당량 403 응답은 지수 백오프와 Retry-After를 사용합니다. 읽기는 네트워크 및 5xx 실패 후 재시도되며, 쓰기는 불확실한 실패 후에 재전송되지 않습니다.

• 백그라운드 모니터링은 없습니다. 서버는 AI 앱이 호출할 때만 실행됩니다. 앱이 예약 작업을 지원하면 컨테이너 또는 해당 라이브 버전을 주기적으로 검사할 수 있습니다.

• 컴파일하면 작업공간이 사라집니다. create_version을 호출하기 전에 작업공간에서 필요한 것을 모두 저장하고 반환된 대체 작업공간 경로를 검사하세요.

기술 문서

• MCP 기능 카탈로그 — 모든 도구에 대한 작업 중심 페이지.

• 모든 도구 및 입력

• 개발 문서

• 배포 문서

• Google Tag Manager API v2 참조

지원

버그를 발견했거나 시나리오가 필요하신가요? 이슈 만들기 또는 Telegram에 글을 남겨주세요.