PayPal MCP Server

Что умеет сервер

PayPal создал MCP-сервер, чтобы мерчанты могли решать деловые задачи обычными фразами в любимом MCP-клиенте. Инструменты охватывают счета (создание, список, получение, отправка, напоминание, отмена, QR-код), платежи (заказы, оплата, возвраты), управление спорами, отслеживание отправлений, каталог товаров, подписки и планы подписок, а также список транзакций.

Пример из руководства: попросить клиента создать счёт на услуги по уходу за газоном на 200 долларов, а ассистент соберёт данные и отправит счёт. Через подключение к хранилищу файлов можно рассылать счета нескольким клиентам сразу.

Когда использовать

Подходит малому бизнесу и разработчикам: выставить счета пачкой, посмотреть операции за период, оформить возврат, вести каталог и подписки. Проверять интеграцию безопаснее в песочнице (SANDBOX), а на боевой режим переходить, только убедившись, что инструменты делают именно то, что нужно.

Исходный код локального сервера лежит в репозитории paypal/paypal-mcp-server, но его последнее обновление датировано октябрём 2025 года, поэтому ориентируйтесь на актуальное руководство на сайте PayPal.

Ограничения и безопасность

Это платёжные операции: возвраты, оплата заказов, отмена счетов и принятие претензий по спору меняют реальные деньги и статусы. Подтверждайте вызовы и не давайте клиенту боевой токен без необходимости. Локальный сервер получает токен доступа в переменной окружения PAYPAL_ACCESS_TOKEN; токены короткоживущие (до восьми часов), нужно обновлять их.

PayPal предупреждает, что содержимое, созданное ИИ, может быть неточным, и ответственность за проверку лежит на пользователе. Для размещённого сервера есть отдельные адреса песочницы и боевой среды. При проблемах с подключением руководство советует очистить каталог ~/.mcp-auth.

Локальный сервер (Claude Desktop, Cursor, Cline)

Нужен Node.js 18 или новее. Добавьте в claude_desktop_config.json (для других клиентов — в их файл MCP):

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

SANDBOX — для тестов, PRODUCTION — для боевой среды. Токен можно передать и аргументом --access-token. Перезапустите клиент и проверьте запросом, например, «список моих счетов PayPal».

Быстрый запуск из терминала:

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

Получение токена доступа

Возьмите идентификатор клиента и секрет в разделе Apps & Credentials панели PayPal Developer, затем:

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"

Для боевой среды используйте https://api-m.paypal.com.

Размещённый сервер

Песочница: https://mcp.sandbox.paypal.com, боевая среда: https://mcp.paypal.com. Поддерживаются транспорты SSE и Streamable HTTP. Конфигурация для Streamable HTTP в песочнице:

{
  "mcpServers": {
    "paypal-mcp-server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.sandbox.paypal.com/http"
      ]
    }
  }
}

Для боевой среды замените адрес на https://mcp.paypal.com/http; для SSE адрес оканчивается на /sse. Сохраните файл, перезапустите клиент, войдите в PayPal и разрешите доступ.