MCP Reference: paydeveloper.googleapis.com

Pay 개발자에게 도구를 제공하는 MCP 서버입니다.

모델 컨텍스트 프로토콜 (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 서버 API 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 통합의 현재 상태 및 구성 세부정보를 반환합니다. 통합 상태 및 문서 검토에 관한 즉각적인 의견을 제공합니다. 또한 Google Pay 및 월렛 콘솔 (https://pay.google.com/business/console/)에서 통합을 만들거나 업데이트할 수 있음을 사용자에게 알려야 합니다.
create_merchant	인증된 계정으로 새 판매자를 만듭니다. 사용자에게 판매자 생성에 필요한 정보를 제공하도록 요청해야 합니다. 필수 필드 중 하나는 판매자 카테고리 코드 (MCC)입니다. MCC 목록이 길기 때문에 일반적인 옵션의 하위 집합을 표시할 수 있지만 더 많은 옵션을 사용할 수 있으며 전체 목록을 요청할 수 있음을 사용자에게 알려야 합니다 (예: '옵션 X개 더보기' 또는 유사한 힌트 표시). 또한 사용자가 이미 알고 있는 경우 4자리 MCC 코드 (예: 5499)를 직접 제공할 수 있다고 사용자에게 알리고 사용하도록 권장합니다. 판매자 생성에 필요한 정보를 수집하려고 시도할 때까지 이 도구를 호출하지 마세요. 판매자가 생성된 후에는 사용자에게 비즈니스 콘솔 서비스 약관 URL을 표시하고 이 판매자에 대해 어떠한 작업도 수행하기 전에 이를 수락하도록 안내해야 합니다.
list_pass_issuers	인증된 사용자와 연결된 Google 월렛 비즈니스 콘솔에 등록된 모든 패스 발급기관의 포괄적인 목록을 가져옵니다. 이 도구는 포인트 카드, 기프트 카드 또는 항공편과 같은 월렛 패스를 관리하는 개발자에게 필수 정보를 제공합니다.
list_pass_classes	인증된 사용자와 연결된 Google 월렛 비즈니스 콘솔에 등록된 모든 패스 클래스의 포괄적인 목록을 가져옵니다. 이 도구는 포인트 카드, 기프트 카드 또는 항공편과 같은 월렛 패스를 관리하는 개발자에게 필수 정보를 제공합니다.
validate_pass_jwt	패스의 JWT 표현 또는 패스의 JSON 문자열로 인코딩되지 않은 JWT 페이로드를 검증합니다.
query_merchant_performance	특정 판매자 비즈니스 프로필의 대략적인 집계 실적 데이터와 통합 후 측정항목을 가져옵니다.
query_merchant_error_metrics	특정 판매자 비즈니스 프로필의 세부 오류 측정항목을 가져옵니다. 이 도구는 오류를 세부적으로 분석하여 개발자가 문제를 정확히 파악하고 해결할 수 있도록 지원합니다.
update_merchant	기존 판매자의 특정 필드를 업데이트합니다. 지원되는 필드에는 display_name, mcc, corporate_website_url, customer_support_website_url, customer_support_email, customer_support_phone이 포함됩니다.
list_principals	특정 판매자에 액세스할 수 있는 주 구성원 (사용자)을 나열합니다. 이 작업을 수행하려면 판매자에 대한 관리자 액세스 권한이 필요합니다.
set_principal_role	판매자의 주 구성원 (사용자) 역할을 설정하거나 지정된 역할로 새 주 구성원을 추가합니다. 주 구성원에게 이메일 초대가 전송되며 액세스가 활성화되기 전에 이를 수락해야 합니다. 이 작업을 수행하려면 판매자에 대한 관리자 액세스 권한이 필요합니다.
delete_principal	특정 판매자에 대한 주 구성원 (사용자)의 액세스 권한을 삭제합니다. 이 작업을 수행하려면 판매자에 대한 관리자 액세스 권한이 필요합니다.

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 }'