Google Merchant Center MCP

English | Русский

A1 Google Merchant Center MCP는 AI 앱을 사용자의 Google Merchant Center 계정에 연결합니다. 제품이 비승인된 이유를 확인하고, 피드와 프로모션을 검사하고, 보고서와 시장 가격을 탐색한 다음, 필요할 때 제품 데이터를 의도적으로 변경할 수 있습니다.

이 서버는 쇼핑 리스팅의 기반이 되는 Merchant Center 데이터(제품, 데이터 소스, 프로모션, 보고서)와 함께 작동합니다. 캠페인, 예산, 입찰은 Google Ads에 속하므로 이 서버의 범위를 벗어납니다.

• 도구 22개. 15개 작업은 Merchant Center 데이터를 읽기만 하고, 5개는 제품·데이터 소스·프로모션 데이터를 쓰며, 2개는 잠재적으로 파괴적입니다.

• 사용자의 Google 액세스. 이 서버는 사용자의 OAuth 자격 증명과 Merchant API v1을 사용하며 별도의 Merchant Center 계정을 만들지 않습니다.

• 소스 인식 변경. 제품 및 프로모션 입력은 API 데이터 소스를 통해서만 변경할 수 있습니다. 파일 피드는 다시 가져올 수 있지만, 그 내용은 여기서 편집되지 않습니다.

• 명확한 경계. 도구에는 읽기 전용, 쓰기 또는 파괴적 메타데이터가 표시되므로 AI 클라이언트는 조회와 실시간 변경을 구분할 수 있습니다.

읽기 전용 질문으로 시작하세요:

어떤 제품이 비승인되었으며, Google은 각 제품에 대해 어떤 문제를 보고하나요?

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

1분 만에 작동 확인

사용자: 어떤 제품이 비승인되었으며, Google은 각 제품에 대해 어떤 문제를 보고하나요?

어시스턴트: 영향을 받은 제품을 나열하고 Merchant Center가 보고하는 항목 수준 문제를 설명합니다.

사용자: 제품 SKU-123의 현재 가격과 재고 상태를 보여주고, in_stock으로 재고 상태 업데이트를 준비해 주세요.

어시스턴트: 현재 제품 입력, 해당 입력이 속한 API 데이터 소스, 그리고 적용할 정확한 변경 사항을 표시합니다. 실제 제품 입력을 업데이트하기 전에 확인을 요청합니다.

사용자: 업데이트를 확인합니다.

어시스턴트: 업데이트를 전송하고 Merchant Center가 제품 데이터를 비동기적으로 처리한다고 설명합니다. 처리된 제품과 품질 상태가 갱신되려면 몇 분이 걸릴 수 있습니다.

Related MCP server: gmc-mcp

목차

• 빠른 시작

• 요청할 수 있는 작업

• Merchant Center 데이터의 연결 방식

• 변경할 수 있는 것

• 액세스 권한 얻기

• 구성

• 데이터 및 원격 분석

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

• 기술 문서

• 지원

빠른 시작

Node.js 20+, Google Merchant Center 계정, Google Cloud의 OAuth 자격 증명, Merchant Center에 등록된 Google Cloud 프로젝트가 필요합니다. 액세스 설정은 액세스 권한 얻기에서 설명합니다.

1. 네 가지 값을 준비합니다. OAuth 클라이언트 ID, OAuth 클라이언트 시크릿, OAuth 리프레시 토큰, Merchant Center 계정 ID.

2. 아래 지침 중 하나를 사용하여 AI 앱에 서버를 추가합니다.

3. 위의 첫 번째 읽기 전용 질문을 합니다.

앱에서:

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

2. Add server를 선택합니다.

3. 실행 명령 npx -y mcp-google-merchants@latest과 아래의 네 가지 환경 변수를 추가합니다.

명령줄에서:

codex mcp add google-merchants \
  --env GOOGLE_MERCHANTS_CLIENT_ID=your_client_id \
  --env GOOGLE_MERCHANTS_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_MERCHANTS_REFRESH_TOKEN=your_refresh_token \
  --env GOOGLE_MERCHANTS_ACCOUNT_ID=your_merchant_id \
  -- npx -y mcp-google-merchants@latest

연결 확인:

codex mcp list

Codex MCP 문서

claude mcp add \
  --env GOOGLE_MERCHANTS_CLIENT_ID=your_client_id \
  --env GOOGLE_MERCHANTS_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_MERCHANTS_REFRESH_TOKEN=your_refresh_token \
  --env GOOGLE_MERCHANTS_ACCOUNT_ID=your_merchant_id \
  --transport stdio \
  --scope user \
  google-merchants \
  -- npx -y mcp-google-merchants@latest

연결 확인:

claude mcp list

Claude Code MCP 문서

1. Claude Desktop을 열고 Settings → Developer로 이동합니다.

2. Edit Config를 선택합니다.

3. mcpServers에 서버를 추가합니다:

{
  "mcpServers": {
    "google-merchants": {
      "command": "npx",
      "args": ["-y", "mcp-google-merchants@latest"],
      "env": {
        "GOOGLE_MERCHANTS_CLIENT_ID": "your_client_id",
        "GOOGLE_MERCHANTS_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_MERCHANTS_REFRESH_TOKEN": "your_refresh_token",
        "GOOGLE_MERCHANTS_ACCOUNT_ID": "your_merchant_id"
      }
    }
  }
}

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-merchants": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-merchants@latest"],
      "env": {
        "GOOGLE_MERCHANTS_CLIENT_ID": "your_client_id",
        "GOOGLE_MERCHANTS_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_MERCHANTS_REFRESH_TOKEN": "your_refresh_token",
        "GOOGLE_MERCHANTS_ACCOUNT_ID": "your_merchant_id"
      }
    }
  }
}

Cursor MCP 문서

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

{
  "servers": {
    "google-merchants": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-merchants@latest"],
      "env": {
        "GOOGLE_MERCHANTS_CLIENT_ID": "${input:google_merchants_client_id}",
        "GOOGLE_MERCHANTS_CLIENT_SECRET": "${input:google_merchants_client_secret}",
        "GOOGLE_MERCHANTS_REFRESH_TOKEN": "${input:google_merchants_refresh_token}",
        "GOOGLE_MERCHANTS_ACCOUNT_ID": "${input:google_merchants_account_id}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "google_merchants_client_id",
      "description": "Google OAuth client ID"
    },
    {
      "type": "promptString",
      "id": "google_merchants_client_secret",
      "description": "Google OAuth client secret",
      "password": true
    },
    {
      "type": "promptString",
      "id": "google_merchants_refresh_token",
      "description": "Google OAuth refresh token",
      "password": true
    },
    {
      "type": "promptString",
      "id": "google_merchants_account_id",
      "description": "Merchant Center account ID"
    }
  ]
}

MCP: List Servers로 서버를 확인합니다.

VS Code MCP 문서

요청할 수 있는 작업

카탈로그 문제 찾기 및 이해

• 어떤 제품이 비승인되었으며, Google은 각 제품에 대해 무엇을 보고하나요?

• 제품 SKU-123의 제목, 가격, 재고 상태 및 현재 상태를 표시해 주세요.

• 재고가 없는 제품은 무엇인가요?

• 이 Merchant Center 계정에서 가장 빈번한 제품 문제를 보여주세요.

실적 및 가격 탐색

• 7월의 제품별 클릭수와 노출수를 표시해 주세요.

• 미국에서 시장 기준보다 높게 책정된 제품은 무엇인가요?

• Google이 제안하는 가격은 무엇이며, 예측되는 영향은 무엇인가요?

가격 비교와 제안에는 Merchant Center의 무료 Market Insights 옵트인이 필요합니다. 계정이 옵트인하지 않은 경우 서버는 보고서에 행이 없는 이유를 설명합니다.

계정 및 피드 검사

• 액세스할 수 있는 Merchant Center 계정을 나열해 주세요.

• 스토어 홈페이지가 클레임되어 있나요? 현재 배송 설정을 보여주세요.

• 제품 및 프로모션 데이터 소스를 나열하고 API 데이터 소스를 식별해 주세요.

• 이 예약된 파일 피드를 지금 다시 가져오세요.

의도적인 변경 수행

• 이 제품의 가격과 재고 상태를 해당 API 데이터 소스에서 업데이트하세요.

• 새 제품 피드를 위한 API 데이터 소스를 생성하세요.

• 프로모션을 생성하거나 업데이트한 다음 승인 상태를 확인하세요.

데이터를 변경하는 모든 요청에 대해 먼저 어시스턴트에게 대상 계정, 데이터 소스 및 변경하려는 정확한 필드를 표시하도록 요청하세요.

Merchant Center 데이터의 연결 방식

Merchant Center는 들어오는 데이터와 그 결과로 생성된 제품 상태를 분리하여 유지합니다:

1. 계정에는 제품 및 프로모션 데이터 소스가 포함됩니다.

2. 데이터 소스는 API 소스, 파일, Google Sheet, Merchant Center 인터페이스 또는 자동 피드일 수 있습니다.

3. 제품 입력은 하나의 소스에서 제공되는 제품 데이터입니다.

4. 처리된 제품은 Merchant Center가 해당 입력을 처리한 후 파생하는 결과입니다. 여기에는 자격 및 항목 수준 문제가 포함됩니다.

서버는 나열된 모든 소스 유형을 읽을 수 있습니다. API 데이터 소스를 생성하고 제품 입력을 업데이트할 수 있지만, 오직 API 데이터 소스에서만 가능합니다. 파일, 인터페이스 또는 자동 피드에는 쓸 수 없습니다. 조건으로 제품을 찾으려면 보고서 쿼리를 사용하세요. list_products 자체는 서버 측 필터링을 제공하지 않습니다.

변경할 수 있는 것

MCP 클라이언트는 쓰기 및 파괴적 도구에 대한 확인을 어떻게 요청할지 결정합니다. 서버는 읽기 전용, 쓰기 및 파괴적 작업을 표시하므로 클라이언트가 적절한 경계를 제시할 수 있습니다.

액세스 권한 얻기

이 서버는 Google Merchant API와 OAuth 범위 https://www.googleapis.com/auth/content를 사용합니다.

1. Google Cloud 프로젝트를 만들거나 선택하고, Merchant API를 사용 설정한 다음 OAuth 동의 화면을 구성합니다.

2. Google Cloud에서 유형이 Desktop app인 OAuth 클라이언트를 만듭니다. 해당 클라이언트 ID와 클라이언트 시크릿을 저장합니다.

3. Merchant Center에 액세스할 수 있는 Google 계정을 인증하고 위 범위에 대한 리프레시 토큰을 얻습니다. OAuth 2.0 Playground가 이 단계에 도움이 될 수 있습니다. Use your own OAuth credentials를 사용 설정하고, 범위를 입력하고, 인증한 다음 코드를 토큰과 교환하세요.

4. Merchant Center에서 Merchant Center 계정 ID를 찾아 GOOGLE_MERCHANTS_ACCOUNT_ID로 사용합니다.

5. Google Cloud 프로젝트를 Merchant Center에 한 번 등록합니다. Google은 이 작업을 위해 검증된 웹사이트와 계정 관리자가 있는 프로덕션 Merchant Center 계정을 요구합니다. 등록은 하나의 Cloud 프로젝트를 Merchant Center 계정에 연결합니다. 등록이 완료될 때까지 해당 프로젝트의 Merchant API 호출은 차단됩니다. Google의 개발자 등록 가이드를 따르세요.

일회성 등록은 기술적인 raw_request 도구를 통해 가능하지만, 이번이 첫 Merchant API 설정이라면 Google의 가이드를 따르는 것이 더 안전합니다. 등록 후 Google이 호출을 수락하는 데 최대 5분이 걸릴 수 있습니다.

OAuth 클라이언트 시크릿과 리프레시 토큰을 비밀번호처럼 취급하세요. 이 값들은 MCP 클라이언트 구성에 저장되며 Merchant Center 계정에 대한 액세스 권한을 부여할 수 있습니다.

구성

* 클라이언트 ID, 클라이언트 시크릿, 리프레시 토큰을 함께 사용하거나 사전 발급된 액세스 토큰을 사용하세요. 액세스 토큰은 보통 약 1시간 후 만료되며, 리프레시 토큰을 사용하면 서버가 필요할 때 새 액세스 토큰을 받을 수 있습니다.

데이터 및 텔레메트리

서버는 AI 앱이 시작한 프로세스로 로컬에서 실행됩니다. Google에 Merchant Center 요청을 보내고 Google의 OAuth 엔드포인트를 통해 OAuth 액세스 토큰을 갱신합니다.

활성 설치 수와 도구 수요를 파악하기 위해 익명 사용량 텔레메트리를 전송합니다. 전송 항목은 무작위 설치 ID, 패키지 버전, AI 클라이언트 및 Node.js/운영체제 버전, 도구 이름입니다. OAuth 토큰, Merchant Center 데이터, 도구 인수 또는 프롬프트는 전송하거나 저장하지 않습니다. A1 MCP 서버에 대해 이 텔레메트리를 비활성화하려면 다음을 사용하세요:

ASKADS_TELEMETRY=0

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

• Merchant Center 처리는 비동기입니다. 새로 삽입, 업데이트 또는 삭제된 제품 입력이 처리된 제품에 표시되는 데 몇 분이 걸릴 수 있습니다. 제품 및 프로모션 승인 문제는 즉각적인 API 오류가 아닌 나중에 나타납니다.

• Market Insights는 선택 사항입니다. 가격 경쟁력 및 제안 가격 보고서는 계정이 무료 Market Insights 프로그램에 옵트인한 후에만 데이터를 반환합니다.

• 할당량은 계정과 API 메서드에 따라 다릅니다. list_method_quotas로 현재 소비량을 확인하세요. Google의 일일 카운터는 12:00 UTC에 리셋됩니다.

• 일시적 제한은 신중하게 처리됩니다. Google이 429를 반환하면 서버는 제공된 Retry-After를 따르고 제한된 횟수만 재시도합니다. 불확실한 네트워크 또는 서버 오류 후에는 쓰기 요청을 재생하지 않습니다.

• 백그라운드 모니터링은 없습니다. 서버는 AI 앱이 호출하는 동안에만 작동합니다. AI 앱이 예약 작업을 지원한다면 제품 문제나 할당량 사용량을 주기적으로 확인하도록 요청할 수 있습니다.

• 집계된 제품 문제에는 계정 제한이 있습니다. list_product_issues는 독립 및 하위 계정에서는 작동하지만 고급 상위 계정에서는 작동하지 않습니다.

기술 문서

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

• 모든 도구 및 해당 입력

• 개발 문서

• 게시 문서

• Google Merchant API 개요

• Google Merchant API 인증

• Google 개발자 등록

지원

버그를 찾았거나 시나리오가 필요하신가요? 이슈 생성 또는 Telegram에 글을 남겨주세요.