선택한 코딩 어시스턴트에서 판매자 API에 관한 컨텍스트 정보를 확인합니다. 이제 통합 개발 환경 (IDE) 내에서 모델 컨텍스트 프로토콜 (MCP) 서비스를 사용하여 개발자 문서 통합에 액세스할 수 있습니다. 이 서비스는 공식 Google API 문서에서 코딩 어시스턴트에게 공신력 있는 컨텍스트를 제공하여 통합 및 이전 워크플로 개발을 가속화합니다.
프로토콜 자체에 대한 자세한 내용은 모델 컨텍스트 프로토콜 표준을 참고하세요.
개요
Content API for Shopping에서 Merchant API로 이전하거나 새로운 통합을 빌드할 때는 새로운 서비스 구조, 리소스 이름, 메서드를 이해해야 합니다. MCP 서비스는 공식 문서와 코드 샘플을 코딩 어시스턴트에 제공하여 이 과정을 간소화합니다.
이 서비스는 고도로 전문화된 검색 증강 생성 (RAG) 백엔드를 활용합니다. MCP 지원 IDE 코딩 어시스턴트에게 Merchant API에 관해 질문하면 서비스가 Google의 공식 리소스에서 가장 관련성 높은 텍스트 및 코드 스니펫을 가져와 코딩 어시스턴트에게 컨텍스트로 반환합니다. 이를 통해 개발 환경을 벗어나지 않고도 어시스턴트가 정확하고 최신 답변을 제공할 수 있습니다.
작동 방식
MCP를 사용한 개발자 문서 통합은 다음과 같은 최신 AI 지원 개발 워크플로에 통합됩니다.
- MCP 호환 코딩 어시스턴트 또는 에이전트에서 질문합니다. 자연어 질문, Merchant API 코드 샘플 요청, 코드를 Merchant API로 직접 번역해 달라는 요청도 가능합니다.
- 코딩 어시스턴트가 컨텍스트 요청을 MCP 엔드포인트로 전송합니다.
- MCP 서비스는 색인이 생성된 공식 Merchant API 문서, 가이드, 코드 샘플 컬렉션을 검색하여 가장 관련성 높은 정보를 찾습니다.
- 서비스는 이러한 공신력 있는 스니펫을 코딩 어시스턴트의 컨텍스트로 반환합니다.
- 코딩 어시스턴트는 이 고품질 컨텍스트를 사용하여 원래 질문에 대한 정확하고 유용한 답변을 생성하거나 코드 변환 작업을 실행합니다.
시작하기
MCP를 사용하려면 다음 단계를 따르세요.
1. 호환되는 도구 사용
스트리밍 가능한 HTTP 전송을 사용하여 모델 컨텍스트 프로토콜을 지원하는 IDE 또는 코딩 어시스턴트를 엽니다.
2. 엔드포인트 구성
IDE 또는 코딩 어시스턴트를 MCP에 연결하려면 제공된 원격 엔드포인트 세부정보를 사용하세요. 도구의 구성에 따라 직접 서비스 URL 또는 MCP 정의를 입력해야 할 수 있습니다.
서비스 URL은 다음과 같습니다.
MCP Server Name: "MAPI Docs MCP"
MCP Server URL: "https://merchantapi.googleapis.com/devdocs/mcp/"
MCP Server Protocol: "http"
3. 에이전트 안내 추가 (선택사항)
에이전트가 MCP를 사용하여 코드를 직접 번역할 수 있도록 하려면 시스템 요청 사항: MerchantIntegrator 에이전트 프로토콜을 제공하세요. 이 안내는 상담사에게 코드 번역을 위해 MCP를 올바르게 활용하는 방법을 안내합니다. 도구에 따라 시스템 안내 구성에서 또는 에이전트의 추가 컨텍스트 파일로 이러한 안내를 제공할 수 있습니다.
사용 시나리오 예시
MCP는 다음과 같은 일반적인 사용 사례에서 워크플로를 가속화할 수 있습니다.
시나리오 1: products.insert 코드 이전
에이전트에게 Content API for Shopping products.insert 통합 코드를 Merchant API로 직접 이전해 달라고 요청할 수 있습니다.
사용자 프롬프트:
'
products.insert코드를 Merchant API로 이전'
에이전트에게 시스템 지침: MerchantIntegrator Agent Protocol과 MCP 액세스 권한을 제공하면 에이전트가 IDE에서 Content API for Shopping 코드를 Merchant API 코드로 직접 변환할 수 있습니다. 이 경우 productInputs.insert을 동등한 호출로 식별하고 이전 형식의 제품 속성을 Merchant API에 필요한 새 형식으로 매핑합니다. 필요한 가져오기 및 종속 항목 관리 파일 (예: requirements.txt, pom.xml 또는 package.json)을 업데이트할 수도 있습니다. 에이전트가 변경사항을 적용하거나 새 폴더를 만들도록 지시할 수 있습니다.
시나리오 2: 동등한 기능 찾기
Content API for Shopping을 사용하는 기존 애플리케이션이 있으며 이를 업데이트해야 합니다. 특정 기존 메서드에 관해 질문하여 새로운 구현과 관련 코드 샘플에 관한 세부정보를 확인할 수 있습니다.
사용자 프롬프트:
'Content API for Shopping의 accountstatuses.get 메서드에 해당하는 Merchant API는 무엇인가요?'
MCP 서비스는 공식 이전 가이드와 참조 문서의 컨텍스트를 제공하므로 어시스턴트가 새 API 이름(accounts.issues)을 포함한 자세한 답변을 제공할 수 있습니다.
시나리오 3: 코드 샘플 찾기
새 기능을 구현하고 있으며 따라야 할 실제 예가 필요합니다.
사용자 프롬프트:
'Merchant API를 사용하여 새 배송 서비스를 추가하는 Python 코드 샘플을 보여 줘.'
MCP 서비스는 공식 Google GitHub 저장소 및 개발자 가이드에서 관련 코드 샘플을 가져옵니다. 그러면 어시스턴트가 적응할 준비가 된 완전한 코드 블록을 표시할 수 있습니다.
시나리오 4: API 개념 이해
새로운 개념을 접하거나 리소스의 구조 또는 전체 Merchant API 패턴을 이해하고 싶습니다.
사용자 프롬프트:
'Merchant API를 사용하여 제품의 인벤토리를 업데이트하려면 어떻게 해야 하나요?'
MCP 서비스는 제품 리소스 문서와 관련 가이드에서 컨텍스트를 반환합니다. 그러면 어시스턴트가 accounts.productInputs.insert 메서드 사용 방법을 설명하고 업데이트해야 하는 productId 및 인벤토리 관련 필드만 포함된 부분 제품 리소스를 제공할 수 있습니다.
'판매자 API로 애플리케이션 호출을 승인하려면 어떻게 해야 하나요?'
MCP 서비스는 다양한 승인 방법을 다루는 공식 인증 가이드에서 컨텍스트를 가져옵니다. 그러면 어시스턴트가 서버 간 상호작용에 서비스 계정을 사용하거나 사용자를 대신하여 작업할 때 OAuth 2.0 클라이언트 ID를 사용하는 등 사용 가능한 기본 옵션을 설명할 수 있습니다.
시나리오 5: API 변경사항에 적응
Merchant API에는 Content API for Shopping과 다른 요청 일괄 처리와 같은 새로운 패턴이 도입되었습니다. Content API for Shopping은 특정 custombatch 메서드를 사용하는 반면 Merchant API는 내장된 일반 HTTP 일괄 처리 기능을 사용합니다.
사용자 프롬프트:
'Merchant API에서 products.custombatch를 실행하는 새로운 방법은 무엇인가요?'
MCP 서비스는 동시 요청을 위한 코드 리팩터링에서 컨텍스트를 가져와 전용 custombatch 메서드가 Merchant API에 없다고 설명합니다.
대신 multipart의 Content-Type를 사용하여 HTTP 일괄 처리를 사용하는 방법에 관한 문서를 제공합니다. 그러면 어시스턴트가 https://merchantapi.googleapis.com/batch/{sub-api}/v1 엔드포인트로 전송되는 여러 API 호출이 포함된 단일 HTTP 요청을 구성하는 방법을 설명하고 멀티파트 요청을 구조화하는 방법을 예로 보여줄 수 있습니다. 이렇게 하면 혼동을 일으킬 수 있는 마이그레이션 작업이 안내 프로세스로 바뀝니다.
시나리오 6: 보고 쿼리 번역
Content API for Shopping의 보고 쿼리를 Merchant API로 번역해 달라고 에이전트에게 요청할 수 있습니다.
사용자 프롬프트:
'이 보고 쿼리를 Content API에서 Merchant API로 이전해 줘. SELECT metrics.impressions, metrics.clicks, metrics.ctr FROM MerchantPerformanceView WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-30''
MCP 서비스는 최신 보고 참조 문서, 개발자 가이드, 이전 가이드를 가져옵니다. 이 정보를 기반으로 쿼리를 새 구조로 변환하고 필드를 새 이름과 값으로 업데이트합니다.
기술 자료 소스
MCP 서비스는 제공하는 컨텍스트가 정확하고 신뢰할 수 있도록 공개 및 공식 소스에서만 지식 베이스를 구축합니다. 이 서비스는 다음을 비롯한 공식 개발자 사이트와 코드 샘플 저장소의 전체 콘텐츠를 색인합니다.
- 판매자 API 개발자 사이트: 모든 가이드, 참조 자료, 문서
- Merchant API Apps Script 서비스: Apps Script에서 Merchant API를 사용하는 예입니다.
- 공식 코드 샘플: GitHub 저장소의 Merchant API에 대해 Google에서 제공하는 모든 공식 코드 샘플입니다.
- 클라이언트 라이브러리: 판매자가 지원하는 모든 공식 클라이언트 라이브러리