판매자 데이터 MCP 서버 (공개 알파)

선택한 코딩 지원 도구에서 판매자 센터 계정에 관한 실시간 데이터를 직접 가져옵니다. 이제 통합 개발 환경(IDE) 또는 맞춤 에이전트 프레임워크 내에서 모델 컨텍스트 프로토콜 (MCP) 서비스를 사용하여 판매자 센터 데이터에 액세스하고 이를 관리할 수 있습니다. 이 서비스를 통해 코딩 어시스턴트 또는 에이전트가 판매자 센터 데이터에 대해 읽기 전용 및 안전한 쓰기 작업을 실행할 수 있으므로, 공신력 있는 실시간 컨텍스트를 사용하여 문제를 진단하고, 프로그램을 확인하고, 보고서를 쿼리할 수 있습니다.

프로토콜 자체에 대한 자세한 내용은 모델 컨텍스트 프로토콜 표준을 참고하세요.

보안 및 액세스 제어

판매자 데이터 MCP 서버는 보안을 우선으로 고려하여 설계되었습니다.

  • 인증: 도구 실행은 표준 판매자 API 인증에 의거하여 엄격하게 관리되며 OAuth 2.0 또는 서비스 계정 사용자 인증 정보가 필요합니다.
  • 실행 안전성: 도구 스키마가 에이전트에 광범위하게 표시되지만 실제 도구 실행은 매우 안전하며 특정 API 사용자 인증 정보에 의해 엄격하게 제한됩니다.

중요 고려사항

이러한 도구를 사용하기 전에 다음 권장사항과 제한사항을 검토하세요.

변경사항 및 출시

출시 노트의 변경사항에 관해 게시할 예정이지만, 지원 중단 기간 없이 즉시 적용될 수 있습니다.

안전한 테스트

라이브 프로덕션 환경에서 이러한 도구를 사용하기 전에 테스트 계정 또는 비라이브 계정을 사용하여 먼저 실험해 보는 것이 좋습니다.

공유 할당량

MCP 서버는 표준 Merchant API 호출과 동일한 할당량 풀을 공유합니다. 실행 중인 에이전트는 특히 데이터 소스 가져오기의 경우 할당량을 빠르게 소진할 수 있습니다. 프로덕션 서비스 중단을 방지하려면 테스트 계정을 사용하는 것이 좋습니다.

도구 필터링 및 안전

향후 Google에서 이 MCP 서버에 쓰기 기능을 포함한 새 도구를 추가할 수 있습니다. AI 에이전트가 새 도구나 위험한 도구를 자동으로 의도치 않게 실행하지 않도록 하려면 전체 도구 세트를 노출하는 대신 내장 도구 필터링을 사용하도록 클라이언트를 명시적으로 구성하는 것이 좋습니다.

범위 및 제한사항

  • 읽기 전용 초점: 이 초기 단계의 안전 가이드라인으로 도구는 읽기 전용 작업과 위험도가 낮은 쓰기 도구 (예: 데이터 소스 생성)로 엄격하게 제한됩니다.

사용 가능한 기능

판매자 데이터 MCP 서버를 사용하여 에이전트 방식으로 다음 작업을 수행할 수 있습니다.

  • 정확한 리소스 이름을 사용하여 특정 제품의 자세한 상태 및 보고 컨텍스트를 가져옵니다.
  • 여러 제품을 나열하고 검색합니다.
  • 검색 보고서를 통해 쿼리 실적 데이터, 제품 상태, 가격 정보를 확인할 수 있습니다.
  • 데이터 소스의 업로드 상태를 나열, 생성, 가져오기, 확인합니다.
  • 제품 공개 상태 또는 프로그램 참여에 영향을 미치는 계정 수준 문제를 파악합니다.
  • 인벤토리 전반의 제품 비승인에 대한 집계된 이유를 나열합니다.
  • 특정 판매자 센터 프로그램의 활성 지역, 충족되지 않은 요구사항, 참여 상태를 확인합니다.
  • 상품, 이미지, 배송의 자동 개선 설정을 검토합니다.

설정

IDE 또는 코딩 어시스턴트를 판매자 데이터 MCP 서버에 연결하려면 MCP 클라이언트 설정을 업데이트하세요. 예를 들어 Claude Desktop, Antigravity, Visual Studio Code 또는 맞춤 에이전트 프레임워크의 mcp.json 파일을 업데이트합니다.

로컬 MCP 서버 설정에는 서비스 계정이 필요합니다. 이 헤드리스 로컬 실행에는 OAuth가 지원되지 않습니다. 서비스 계정을 만들고 JSON 비공개 키 파일을 다운로드한 후 특정 판매자 센터 ID와 함께 경로를 인수로 제공해야 합니다.

서비스 계정을 만들고 다운로드하는 방법에 관한 자세한 내용은 서비스 계정 가이드를 참고하세요.

클라이언트 구성

구성 설정:

Antigravity

Antigravity 문서의 안내를 따릅니다.

{
    "mcpServers": {
        "merchant-data-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@google/merchant-data-mcp",
                "--credentials",
                "/path/to/your/service-account-file.json"
            ]
        }
    }
}

Claude Desktop

Claude 데스크톱 문서의 안내를 따릅니다.

{
    "mcpServers": {
        "merchant-data-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@google/merchant-data-mcp",
                "--credentials",
                "/path/to/your/service-account-file.json"
            ]
        }
    }
}

사용 시나리오 예시

판매자 데이터 MCP 서버를 사용하면 에이전트가 실시간 판매자 센터 데이터와 상호작용할 수 있습니다. 일반적인 이유는 다음과 같습니다.

시나리오 1: 제품 비승인 진단

특정 제품이 Google 검색 결과에 표시되지 않는 이유를 알고 싶습니다.

사용자 프롬프트:

'혜택 ID가 'offer123'인 제품이 비승인된 이유는 무엇인가요?'

MCP를 사용하는 상담사 동작:

  1. 상담사가 list_products 또는 get_product_by_name를 호출하여 제품 상태를 찾습니다.
  2. MCP 서버는 issues 목록을 포함한 제품 상태를 반환합니다(예: '잘못된 가격 형식' 또는 '배송 값이 누락됨').
  3. 에이전트는 문제를 분석하고 근본 원인을 설명하며 문제 해결 방법을 제안합니다 (예: 가격 정보 업데이트).

시나리오 2: 자동 개선 확인

배송 자동 개선이 활성 상태인지 확인하고 싶습니다.

사용자 프롬프트:

'배송 자동 개선 기능이 사용 설정되어 있나요?'

MCP를 사용하는 상담사 동작:

  1. 에이전트는 get_automatic_improvements를 호출하여 계정 수준 설정을 가져옵니다.
  2. MCP 서버는 이미지, 상품, 배송 개선사항의 상태를 보여주는 구성을 반환합니다.
  3. 상담사가 배송 개선사항이 활성화되어 있는지 확인하거나, 사용 중지된 경우 활성화하는 방법을 설명합니다.

시나리오 3: 쿼리 성능 측정항목

판매자 센터 UI를 탐색하지 않고 최근 실적을 빠르게 확인하려는 경우

사용자 프롬프트:

"지난주 클릭수 기준 실적이 가장 우수한 제품 5개를 보여 줘."

MCP를 사용하는 상담사 동작:

  1. 에이전트는 product_performance_view 테이블을 타겟팅하고 clicks DESC로 정렬하고 5로 제한하는 판매자 센터 쿼리 언어 (MCQL) 쿼리를 구성합니다.
  2. 에이전트는 구성된 쿼리로 report_search를 호출합니다.
  3. MCP 서버는 라이브 보고 데이터베이스에 대해 쿼리를 실행하고 행을 반환합니다.
  4. 에이전트가 결과를 깔끔한 마크다운 테이블로 형식화합니다.

사용 가능한 도구의 세부 목록

MCP 서버는 에이전트에게 다음 도구를 노출합니다.

MCP 도구 설명
get_product_by_name 정확한 제품 리소스 이름을 사용하여 지정된 판매자의 제품 정보를 가져옵니다. 보고 컨텍스트와 잠재적인 제품 수준 문제가 포함된 상세 제품 상태를 반환합니다.
list_products 특정 판매자의 여러 제품을 나열하거나 검색합니다. 보고 컨텍스트와 잠재적인 제품 수준 문제가 포함된 상세 제품 상태를 반환합니다.
report_search 보고서 표를 쿼리하여 실적 측정항목, 제품 상태, 가격 정보를 가져옵니다. 자세한 내용은 보고서 가이드를 참고하세요.
list_data_sources 지정된 판매자의 데이터 소스를 나열합니다.
get_data_source 특정 데이터 소스의 세부정보를 가져옵니다.
create_data_source 지정된 판매자의 데이터 소스를 만듭니다.
fetch_data_source 특정 판매자의 데이터 소스와 연결된 파일을 가져와 처리합니다.
get_file_upload 지정된 데이터 소스의 최신 파일 업로드 상태를 가져옵니다.
list_accounts 지정된 사용자의 계정을 나열합니다.
list_account_issues 특정 판매자의 계정 수준 문제를 나열하여 계정 전체 문제를 식별합니다.
list_programs 참여 상태, 활성 지역, 충족되지 않은 요구사항 등 특정 판매자의 프로그램을 나열합니다.
list_aggregated_product_issues 집계된 제품 수준 문제를 나열하여 제품 데이터의 전반적인 상태를 모니터링합니다.
get_automatic_improvements 상품 업데이트, 이미지 개선, 배송 개선을 비롯한 자동 개선 설정을 가져옵니다.