Сервер протокола контекста модели (MCP) выступает в качестве прокси-сервера между внешним сервисом, предоставляющим контекст, данные или возможности для приложения, использующего большие языковые модели (LLM) или искусственного интеллекта. Серверы MCP соединяют приложения ИИ с внешними системами, такими как базы данных и веб-сервисы, преобразуя их ответы в формат, понятный приложению ИИ.
Настройка сервера
Перед использованием необходимо включить серверы MCP и настроить аутентификацию . Дополнительную информацию об использовании удаленных серверов MCP Google и Google Cloud см. в разделе «Обзор серверов MCP Google Cloud» .
Серверные конечные точки
Конечная точка сервиса MCP — это сетевой адрес и интерфейс связи (обычно URL) сервера MCP, который приложение ИИ (хост для клиента MCP) использует для установления безопасного стандартизированного соединения. Это точка контакта для LLM, позволяющая запросить контекст, вызвать инструмент или получить доступ к ресурсу. Конечные точки Google MCP могут быть глобальными или региональными.
Сервер Google Pay & Wallet Developer MCP имеет следующую глобальную конечную точку MCP:
- https://paydeveloper.googleapis.com/mcp
Инструменты MCP
Инструмент MCP — это функция или исполняемый файл, который сервер MCP предоставляет приложению LLM или AI для выполнения действий в реальном мире.
Инструменты
Сервер MCP paydeveloper.googleapis.com располагает следующими инструментами:
| Инструменты MCP | |
|---|---|
search_documentation | Выполняет поиск и извлечение наиболее актуальных разделов из официальной документации для разработчиков Google Pay и Google Wallet, а также примеров кода. |
list_merchants | Получает список всех профилей торговых предприятий Google Pay, связанных с авторизованным аккаунтом. |
list_google_pay_integrations | Возвращает текущий статус и сведения о конфигурации всех интеграций Google Pay, связанных с конкретным идентификатором продавца. Предоставляет мгновенную обратную связь о статусе интеграции и проверке документов. |
create_merchant | Создает нового продавца с авторизованной учетной записью. Вы ОБЯЗАТЕЛЬНО должны запросить у пользователя необходимую информацию для создания продавца. Не используйте этот инструмент, пока не попытаетесь собрать необходимую информацию для создания продавца. После создания продавца вы ОБЯЗАТЕЛЬНО должны показать пользователю URL-адрес Условий использования Business Console и попросить его принять их, прежде чем он сможет выполнять какие-либо операции с этим продавцом. |
create_google_pay_integration | Создает интеграцию Google Pay для конкретного продавца. Для выполнения этой операции пользователь должен принять Условия использования бизнес-консоли и Условия использования API Google Pay. Предварительная проверка этих условий не требуется. Если они не приняты, вызов инструмента завершится неудачей, и в сообщении об ошибке будут указаны URL-адреса условий использования, которые необходимо принять. В этом случае предоставьте пользователю URL-адреса для принятия и попросите его повторить попытку после принятия. Для взаимодействия с пользователем ПЕРЕД вызовом инструмента выполните следующие действия: 1. Сначала запросите у пользователя тип интеграции (в настоящее время поддерживается только веб-интеграция). - Запросите URL-адрес веб-сайта. # - Если тип интеграции — интеграция с приложением, запросите имя пакета приложения Android. 2. Затем запросите у пользователя тип интеграции: - Попросите пользователя выбрать Gateway, если он использует одного из поддерживаемых нами поставщиков платежных услуг (PSP: https://developers.google.com/pay/api#participating-processors ), в противном случае выберите Direct. 3. Для ВСЕХ типов интеграции (прямая или шлюзовая): - Попросите пользователя загрузить скриншоты (максимум 1 МБ) своего процесса покупки, интегрированного с API Google Pay. Процесс покупки должен быть проверен и одобрен до предоставления полного доступа к рабочей версии. Пример: https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together . - Вы ОБЯЗАТЕЛЬНО должны попросить пользователя предоставить 5 подтверждающих скриншотов. Запрашивайте их ПО ОДНОМУ, чтобы обеспечить правильное сопоставление. Используйте ТОЛЬКО понятные описания перечислений при запросе. 4. Если тип интеграции прямой: - Вы ТАКЖЕ должны попросить пользователя предоставить документ о подтверждении соответствия PCI в формате PDF. Используйте ТОЛЬКО понятные описания перечислений при запросе. 5. Для каждого предоставленного файла попросите пользователя указать путь или имя документа, если он находится в текущем каталоге. Сопоставьте его с правильным типом документа и установите в поле имени описательное имя (например, item_selection.png или pci_attestation.pdf) в запросе. Не вызывайте этот инструмент, пока не попытаетесь собрать необходимые документы для выбранного типа интеграции. |
list_pass_issuers | Получает полный список всех эмитентов пропусков, зарегистрированных в бизнес-консоли Google Wallet и связанных с авторизованным пользователем. Этот инструмент предоставляет разработчикам важную информацию для управления пропусками Wallet, такими как карты лояльности, подарочные карты или авиабилеты. |
list_pass_classes | Получает полный список всех классов пропусков, зарегистрированных в бизнес-консоли Google Wallet и связанных с авторизованным пользователем. Этот инструмент предоставляет разработчикам важную информацию для управления пропусками Wallet, такими как карты лояльности, подарочные карты или авиабилеты. |
validate_pass_jwt | Проверяет JWT-представление прохода или незакодированную полезную нагрузку JWT в виде строки JSON для прохода. |
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 }' |