Google Ad Manager MCP 서버 사용

Google Ad Manager는 AI 에이전트가 Google Ad Manager 네트워크, 인벤토리, 주문, 사용자 데이터와 안전하게 상호작용할 수 있는 원격 모델 컨텍스트 프로토콜 (MCP) 서버를 제공합니다. Ad Manager MCP 서버를 구성하면 Google Antigravity, Claude, ChatGPT와 같은 AI 애플리케이션이 Ad Manager 사용자로 작업을 수행할 수 있습니다.

MCP 서버는 https://admanager.googleapis.com/mcp에서 사용할 수 있습니다.

기본 요건

• Google Cloud 프로젝트를 만들 수 있는 액세스 권한 또는 기존 Google Cloud 프로젝트를 볼 수 있는 액세스 권한
• AI 클라이언트 (예: ChatGPT 또는 Claude)에서 연결 또는 앱을 수정할 수 있는 액세스 권한

Ad Manager MCP 서버 구성

Ad Manager MCP 서버를 사용하려면 다음 단계를 완료해야 합니다.

• Google Cloud 프로젝트에서 Ad Manager API를 사용 설정합니다.
• OAuth 2.0 최종 사용자 인증을 구성합니다.
• AI 클라이언트에 MCP 서버를 추가합니다.

Ad Manager API 사용 설정

Ad Manager MCP 서버를 사용하려면 Google Cloud 프로젝트에서 Ad Manager API를 사용 설정해야 합니다. Google Cloud 프로젝트를 만들어야 하는 경우 새 프로젝트를 참고하세요.

API 사용 설정

인증 구성

Ad Manager MCP 서버는 최종 사용자 인증 및 승인에 OAuth 2.0을 사용합니다. AI 클라이언트가 MCP 서버에 연결되면 AI 클라이언트를 실행하는 사용자로 인증됩니다. AI 에이전트는 사용자와 동일한 Google Ad Manager 사용자 역할, 네트워크 멤버십, 권한을 상속받습니다.

1. Google Cloud 콘솔에서 Google 인증 플랫폼 > 브랜딩으로 이동합니다.

   브랜딩으로 이동

2. 이미 Google 인증 플랫폼을 구성한 경우 브랜딩, 대상, 데이터 액세스에서 다음 OAuth 동의 화면 설정을 구성할 수 있습니다. Google 인증 플랫폼이 아직 구성되지 않음이라는 메시지가 표시되면 시작하기를 클릭합니다.

   1. 앱 정보 섹션의 앱 이름에 Ad Manager MCP Server 또는 원하는 이름을 입력합니다.
   2. 사용자 지원 이메일에서 이메일 주소 또는 적절한 그룹을 선택합니다.
   3. 다음을 클릭합니다.
   4. 대상에서 내부를 선택합니다.
   5. 다음을 클릭합니다.
   6. 연락처 정보에 프로젝트 변경사항에 대한 알림을 받을 수 있는 이메일 주소를 입력합니다.
   7. 다음을 클릭합니다.
   8. 완료 섹션에서 Google API 서비스 사용자 데이터 정책을 검토하고 동의하는 경우 Google API 서비스: 사용자 데이터 정책에 동의합니다를 선택합니다.
   9. 계속을 클릭합니다.
   10. 만들기를 클릭합니다.

3. 데이터 액세스 > 범위 추가 또는 삭제를 클릭합니다. Google Cloud 프로젝트에서 사용 설정한 각 API의 범위 목록이 패널에 표시됩니다.

   1. 범위 수동 추가에서 Ad Manager MCP 서버에 필요한 OAuth 범위를 입력합니다.
      • https://www.googleapis.com/auth/admanager (캠페인을 보고 관리할 수 있는 전체 액세스 권한)
   2. 표에 추가를 클릭합니다.
   3. 업데이트를 클릭합니다.
   4. 앱에 필요한 범위를 선택한 후 데이터 액세스 페이지에서 저장을 클릭합니다.

AI 클라이언트에 MCP 서버 추가

AI 클라이언트에 Ad Manager MCP 서버를 추가하려면 클라이언트에 대한 안내를 따르세요.

Antigravity

Antigravity에 Ad Manager MCP 서버를 추가하려면 다음 단계를 완료하세요.

1. OAuth 2.0 클라이언트 ID 및 보안 비밀을 만듭니다.

   1. Google API 콘솔에서 Google 인증 플랫폼 > 클라이언트 > 클라이언트 만들기로 이동합니다.

      클라이언트 만들기로 이동

      선택된 프로젝트가 없으면 프로젝트를 만들라는 메시지가 표시됩니다.

   2. 애플리케이션 유형 목록에서 웹 애플리케이션을 선택합니다.

   3. 이름 필드에 애플리케이션 이름을 입력합니다.

   4. 승인된 리디렉션 URI 섹션에서 + URI 추가를 클릭한 다음 URI 필드에 https://antigravity.google/oauth-callback를 입력합니다.

   5. 만들기를 클릭합니다. 클라이언트가 생성됩니다.

      OAuth 2.0 클라이언트 생성됨 대화상자가 열립니다.

   6. 클라이언트 보안 비밀번호 섹션에서 클라이언트 보안 비밀번호를 복사하여 안전한 곳에 저장합니다. 한 번만 복사할 수 있습니다. 분실한 경우 보안 비밀번호를 삭제하고 새 보안 비밀번호를 만드세요.

      주의: 클라이언트 보안 비밀번호를 비밀번호처럼 취급하고 안전한 곳에 저장하세요.

2. Antigravity에 Ad Manager MCP 서버를 추가하려면 ~/.gemini/config/mcp_config.json 파일을 업데이트하세요.

   {
     "mcpServers": {
       "AdManager-MCP": {
         // Use your chosen MCP server URL.
         "serverUrl": "https://admanager.googleapis.com/mcp",
         "oauth": {
           "clientId": "CLIENT_ID",
           "clientSecret": "CLIENT_SECRET"
         }
       }
     }
   }

   CLIENT_ID 및 CLIENT_SECRET을 OAuth 2.0 클라이언트 사용자 인증 정보로 바꿉니다.

3. Ad Manager MCP 서버를 인증하려면 Antigravity: OAuth로 인증을 참고하세요.

Claude.ai

Claude.ai에 Ad Manager MCP 서버를 추가하려면 OAuth 클라이언트 ID와 OAuth 클라이언트 보안 비밀번호를 사용하여 맞춤 커넥터를 구성하세요.

1. OAuth 2.0 클라이언트 ID 및 보안 비밀을 만듭니다.

   1. Google API 콘솔에서 Google 인증 플랫폼 > 클라이언트 > 클라이언트 만들기로 이동합니다.

      클라이언트 만들기로 이동

      선택된 프로젝트가 없으면 프로젝트를 만들라는 메시지가 표시됩니다.

   2. 애플리케이션 유형 목록에서 웹 애플리케이션을 선택합니다.

   3. 이름 필드에 애플리케이션 이름을 입력합니다.

   4. 승인된 리디렉션 URI 섹션에서 + URI 추가를 클릭한 다음 URI 필드에 https://claude.ai/api/mcp/auth_callback를 입력합니다.

   5. 만들기를 클릭합니다. 클라이언트가 생성됩니다.

      OAuth 2.0 클라이언트 생성됨 대화상자가 열립니다.

   6. 클라이언트 보안 비밀번호 섹션에서 클라이언트 보안 비밀번호를 복사하여 안전한 곳에 저장합니다. 한 번만 복사할 수 있습니다. 분실한 경우 보안 비밀번호를 삭제하고 새 보안 비밀번호를 만드세요.

      주의: 클라이언트 보안 비밀번호를 비밀번호처럼 취급하고 안전한 곳에 저장하세요.
2. 안내에 따라 맞춤 커넥터를 만듭니다. 고급 설정 메뉴에 클라이언트 ID와 보안 비밀을 입력합니다.

Claude Code

Claude Code에 Ad Manager MCP 서버를 추가하려면 OAuth 클라이언트 ID와 OAuth 클라이언트 보안 비밀번호를 사용하여 맞춤 커넥터를 구성하세요.

1. Claude Code를 설치합니다.

2. OAuth 2.0 클라이언트 ID 및 보안 비밀을 만듭니다.

   1. Google API 콘솔에서 Google 인증 플랫폼 > 클라이언트 > 클라이언트 만들기로 이동합니다.

      클라이언트 만들기로 이동

      선택된 프로젝트가 없으면 프로젝트를 만들라는 메시지가 표시됩니다.

   2. 애플리케이션 유형 목록에서 웹 애플리케이션을 선택합니다.

   3. 이름 필드에 애플리케이션 이름을 입력합니다.

   4. 승인된 리디렉션 URI 섹션에서 + URI 추가를 클릭한 다음 URI 필드에 https://claude.ai/api/mcp/auth_callback를 입력합니다.

   5. 만들기를 클릭합니다. 클라이언트가 생성됩니다.

      OAuth 2.0 클라이언트 생성됨 대화상자가 열립니다.

   6. 클라이언트 보안 비밀번호 섹션에서 클라이언트 보안 비밀번호를 복사하여 안전한 곳에 저장합니다. 한 번만 복사할 수 있습니다. 분실한 경우 보안 비밀번호를 삭제하고 새 보안 비밀번호를 만드세요.

      주의: 클라이언트 보안 비밀번호를 비밀번호처럼 취급하고 안전한 곳에 저장하세요.
3. 안내에 따라 맞춤 커넥터를 만듭니다. 고급 설정 메뉴에 클라이언트 ID와 보안 비밀을 입력합니다.

Claude Desktop

Claude 데스크톱에 Ad Manager MCP 서버를 추가하려면 OAuth 클라이언트 ID와 OAuth 클라이언트 보안 비밀을 사용하여 맞춤 커넥터를 구성하세요.

1. Claude Desktop 설치

2. OAuth 2.0 클라이언트 ID 및 보안 비밀을 만듭니다.

   1. Google API 콘솔에서 Google 인증 플랫폼 > 클라이언트 > 클라이언트 만들기로 이동합니다.

      클라이언트 만들기로 이동

      선택된 프로젝트가 없으면 프로젝트를 만들라는 메시지가 표시됩니다.

   2. 애플리케이션 유형 목록에서 웹 애플리케이션을 선택합니다.

   3. 이름 필드에 애플리케이션 이름을 입력합니다.

   4. 승인된 리디렉션 URI 섹션에서 + URI 추가를 클릭한 다음 URI 필드에 https://claude.ai/api/mcp/auth_callback를 입력합니다.

   5. 만들기를 클릭합니다. 클라이언트가 생성됩니다.

      OAuth 2.0 클라이언트 생성됨 대화상자가 열립니다.

   6. 클라이언트 보안 비밀번호 섹션에서 클라이언트 보안 비밀번호를 복사하여 안전한 곳에 저장합니다. 한 번만 복사할 수 있습니다. 분실한 경우 보안 비밀번호를 삭제하고 새 보안 비밀번호를 만드세요.

      주의: 클라이언트 보안 비밀번호를 비밀번호처럼 취급하고 안전한 곳에 저장하세요.
3. 안내에 따라 맞춤 커넥터를 만듭니다. 고급 설정 메뉴에 클라이언트 ID와 보안 비밀을 입력합니다.

ChatGPT

ChatGPT로 Ad Manager MCP 서버를 사용하려면 ChatGPT Business 구독이 있어야 합니다.

ChatGPT에 MCP 서버를 추가하려면 Google OAuth 2.0 클라이언트 ID와 보안 비밀번호를 만든 다음 ChatGPT에 MCP 서버를 앱으로 추가합니다.

OAuth 2.0 클라이언트 ID 및 보안 비밀 만들기

1. Google API 콘솔에서 Google 인증 플랫폼 > 클라이언트 > 클라이언트 만들기로 이동합니다.

   클라이언트 만들기로 이동

   선택된 프로젝트가 없으면 프로젝트를 만들라는 메시지가 표시됩니다.

2. 애플리케이션 유형 목록에서 웹 애플리케이션을 선택합니다.

3. 이름 필드에 애플리케이션 이름을 입력합니다.

4. 승인된 리디렉션 URI 섹션에서 + URI 추가를 클릭한 다음 URI 필드에 https://chatgpt.com/connector_platform_oauth_redirect를 입력합니다.

5. 만들기를 클릭합니다. 클라이언트가 생성됩니다.

   OAuth 2.0 클라이언트 생성됨 대화상자가 열립니다.

6. 클라이언트 보안 비밀번호 섹션에서 클라이언트 보안 비밀번호를 복사하여 안전한 곳에 저장합니다. 한 번만 복사할 수 있습니다. 분실한 경우 보안 비밀번호를 삭제하고 새 보안 비밀번호를 만드세요.

   주의: 클라이언트 보안 비밀번호를 비밀번호처럼 취급하고 안전한 곳에 저장하세요.

ChatGPT에 MCP 서버를 앱으로 추가

1. ChatGPT에 로그인합니다.
2. 개발자 모드를 사용 설정합니다.
3. ChatGPT 앱 설정을 엽니다.
4. 앱 만들기를 클릭하고 원격 MCP 서버용 앱을 만듭니다.
5. OAuth 섹션에서 클라이언트 ID와 보안 비밀을 입력합니다.
6. MCP 서버 사용과 관련된 위험을 이해했는지 확인한 다음 만들기를 클릭합니다.

MCP 서버가 앱 메뉴에 표시되며 채팅 프롬프트를 통해 사용할 수 있습니다.

커서

Cursor에 Ad Manager MCP 서버를 추가하려면 클라이언트 ID와 보안 비밀번호를 만드세요. 고정 OAuth로 MCP 서버를 구성합니다. 커서는 웹 또는 데스크톱 애플리케이션과 같이 커서에 액세스하는 데 사용하는 항목에 따라 리디렉션 URI를 사용합니다.

1. OAuth 2.0 클라이언트 ID 및 보안 비밀을 만듭니다.

   웹 또는 커서 에이전트

   1. Google API 콘솔에서 Google 인증 플랫폼 > 클라이언트 > 클라이언트 만들기로 이동합니다.

      클라이언트 만들기로 이동

      선택된 프로젝트가 없으면 프로젝트를 만들라는 메시지가 표시됩니다.

   2. 애플리케이션 유형 목록에서 웹 애플리케이션을 선택합니다.

   3. 이름 필드에 애플리케이션 이름을 입력합니다.

   4. 승인된 리디렉션 URI 섹션에서 + URI 추가를 클릭한 다음 URI 필드에 https://www.cursor.com/agents/mcp/oauth/callback를 입력합니다.

   5. 만들기를 클릭합니다. 클라이언트가 생성됩니다.

      OAuth 2.0 클라이언트 생성됨 대화상자가 열립니다.

   6. 클라이언트 보안 비밀번호 섹션에서 클라이언트 보안 비밀번호를 복사하여 안전한 곳에 저장합니다. 한 번만 복사할 수 있습니다. 분실한 경우 보안 비밀번호를 삭제하고 새 보안 비밀번호를 만드세요.

      주의: 클라이언트 보안 비밀번호를 비밀번호처럼 취급하고 안전한 곳에 저장하세요.

   데스크톱

   1. Google API 콘솔에서 Google 인증 플랫폼 > 클라이언트 > 클라이언트 만들기로 이동합니다.

      클라이언트 만들기로 이동

      선택된 프로젝트가 없으면 프로젝트를 만들라는 메시지가 표시됩니다.

   2. 애플리케이션 유형 목록에서 웹 애플리케이션을 선택합니다.

   3. 이름 필드에 애플리케이션 이름을 입력합니다.

   4. 승인된 리디렉션 URI 섹션에서 + URI 추가를 클릭한 다음 URI 필드에 http://localhost:8787/callback를 입력합니다.

   5. 만들기를 클릭합니다. 클라이언트가 생성됩니다.

      OAuth 2.0 클라이언트 생성됨 대화상자가 열립니다.

   6. 클라이언트 보안 비밀번호 섹션에서 클라이언트 보안 비밀번호를 복사하여 안전한 곳에 저장합니다. 한 번만 복사할 수 있습니다. 분실한 경우 보안 비밀번호를 삭제하고 새 보안 비밀번호를 만드세요.

      주의: 클라이언트 보안 비밀번호를 비밀번호처럼 취급하고 안전한 곳에 저장하세요.
2. 안내에 따라 정적 OAuth로 MCP 서버를 구성합니다.
3. Chat에서 MCP 서버 사용

Ad Manager MCP 서버 테스트

MCP 클라이언트를 구성하고 인증한 후 AI 채팅 인터페이스에서 테스트 프롬프트를 실행하여 연결을 확인할 수 있습니다.

AI 클라이언트에게 다음과 같이 질문해 보세요.

• '내가 액세스할 수 있는 Google Ad Manager 네트워크를 나열해 줘.'

  클라이언트는 list_networks를 호출하여 사용자 계정과 연결된 Ad Manager 네트워크 코드와 표시 이름을 가져와 표시합니다.

• '네트워크 코드 NETWORK_CODE의 세부정보를 찾아 줘.'

  클라이언트는 get_network를 사용하여 지정된 네트워크의 메타데이터를 가져옵니다.

• 'NETWORK_CODE 네트워크에서 처음 5개 주문을 보여 줘.'

  클라이언트는 list_orders를 호출하여 네트워크의 주문을 쿼리하고 요약합니다.

도구가 성공적으로 실행되고 Google Ad Manager 데이터를 반환하면 MCP 서버 연결이 올바르게 구성된 것입니다.