Это MCP-сервер, на котором размещены инструменты для выплаты средств разработчикам.
Сервер Model Context Protocol (MCP) выступает в качестве прокси-сервера между внешним сервисом, который предоставляет контекст, данные или возможности большой языковой модели (LLM) или ИИ-приложению. MCP-серверы подключают ИИ-приложения к внешним системам, таким как базы данных и веб-сервисы, и преобразуют их ответы в формат, понятный ИИ-приложению.
Настройка сервера
Прежде чем использовать MCP-серверы, их необходимо включить и настроить аутентификацию. Подробнее об использовании удаленных MCP-серверов Google и Google Cloud рассказывается в обзоре MCP-серверов Google Cloud.
Конечные точки сервера
Конечная точка сервиса MCP – это сетевой адрес и интерфейс связи (обычно URL) MCP-сервера, который приложение ИИ (хост для клиента MCP) использует для установления безопасного стандартизированного подключения. Это точка контакта для LLM, чтобы запросить контекст, вызвать инструмент или получить доступ к ресурсу. Конечные точки Google MCP могут быть глобальными или региональными.
У MCP-сервера Google Pay и Кошелька для разработчиков есть следующая глобальная конечная точка MCP:
- https://paydeveloper.googleapis.com/mcp
Инструменты MCP
Инструмент MCP – это функция или исполняемый код, который MCP-сервер предоставляет LLM или приложению на основе ИИ для выполнения действий в реальном мире.
Инструменты
На MCP-сервере paydeveloper.googleapis.com есть следующие инструменты:
| Инструменты MCP | |
|---|---|
search_documentation |
Поиск и извлечение наиболее актуальных разделов из официальной документации для разработчиков Google Pay и Google Кошелька, а также примеров кода. |
list_merchants |
Получает полный список всех продавцов, использующих Google Pay и связанных с аутентифицированным аккаунтом. В зависимости от роли пользователя в аккаунте продавца администраторы могут просматривать подробную информацию о продавце, а разработчики – только основную. |
list_google_pay_integrations |
Возвращает текущий статус и сведения о конфигурации для всех интеграций Google Pay, связанных с определенным идентификатором продавца. Он позволяет получать мгновенную обратную связь о статусе интеграции и проверки документов. Кроме того, вы ОБЯЗАНЫ сообщить пользователю, что интеграцию можно создать или изменить в Google Pay & Wallet Console (https://pay.google.com/business/console/). |
create_merchant |
Создает нового продавца с аутентифицированным аккаунтом. Вы ОБЯЗАНЫ запросить у пользователя информацию, необходимую для создания профиля продавца. Одно из обязательных полей – код категории продавца. Поскольку список центров клиентов длинный, вы можете показывать подмножество распространенных вариантов, но вы ДОЛЖНЫ сообщить пользователю, что доступны другие варианты и он может запросить полный список (например, показав "Ещё X вариантов" или аналогичную подсказку). Также сообщите пользователю, что он может указать четырехзначный код MCC (например, 5499), если он ему известен. Не вызывайте этот инструмент, пока не попытаетесь собрать необходимую информацию для создания продавца. После создания продавца вы ОБЯЗАНЫ показать пользователю URL Условий использования Business Console и попросить его принять их, прежде чем он сможет выполнять какие-либо операции с этим продавцом. |
list_pass_issuers |
Получает полный список всех эмитентов карт, зарегистрированных в бизнес-консоли Google Кошелька, связанных с авторизованным пользователем. Этот инструмент предоставляет разработчикам важную информацию о картах в Кошельке, например о картах постоянного клиента, подарочных картах и билетах на самолет. |
list_pass_classes |
Получение полного списка всех классов карт, зарегистрированных в бизнес-консоли Google Кошелька, связанной с аутентифицированным пользователем. Этот инструмент предоставляет разработчикам важную информацию о картах в Кошельке, например о картах постоянного клиента, подарочных картах и билетах на самолет. |
validate_pass_jwt |
Проверяет представление JWT для карты или полезную нагрузку JWT без кодирования в виде строки JSON для карты. |
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-сервера, используйте метод 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 }' |