PayPal

Контекстный протокол модели PayPal

Сервер PayPal Model Context Protocol позволяет интегрироваться с API PayPal через вызов функций. Этот протокол поддерживает различные инструменты для взаимодействия с различными службами PayPal.

Чтобы запустить сервер PayPal MCP с помощью npx, используйте следующую команду:

npx -y @paypal/mcp --tools=all PAYPAL_ACCESS_TOKEN="YOUR_ACCESS_TOKEN" PAYPAL_ENVIRONMENT="SANDBOX"

Замените YOUR_ACCESS_TOKEN на ваш токен доступа PayPal. Ознакомьтесь с этим, чтобы узнать, как сгенерировать токен доступа PayPal . В качестве альтернативы вы можете установить PAYPAL_ACCESS_TOKEN в переменных среды.

Использование с хостом MCP (Claude Desktop/Cline/Cursor/GitHub Copilot)

В этом руководстве объясняется, как интегрировать коннектор PayPal с Claude Desktop.

Related MCP server: Worldpay MCP Server

Предпосылки

• Установлено приложение Claude Desktop

• установка Node.js локально

Этапы установки

1. Установите Node.js

Для работы коннектора PayPal требуется Node.js:

1. Посетите официальный сайт Node.js , загрузите и установите его.

2. Требования: Узел 18+

2. Настройте PayPal Connector с хостом MCP (Claude Desktop / Cursor / Cline)

Мы покажем интеграцию с Claude desktop. Вы можете использовать ваш любимый MCP host.

1. Открыть рабочий стол Клода

2. Перейдите в настройки.

3. Найдите раздел «Разработчик» или «Дополнительные настройки».

4. Найдите область конфигурации внешних инструментов или разъемов.

5. Добавьте следующую конфигурацию коннектора PayPal в этот ~/Claude/claude_desktop_config.json:

{
   "mcpServers": {
     "paypal": {
       "command": "npx",
       "args": [
         "-y",
         "@paypal/mcp",
         "--tools=all"
       ],
       "env": {
         "PAYPAL_ACCESS_TOKEN": "YOUR_PAYPAL_ACCESS_TOKEN",
         "PAYPAL_ENVIRONMENT": "SANDBOX"
       }
     }
   }
}

Обязательно замените YOUR_PAYPAL_ACCESS_TOKEN на ваш фактический токен доступа PayPal. В качестве альтернативы вы можете задать PAYPAL_ACCESS_TOKEN как переменную среды. Вы также можете передать его как аргумент, используя --access-token в "args". Установите значение PAYPAL_ENVIRONMENT как SANDBOX для сценического тестирования и PRODUCTION для производственной среды.

6. Сохраните изменения конфигурации.

3. Проверьте интеграцию

1. Закройте и перезапустите Claude Desktop, чтобы изменения вступили в силу.

2. Проверьте соединение, попросив Клода выполнить задачу, связанную с PayPal.

   • Пример: «Список моих счетов PayPal»

Доступные инструменты

Счета-фактуры

• create_invoice : Создать новый счет в системе PayPal

• list_invoices : Список счетов-фактур с возможностью разбиения на страницы и фильтрации

• get_invoice : Получить данные определенного счета-фактуры

• send_invoice : Отправить счет-фактуру получателям

• send_invoice_reminder : Отправить напоминание о существующем счете

• cancel_sent_invoice : Отменить отправленный счет-фактуру

• generate_invoice_qr_code : Генерация QR-кода для счета-фактуры

Платежи

• create_order : Создать заказ в системе PayPal на основе предоставленных данных

• get_order : Получить данные заказа

• pay_order : Обработка платежа по авторизованному заказу

Управление спорами

• list_disputes : Получить сводку всех открытых споров

• get_dispute : Получить подробную информацию о конкретном споре

• accept_dispute_claim : Принять иск о споре

Отслеживание отправлений

• create_shipment_tracking : Создать запись отслеживания отправления

• get_shipment_tracking : Получить информацию об отслеживании отправления

Управление каталогом

• create_product : Создать новый продукт в каталоге PayPal

• list_products : Список продуктов с возможностью пагинации и фильтрации

• show_product_details : Получить сведения о конкретном продукте

• update_product : Обновить существующий продукт

Управление подпиской

• create_subscription_plan : Создать новый план подписки

• list_subscription_plans : Список планов подписки

• show_subscription_plan_details : Получить сведения о конкретном плане подписки

• create_subscription : Создать новую подписку

• show_subscription_details : Получить сведения о конкретной подписке

• cancel_subscription : Отменить активную подписку

Отчетность и аналитика

• list_transactions : Список транзакций с возможностью разбиения на страницы и фильтрации

Переменные среды

Можно использовать следующие переменные среды:

• PAYPAL_ACCESS_TOKEN : Ваш токен доступа PayPal

• PAYPAL_ENVIRONMENT : установите SANDBOX для режима песочницы, PRODUCTION для производства (по умолчанию режим SANDBOX )

В этом руководстве объясняется, как сгенерировать токен доступа для интеграции API PayPal, в том числе как найти свой идентификатор клиента и секретный ключ клиента.

Предпосылки

• Аккаунт разработчика PayPal (для Sandbox)

• Счет PayPal Business (для производства)

Как найти свой идентификатор клиента и секретный код клиента

1. Создайте учетную запись разработчика PayPal :

   • Перейти к панели инструментов разработчика PayPal

   • Зарегистрируйтесь или войдите в систему, используя свои учетные данные PayPal

2. Получите доступ к своим учетным данным :

   • В панели разработчика нажмите «Приложения и учетные данные» в меню.

   • Переключайтесь между режимами Sandbox и Live в зависимости от ваших потребностей.

3. Создать или просмотреть приложение :

   • Чтобы создать новое приложение, нажмите «Создать приложение».

   • Дайте своему приложению имя и выберите бизнес-аккаунт, который будет с ним связан.

   • Для существующих приложений нажмите на название приложения, чтобы просмотреть подробную информацию.

4. Получить учетные данные :

   • После создания или выбора приложения вы увидите экран с:

     • Идентификатор клиента : публичный идентификатор вашего приложения.

     • Секрет клиента : закрытый ключ (отображается после нажатия кнопки «Показать»)

   • Сохраните эти учетные данные в надежном месте, так как они необходимы для генерации токенов доступа.

Генерация токена доступа

Использование cURL

curl -v https://api-m.sandbox.paypal.com/v1/oauth2/token \\
  -H \"Accept: application/json\" \\
  -H \"Accept-Language: en_US\" \\
  -u \"CLIENT_ID:CLIENT_SECRET\" \\
  -d \"grant_type=client_credentials\"

Замените CLIENT_ID и CLIENT_SECRET на ваши фактические учетные данные. Для производства используйте https://api-m.paypal.com вместо URL-адреса песочницы.

Использование Почтальона

1. Создайте новый запрос на https://api-m.sandbox.paypal.com/v1/oauth2/token

2. Установить метод POST

3. В разделе «Авторизация» выберите «Базовая аутентификация» и введите свой идентификатор клиента и секретный код клиента.

4. В разделе Body выберите x-www-form-urlencoded и добавьте ключ grant_type со значением client_credentials

5. Отправить запрос

Ответ

Успешный ответ будет выглядеть так:

{
  "scope": "...",
  "access_token": "Your Access Token",
  "token_type": "Bearer",
  "app_id": "APP-80W284485P519543T",
  "expires_in": 32400,
  "nonce": "..."
}

Скопируйте значение access_token для использования в интеграции Claude Desktop.

Подробности токена

• Жетоны Sandbox : действительны в течение 3–8 часов.

• Производственные жетоны : действительны в течение 8 часов.

• Рекомендуется реализовать логику обновления токена до истечения срока его действия.

Использование токена с Claude Desktop

Получив токен доступа, обновите значение PAYPAL_ACCESS_TOKEN в конфигурации коннектора Claude Desktop:

{
  "env": {
    "PAYPAL_ACCESS_TOKEN": "YOUR_NEW_ACCESS_TOKEN",
    "PAYPAL_ENVIRONMENT": "SANDBOX"
  }
}

Лучшие практики

1. Безопасное хранение идентификатора и секрета клиента

2. Реализовать логику обновления токенов для обработки истечения срока действия токенов

3. Используйте токены, специфичные для конкретной среды (песочница для тестирования, производство для реальных транзакций)

4. Избегайте жесткого кодирования токенов в коде приложения

Отказ от ответственности

@paypal/mcp предоставляет доступ к контенту, созданному ИИ, который может быть неточным или неполным. Пользователи несут ответственность за независимую проверку любой информации, прежде чем полагаться на нее. PayPal не дает никаких гарантий относительно точности вывода и не несет ответственности за любые решения, действия или последствия, возникающие в результате его использования.