선택한 코딩 어시스턴트에서 판매자 API에 관한 컨텍스트 정보를 확인합니다. 이제 통합 개발 환경 (IDE) 내에서 모델 컨텍스트 프로토콜 (MCP) 서비스를 사용하여 개발자 문서 통합에 액세스할 수 있습니다. 이 서비스는 공식 Google API 문서에서 코딩 어시스턴트에게 공신력 있는 컨텍스트를 제공하여 통합 및 이전 워크플로 개발을 가속화합니다.
프로토콜 자체에 대한 자세한 내용은 모델 컨텍스트 프로토콜 표준을 참고하세요.
개요
Content API for Shopping에서 Merchant API로 이전하거나 새로운 통합을 빌드할 때는 새로운 서비스 구조, 리소스 이름, 메서드를 이해해야 합니다. MCP 서비스는 공식 문서와 코드 샘플을 코딩 어시스턴트에 제공하여 이 과정을 간소화합니다.
이 서비스는 고도로 전문화된 검색 증강 생성 (RAG) 백엔드를 활용합니다. MCP 지원 IDE 코딩 어시스턴트에게 Merchant API에 관해 질문하면 서비스가 Google의 공식 리소스에서 가장 관련성 높은 텍스트 및 코드 스니펫을 가져와 코딩 어시스턴트에게 컨텍스트로 반환합니다. 이를 통해 개발 환경을 벗어나지 않고도 어시스턴트가 정확하고 최신 답변을 제공할 수 있습니다.
작동 방식
MCP를 사용한 개발자 문서 통합은 다음과 같은 최신 AI 지원 개발 워크플로에 통합됩니다.
- MCP 호환 코딩 어시스턴트 또는 에이전트에서 질문합니다. 자연어 질문이나 판매자 API 메서드 구현을 위한 코드 샘플 요청일 수 있습니다.
- 코딩 어시스턴트가 컨텍스트 요청을 MCP 엔드포인트로 전송합니다.
- MCP 서비스는 색인이 생성된 공식 Merchant API 문서, 가이드, 코드 샘플 컬렉션을 검색하여 가장 관련성 높은 정보를 찾습니다.
- 서비스는 이러한 공신력 있는 스니펫을 코딩 어시스턴트의 컨텍스트로 반환합니다.
- 코딩 어시스턴트는 이 고품질 컨텍스트를 사용하여 원래 질문에 대한 정확하고 유용한 답변을 생성합니다.
시작하기
MCP를 사용하려면 스트리밍 가능한 HTTP 전송을 사용하여 모델 컨텍스트 프로토콜을 지원하는 IDE 또는 코딩 어시스턴트가 필요합니다.
엔드포인트 구성
도구를 서비스에 연결하려면 제공된 원격 엔드포인트 세부정보를 사용하세요. 도구의 구성에 따라 직접 서비스 URL 또는 MCP 정의를 입력해야 할 수 있습니다.
서비스 URL은 다음과 같습니다.
MCP Server Name: "MAPI Docs MCP"
MCP Server URL: "https://merchantapi.googleapis.com/devdocs/mcp/"
사용 시나리오 예시
MCP는 다음과 같은 일반적인 사용 사례에서 워크플로를 가속화할 수 있습니다.
시나리오 1: 기존 API 호출 마이그레이션
Content API for Shopping을 사용하는 기존 애플리케이션이 있으며 이를 업데이트해야 합니다. 특정 기존 메서드에 관해 질문하여 새로운 구현과 관련 코드 샘플에 관한 세부정보를 확인할 수 있습니다.
사용자 프롬프트:
'Content API for Shopping의 accountstatuses.get 메서드에 해당하는 Merchant API는 무엇인가요?'
MCP 서비스는 공식 이전 가이드와 참조 문서의 컨텍스트를 제공하므로 어시스턴트가 새 API 이름(accounts.issues)을 포함한 자세한 답변을 제공할 수 있습니다.
시나리오 2: 코드 샘플 찾기
새 기능을 구현하고 있으며 따라야 할 실제 예가 필요합니다.
사용자 프롬프트:
'Merchant API를 사용하여 새 배송 서비스를 추가하는 Python 코드 샘플을 보여 줘.'
MCP 서비스는 공식 Google GitHub 저장소 및 개발자 가이드에서 관련 코드 샘플을 가져옵니다. 그러면 어시스턴트가 적응할 준비가 된 완전한 코드 블록을 표시할 수 있습니다.
시나리오 3: API 개념 이해
새로운 개념을 접하거나 리소스의 구조 또는 전체 Merchant API 패턴을 이해하고 싶습니다.
사용자 프롬프트:
'Merchant API를 사용하여 제품의 인벤토리를 업데이트하려면 어떻게 해야 하나요?'
MCP 서비스는 제품 리소스 문서와 관련 가이드에서 컨텍스트를 반환합니다. 그러면 어시스턴트가 accounts.productInputs.insert 메서드 사용 방법을 설명하고 업데이트해야 하는 productId 및 인벤토리 관련 필드만 포함된 부분 제품 리소스를 제공할 수 있습니다.
'판매자 API로 애플리케이션 호출을 승인하려면 어떻게 해야 하나요?'
MCP 서비스는 다양한 승인 방법을 다루는 공식 인증 가이드에서 컨텍스트를 가져옵니다. 그러면 어시스턴트가 서버 간 상호작용에 서비스 계정을 사용하거나 사용자를 대신하여 작업할 때 OAuth 2.0 클라이언트 ID를 사용하는 등 사용 가능한 기본 옵션을 설명할 수 있습니다.
시나리오 4: 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 요청을 구성하는 방법을 설명하고 멀티파트 요청을 구조화하는 방법을 예로 보여줄 수 있습니다. 이렇게 하면 혼동을 일으킬 수 있는 마이그레이션 작업이 안내 프로세스로 바뀝니다.
기술 자료 소스
MCP 서비스는 제공하는 컨텍스트가 정확하고 신뢰할 수 있도록 공개 및 공식 소스에서만 지식 베이스를 구축합니다. 이 서비스는 다음을 비롯한 공식 개발자 사이트와 코드 샘플 저장소의 전체 콘텐츠를 색인합니다.
- Merchant API 개발자 사이트: 모든 가이드, 참조 자료, 문서
- Merchant API Apps Script 서비스: Apps Script에서 Merchant API를 사용하는 예입니다.
- 공식 코드 샘플: GitHub 저장소의 Merchant API에 대해 Google에서 제공하는 모든 공식 코드 샘플입니다.
- 클라이언트 라이브러리: 판매자가 지원하는 모든 공식 클라이언트 라이브러리