모델 컨텍스트 프로토콜 (MCP) 서버는 대규모 언어 모델 (LLM) 또는 AI 애플리케이션에 컨텍스트, 데이터 또는 기능을 제공하는 외부 서비스 간의 프록시 역할을 합니다. MCP 서버는 AI 애플리케이션을 데이터베이스 및 웹 서비스와 같은 외부 시스템에 연결하여 응답을 AI 애플리케이션이 이해할 수 있는 형식으로 변환합니다.
서버 설정
사용하기 전에 MCP 서버를 사용 설정하고 인증을 설정해야 합니다. Google 및 Google Cloud 원격 MCP 서버 사용에 관한 자세한 내용은 Google Cloud MCP 서버 개요를 참고하세요.
서버 엔드포인트
MCP 서비스 엔드포인트는 AI 애플리케이션 (MCP 클라이언트의 호스트)이 보안 표준 연결을 설정하는 데 사용하는 MCP 서버의 네트워크 주소 및 통신 인터페이스 (일반적으로 URL)입니다. LLM이 컨텍스트를 요청하거나 도구를 호출하거나 리소스에 액세스하는 접점입니다. Google MCP 엔드포인트는 전역 또는 리전일 수 있습니다.
Google Pay 및 월렛 개발자 MCP 서버에는 다음과 같은 전역 MCP 엔드포인트가 있습니다.
- https://paydeveloper.googleapis.com/mcp
MCP 도구
MCP 도구는 MCP 서버가 LLM 또는 AI 애플리케이션에 노출하여 실제 세계에서 작업을 실행하는 함수 또는 실행 가능한 기능입니다.
도구
paydeveloper.googleapis.com MCP 서버에는 다음과 같은 도구가 있습니다.
| MCP 도구 | |
|---|---|
search_documentation |
공식 Google Pay 및 Google 월렛 개발자 문서와 코드 샘플에서 가장 관련성이 높고 최신 섹션을 검색하고 가져옵니다. |
list_merchants |
인증된 계정과 연결된 모든 Google Pay 판매자 비즈니스 프로필 목록을 가져옵니다. |
list_google_pay_integrations |
특정 판매자 ID와 연결된 모든 Google Pay 통합의 현재 상태 및 구성 세부정보를 반환합니다. 통합 및 문서 검토 상태에 관한 즉각적인 의견을 제공합니다. |
create_merchant |
인증된 계정으로 새 판매자를 만듭니다. 사용자에게 판매자 생성에 필요한 정보를 제공해 달라고 요청해야 합니다(MUST). 판매자 생성에 필요한 정보를 수집하려고 시도하기 전까지는 이 도구를 호출하지 마세요. 판매자가 생성된 후에는 사용자에게 비즈니스 콘솔 서비스 약관 URL을 표시하고 이 판매자에 대한 작업을 실행하기 전에 약관에 동의하도록 안내해야 합니다(MUST). |
create_google_pay_integration |
특정 판매자를 위한 Google Pay 통합을 만듭니다. 이 작업을 실행하려면 사용자가 비즈니스 콘솔 서비스 약관 및 Google Pay API 서비스 약관에 동의해야 합니다. 이러한 약관을 미리 확인할 필요는 없습니다. 동의하지 않은 경우 도구 호출이 실패하고 오류 메시지에 동의해야 하는 특정 서비스 약관 URL이 포함됩니다. 이 경우 사용자에게 동의를 위해 URL을 표시하고 동의한 후 다시 시도하도록 안내합니다. 도구를 호출하기 전에 다음 순서에 따라 사용자와 상호작용합니다. 1. 먼저 사용자에게 통합 항목을 요청합니다 (현재 웹 통합만 지원됨). - 웹사이트 URL을 요청합니다. # - 통합 항목이 앱 통합인 경우 Android 앱 패키지 이름을 요청합니다. 2. 그런 다음 사용자에게 통합 유형을 요청합니다. - 지원되는 결제 서비스 제공업체 (PSP: https://developers.google.com/pay/api#participating-processors) 중 하나를 사용하는 경우 게이트웨이를 선택하고, 그렇지 않은 경우 직접을 선택하도록 사용자에게 안내합니다. 3. 모든 통합 유형 (직접 또는 게이트웨이)의 경우: - 사용자에게 Google Pay API와 통합된 구매 과정의 스크린샷 (최대 1MB)을 업로드하도록 안내합니다. 전체 프로덕션 액세스 권한이 부여되려면 먼저 구매 과정을 검토하고 승인받아야 합니다. 예: https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together. - 사용자에게 지원 스크린샷 5개를 제공해 달라고 요청해야 합니다(MUST). 올바른 매핑을 위해 하나씩 요청합니다. 요청할 때는 사용자 친화적인 enum 설명만 사용합니다. 4. 통합 유형이 직접인 경우: - 사용자에게 PCI 증명 문서를 PDF 형식으로 제공해 달라고 요청해야 합니다(MUST). 요청할 때는 사용자 친화적인 enum 설명만 사용합니다. 5. 제공된 각 파일에 대해 사용자에게 현재 디렉터리에 있는 경우 문서 경로 또는 이름을 제공해 달라고 요청합니다. 요청에서 올바른 DocumentType에 매핑하고 이름 필드를 설명 이름 (예: item_selection.png 또는 pci_attestation.pdf)으로 설정합니다. 선택한 통합 유형에 필요한 문서를 수집하려고 시도하기 전까지는 이 도구를 호출하지 마세요. |
list_pass_issuers |
인증된 사용자와 연결된 Google 월렛 비즈니스 콘솔에 등록된 모든 패스 발급기관의 포괄적인 목록을 가져옵니다. 이 도구는 포인트 카드, 기프트 카드 또는 항공편과 같은 월렛 패스를 관리하는 개발자에게 필수 정보를 제공합니다. |
list_pass_classes |
인증된 사용자와 연결된 Google 월렛 비즈니스 콘솔에 등록된 모든 패스 클래스의 포괄적인 목록을 가져옵니다. 이 도구는 포인트 카드, 기프트 카드 또는 항공편과 같은 월렛 패스를 관리하는 개발자에게 필수 정보를 제공합니다. |
validate_pass_jwt |
패스의 JWT 표현 또는 패스의 JSON 문자열로 인코딩되지 않은 JWT 페이로드를 검증합니다. |
query_merchant_performance |
특정 판매자 비즈니스 프로필의 대략적인 집계 실적 데이터와 통합 후 측정항목을 가져옵니다. |
query_merchant_error_metrics |
특정 판매자 비즈니스 프로필의 자세한 오류 측정항목을 가져옵니다. 이 도구는 오류를 세부적으로 분석하여 개발자가 문제를 정확히 파악하고 해결할 수 있도록 지원합니다. |
MCP 도구 사양 가져오기
MCP 서버의 모든 도구에 대한 MCP 도구 사양을 가져오려면 tools/list 메서드를 사용하세요. 다음 예시에서는 curl을 사용하여 MCP 서버 내에서 현재 사용할 수 있는 모든 도구와 사양을 나열하는 방법을 보여줍니다.
| curl 요청 |
|---|
curl --location 'https://paydeveloper.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/list", "jsonrpc": "2.0", "id": 1 }' |