Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

Google Pay 및 월렛 개발자 MCP 서버에 연결

Google Pay 및 월렛 개발자 MCP 서버를 사용하면 AI 기반 개발 도구에서 Google Pay 및 Google 월렛 개발자 데이터에 액세스하고, 공식 문서를 검색하고, 통합을 관리할 수 있습니다.

모델 컨텍스트 프로토콜 (MCP)은 대규모 언어 모델 (LLM)과 AI 애플리케이션 또는 에이전트가 외부 데이터 소스에 연결되는 방식을 표준화합니다. MCP 서버를 사용하면 도구, 리소스, 프롬프트를 사용하여 작업을 수행하고 백엔드 서비스에서 업데이트된 데이터를 가져올 수 있습니다.

Google Pay 및 월렛 개발자 MCP 서버를 사용하면 다음 작업을 할 수 있습니다.

문서 검색: 공식 Google Pay 및 Google 월렛 문서에서 최신 가이드와 코드 샘플을 가져옵니다.
통합 관리: 통합 상태를 확인하고 판매자 계정의 API를 사용 설정합니다.
실적 모니터링: 판매자 계정의 집계된 실적 데이터와 오류 측정항목에 액세스합니다.
패스 관리: Google 월렛의 패스 발급기관 및 클래스를 나열합니다.

참고: 사용 가능한 MCP 도구 및 설명의 세부정보를 보려면 Pay & Wallet Developer 참조를 확인하세요.

샘플 프롬프트

AI 어시스턴트에서 다음 프롬프트를 사용할 수 있습니다.

'내 Google Pay 계정을 나열해 줘.'
'내 Google Pay 통합 상태는 어떻게 돼?'
'Google Pay를 React와 통합하려면 어떻게 해야 해?'
'지난 30일 동안 내 통합의 Google Pay 오류 측정항목을 보여 줘.'
'내 Google 월렛 패스 클래스를 나열해 줘.'

시작하기 전에

Google Pay 및 월렛 개발자 MCP 서버를 사용하려면 Google Cloud 프로젝트를 만들고 Google Pay 및 월렛 개발자 MCP 서버를 사용 설정해야 합니다.

Cloud 콘솔의 프로젝트 선택기 페이지에서 Google Cloud 프로젝트를 선택하거나 만듭니다.

프로젝트 선택기로 이동
Pay &Wallet Developer API를 사용 설정합니다.
API 사용 설정에 필요한 역할
API를 사용 설정하려면 serviceusage.services.enable 권한이 필요합니다. 프로젝트를 만든 경우 소유자 역할 (roles/owner)을 통해 이 권한이 이미 있을 가능성이 높습니다. 그렇지 않은 경우 서비스 사용량 관리자 역할 (roles/serviceusage.serviceUsageAdmin)을 통해 이 권한을 얻을 수 있습니다. 역할 부여 방법을 알아보세요.
API 사용 설정

필요한 역할

Google Pay 및 월렛 개발자 MCP 서버 원격 MCP 서버를 사용하는 데 필요한 권한을 얻으려면 관리자에게 Google Pay 및 월렛 개발자 MCP 서버를 사용 설정하려는 Google Cloud 프로젝트에 대한 다음 Identity and Access Management (IAM) 역할을 부여해 달라고 요청하세요.

MCP 도구 호출: MCP 도구 사용자 (roles/mcp.toolUser)

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 및 조직에 대한 액세스 관리를 참조하세요.

인증 및 승인

Google Pay 및 월렛 개발자 MCP 서버는 인증 및 승인을 위해 Identity and Access Management (IAM)와 함께 OAuth 2.0 프로토콜을 사용합니다. 모든 ID는 MCP 서버 인증에 지원됩니다.

Google Pay 및 월렛 개발자 MCP 서버는 API 키를 허용하지 않습니다.

리소스에 대한 액세스를 제어하고 모니터링할 수 있도록 MCP 도구를 사용하는 에이전트를 위한 별도의 ID를 만드는 것이 좋습니다. 인증에 대한 자세한 내용은 MCP 서버 인증을 참조하세요.

Google Pay 및 월렛 개발자 MCP 서버 OAuth 범위

OAuth 2.0은 범위와 사용자 인증 정보를 사용하여 인증된 주 구성원이 리소스에 대해 특정 작업을 수행할 권한이 있는지 확인합니다. Google의 OAuth 2.0 범위에 대한 자세한 내용은 OAuth 2.0을 사용하여 Google API에 액세스를 참조하세요.

Google Pay 및 월렛 개발자 MCP 서버에는 다음과 같은 MCP 도구 OAuth 범위가 있습니다.

gcloud CLI의 범위 URI	설명
`https://www.googleapis.com/auth/paydeveloper.merchant`	Google Pay 판매자 데이터를 관리합니다.
`https://www.googleapis.com/auth/paydeveloper.issuer.readonly`	Google 월렛 발급기관 데이터를 읽습니다.

OAuth 2.0 클라이언트 ID 및 보안 비밀 만들기

OAuth 2.0 클라이언트 ID 및 보안 비밀을 만들려면 다음 단계를 따르세요.

Google API 콘솔에서 Google 인증 플랫폼 > 클라이언트 > 클라이언트 만들기 로 이동합니다.

클라이언트 만들기로 이동

아직 애플리케이션이 없는 경우 Google 인증 플랫폼에서 새 애플리케이션을 만들어야 합니다. 개요 페이지에서 '시작하기' 버튼을 클릭하고 필요한 정보를 입력합니다.
애플리케이션 유형 목록에서 AI 애플리케이션에 적합한 유형을 선택합니다.
- Cursor Desktop, Claude Code, Claude.ai, ChatGPT, Antigravity의 경우 웹 애플리케이션을 선택합니다.
- Antigravity CLI, Antigravity IDE, VS Code의 경우 데스크톱 앱을 선택합니다.
이름 필드에 애플리케이션 이름을 입력합니다.
**웹 애플리케이션** 을 선택한 경우 **승인된 리디렉션 URI** 섹션에서 **\+ URI 추가** 를 클릭한 후 AI 애플리케이션에 필요한 리디렉션 URI를 추가합니다.
Cursor Desktop

http://localhost:8787/callback
Claude Code
http://localhost:CLAUDE_REDIRECT_PORT/callback
Claude.ai

https://claude.ai/api/mcp/auth_callback

ChatGPT

지금은 redirect_uri를 비워 두어도 됩니다. ChatGPT는 앱이 생성될 때 redirect_uri를 생성합니다 (아래의 AI 애플리케이션 구성 참고).

참고: 승인된 JavaScript 출처 섹션에서 + URI 추가를 클릭한 후 URI 필드에 https://chatgpt.com을 추가합니다.

Antigravity

https://antigravity.google/oauth-callback
만들기 를 클릭합니다. 생성 시 클라이언트 보안 비밀번호가 한 번 표시됩니다. 보안 비밀번호를 복사하여 안전하게 저장합니다.

AI 애플리케이션 구성

다음으로 AI 애플리케이션에 서버 구성 세부정보를 제공해야 합니다.

VS Code

채팅 측면 패널 상단에서 아이콘을 클릭하고 MCP 서버 로 이동합니다.
서버 추가 버튼(add)을 클릭하고 HTTP를 선택한 후 Pay & Wallet Developer MCP 서버를 가리키는 URL(https://paydeveloper.googleapis.com/mcp)을 입력합니다.
MCP 구성은 작업공간의 .vscode/mcp.json 파일에 저장됩니다.
```
{
  "servers": {
    "google-pay-wallet-dev": {
      "url": "https://paydeveloper.googleapis.com/mcp"
    }
  }
}
```
새 MCP 서버를 마우스 오른쪽 버튼으로 클릭하고 서버 시작 을 선택합니다.
채팅 창으로 돌아가서 MCP 서버에서 도구를 호출하여 인증 프로세스를 트리거합니다. 예: '내 Google Pay 계정 나열해 줘'
예상대로 동적 클라이언트 등록 이 지원되지 않는 대화상자가 열립니다. 버튼을 클릭하여 대화상자를 닫습니다.
OAuth 클라이언트 ID 를 입력하고 Enter 키를 누릅니다.
메시지가 표시되면 OAuth 클라이언트 보안 비밀번호 를 입력하고 Enter 키를 누릅니다.
인증 대화상자가 열리면 허용 을 클릭합니다.
인증된 ID 목록에서 선택하거나 새 계정으로 로그인할 수 있습니다.
인증 후 도구가 호출되고 채팅 창에서 세션이 계속됩니다.

Cursor Desktop

Cursor Desktop을 구성하려면 다음 안내를 따르세요.

왼쪽 측면 패널에서 맞춤설정 을 클릭합니다.
새 MCP 서버 를 클릭합니다. mcp.json 구성 파일이 열립니다.

구성 세부정보를 입력하여 Google Pay 및 월렛 개발자 MCP 서버를 추가합니다.

{
  "mcpServers": {
    "google-pay-wallet-dev": {
      "url": "https://paydeveloper.googleapis.com/mcp",
      "auth": {
        "CLIENT_ID": "CURSOR_DESKTOP_CLIENT_ID",
        "CLIENT_SECRET": "CURSOR_DESKTOP_CLIENT_SECRET"
      }
    }
  }
}

파일을 저장하면 MCP 서버 목록이 업데이트됩니다.
인증 을 클릭하여 인증 프로세스를 시작합니다.

Claude Code

Claude Code를 구성하려면 다음 명령어를 실행합니다.

MCP_CLIENT_SECRET=CLAUDE_CODE_CLIENT_SECRET claude mcp add --transport http \
  --client-id CLAUDE_CODE_CLIENT_ID --client-secret --callback-port CLAUDE_REDIRECT_PORT \
  google-pay-wallet-dev https://paydeveloper.googleapis.com/mcp

Claude.ai

Claude.ai를 구성하려면 다음 안내를 따르세요.

맞춤설정 > 커넥터 로 이동합니다.
추가 를 클릭하고 커스텀 커넥터 추가 를 선택합니다.
다음 세부정보를 입력합니다.
고급 설정 에서 OAuth 클라이언트 ID 와 OAuth 클라이언트 보안 비밀번호 를 입력합니다.
새 커넥터를 선택하고 연결 을 클릭합니다.

ChatGPT

ChatGPT를 구성하려면 다음 안내를 따르세요.

설정 > 보안 및 로그인 에서 개발자 모드 를 사용 설정합니다.
기본 측면 패널에서 플러그인을 선택하고 버튼을 클릭합니다.
다음 세부정보를 입력합니다.
고급 설정으로 이동하여 OAuth 클라이언트 ID와 보안 비밀번호를 입력합니다.
동적 콜백 URL을 복사하여 이전 단계에서 만든 OAuth 클라이언트에 추가합니다.

Antigravity CLI

Antigravity CLI를 구성하려면 ~/.gemini/config/mcp_config.json 파일에 다음을 추가합니다.

{
  "mcpServers": {
    "google-pay-wallet-dev": {
      "serverUrl": "https://paydeveloper.googleapis.com/mcp",
      "oauth": {
        "clientId": "AGY_CLI_CLIENT_ID",
        "clientSecret": "AGY_CLI_CLIENT_SECRET"
      }
    }
  }
}

/mcp를 실행하고 새 MCP 서버를 선택한 후 인증 을 선택하여 인증 프로세스를 시작합니다.

Antigravity IDE

편집기의 에이전트 측면 패널 상단에서 를 클릭하고 MCP 서버를 선택합니다.
MCP 서버 관리 를 클릭합니다.

원시 구성 보기 를 클릭하고 MCP 서버 세부정보를 추가합니다.

{
  "mcpServers": {
    "google-pay-wallet-dev": {
      "serverUrl": "https://paydeveloper.googleapis.com/mcp",
      "oauth": {
        "clientId": "ANTIGRAVITY_IDE_CLIENT_ID",
        "clientSecret": "ANTIGRAVITY_IDE_CLIENT_SECRET"
      }
    }
  }
}

Antigravity IDE로 돌아가서 새로고침 을 클릭합니다.
새 MCP 서버를 선택하고 인증 을 클릭한 후 인증 흐름을 완료합니다.
승인 코드를 복사하여 Antigravity 설정 창에 제출합니다.

Antigravity

Antigravity에서 설정 > 맞춤설정으로 이동합니다.

설치된 MCP 서버 섹션에서 MCP 구성 열기를 클릭하여 mcp_config.json 파일을 수정합니다.

{
  "mcpServers": {
    "google-pay-wallet-dev": {
      "serverUrl": "https://paydeveloper.googleapis.com/mcp",
      "oauth": {
        "clientId": "ANTIGRAVITY_CLIENT_ID",
        "clientSecret": "ANTIGRAVITY_CLIENT_SECRET"
      }
    }
  }
}

Antigravity로 돌아가서 새로고침 을 클릭합니다.
인증 을 클릭하고 인증 흐름을 완료합니다.
승인 코드를 복사하여 Antigravity 설정 창에 제출합니다.

알려진 제한사항

영어로만 제공되는 결과: 문서 검색은 영어만 지원합니다.
ACL 뒤의 콘텐츠: ACL 뒤의 문서는 색인이 생성되지 않습니다.
네트워크 종속: 서버에는 Google Pay 및 월렛 서비스에 대한 실시간 연결이 필요합니다.

서비스 약관

Google Pay API 사용에는 Google Pay API 서비스 약관이 적용됩니다. Google 월렛 API 사용에는 Google 월렛 API 서비스 약관이 적용됩니다.

Google Pay 및 월렛 개발자 MCP 서버에 연결 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

샘플 프롬프트

시작하기 전에

필요한 역할

인증 및 승인

Google Pay 및 월렛 개발자 MCP 서버 OAuth 범위

OAuth 2.0 클라이언트 ID 및 보안 비밀 만들기

Cursor Desktop

Claude Code

Claude.ai

ChatGPT

Antigravity

AI 애플리케이션 구성

VS Code

Cursor Desktop

Claude Code

Claude.ai

ChatGPT

Antigravity CLI

Antigravity IDE

Antigravity

알려진 제한사항

서비스 약관

Google Pay 및 월렛 개발자 MCP 서버에 연결