MCP를 사용하는 API 통합 및 코드 어시스트 툴킷

선택한 코딩 어시스턴트에서 Merchant API에 관한 컨텍스트 인텔리전스를 가져옵니다. 이제 통합 개발 환경 (IDE) 내에서 모델 컨텍스트 프로토콜 (MCP) 서비스를 사용하여 개발자 문서 통합에 액세스할 수 있습니다. 이 서비스는 공식 Google API 참고 리소스의 신뢰할 수 있는 컨텍스트를 코딩 어시스턴트에 제공하여 통합 및 이전 워크플로의 개발 속도를 높입니다.

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

개요

Content API for Shopping에서 Merchant API로 이전하거나 새로운 통합을 빌드할 때는 새로운 서비스 구조, 리소스 이름, 메서드를 이해해야 합니다. MCP 서비스는 코딩 어시스턴트에 공식 문서와 코드 샘플을 제공하여 이 작업을 간소화합니다.

이 서비스는 고도로 전문화된 검색 증강 생성 (RAG) 백엔드를 활용합니다. MCP 지원 IDE 코딩 어시스턴트에 Merchant API에 관한 질문을 하면 이 서비스는 Google의 공식 리소스에서 가장 관련성이 높은 텍스트 및 코드 스니펫을 검색하여 코딩 어시스턴트에 컨텍스트로 반환합니다. 이렇게 하면 개발 환경을 벗어나지 않고도 어시스턴트가 정확하고 최신 답변을 제공할 수 있습니다.

작동 방식

MCP를 사용하는 개발자 문서 통합은 최신 AI 지원 개발 워크플로에 통합됩니다.

  1. MCP 호환 코딩 어시스턴트 또는 에이전트에서 질문합니다. 자연어 질문, Merchant API 코드 샘플 요청 또는 코드를 Merchant API로 직접 변환하는 요청일 수 있습니다.
  2. 코딩 어시스턴트가 MCP 엔드포인트에 컨텍스트 요청을 전송합니다.
  3. MCP 서비스는 색인이 생성된 공식 Merchant API 문서, 가이드, 코드 샘플 모음을 검색하여 가장 관련성이 높은 정보를 찾습니다.
  4. 이 서비스는 이러한 신뢰할 수 있는 스니펫을 코딩 어시스턴트에 컨텍스트로 반환합니다.
  5. 코딩 어시스턴트는 이 고품질 컨텍스트를 사용하여 원래 질문에 대한 정확하고 유용한 답변을 생성하거나 코드 변환 작업을 실행합니다.

시작하기

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"

구성 설정:

Antigravity

Antigravity 문서의 안내를 따르세요.

{
    "mcpServers": {
        "mapi-devdocs": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote",
                "https://merchantapi.googleapis.com/devdocs/mcp"
            ]
        }
    }
}

Visual Studio Code

Visual Studio Code 문서의 안내를 따르세요.

{
    "servers": {
        "mapi-devdocs": {
            "type": "http",
            "url": "https://merchantapi.googleapis.com/devdocs/mcp/"
        }
    }
}

3. 에이전트 안내 추가 (선택사항)

에이전트가 MCP를 사용하여 코드를 직접 변환하도록 하려면 시스템 안내: MerchantIntegrator 에이전트 프로토콜을 제공하세요. 이러한 안내는 에이전트가 코드 변환을 위해 MCP를 올바르게 활용하는 방법을 안내합니다. 도구에 따라 시스템 안내 구성 또는 에이전트의 추가 컨텍스트 파일로 이러한 안내를 제공할 수 있습니다.

사용 시나리오 예

MCP는 이러한 일반적인 사용 사례에서 워크플로를 가속화할 수 있습니다.

시나리오 1: products.insert 코드 이전

에이전트에게 Content API for Shopping products.insert 통합 코드를 Merchant API로 직접 이전하도록 요청할 수 있습니다.

사용자 프롬프트:

'products.insert 코드를 Merchant API로 이전해 줘'

에이전트에 시스템 안내: MerchantIntegrator 에이전트 프로토콜 과 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 및 인벤토리 관련 필드만 포함된 부분 제품 리소스를 제공할 수 있습니다.

'Merchant 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 서비스는 동시 요청을 위한 코드 리팩터링 에서 컨텍스트를 검색하여 Merchant API에는 전용 custombatch 메서드가 없음을 설명합니다. 대신 Content-Type이 multipart인 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 서비스는 제공하는 컨텍스트가 정확하고 신뢰할 수 있도록 공개 및 공식 소스에서만 기술 자료를 빌드합니다. 이 서비스는 다음을 비롯한 공식 개발자 사이트 및 코드 샘플 저장소의 전체 콘텐츠에 색인을 생성합니다.