mcp-paypal — MCP-сервер для Claude Code: что делает и как установить
MCP-сервер для работы с PayPal REST API через ИИ-агентов. Позволяет оформлять заказы, списывать платежи, слать выплаты и управлять спорами прямо из чата.
claude mcp add --env PAYPAL_CLIENT_ID=<PAYPAL_CLIENT_ID> --env PAYPAL_CLIENT_SECRET=<PAYPAL_CLIENT_SECRET> --env PAYPAL_ENV=<PAYPAL_ENV> --transport stdio paypal -- npx -y @codespar/mcp-paypalЧто делает mcp-paypal
Сервер открывает 19 инструментов к API PayPal. Ассистент умеет создавать заказы, выполнять авторизацию и захват средств, делать возвраты, а также отменять холды. Предусмотрены операции с массовыми выплатами через batch payouts, оформление подписок и проверка подписей входящих вебхуков. При разборе претензий агент может запросить детали спора или принять претензию покупателя.
Подключение идёт через протокол stdio либо локальный HTTP-сервер на порту 3000. Авторизация использует OAuth2: сервер сам отправляет PAYPAL_CLIENT_ID и PAYPAL_CLIENT_SECRET, кэширует полученный токен и обновляет его за 60 секунд до истечения срока. Для захвата оплат и возвратов поддерживается заголовок идемпотентности PayPal-Request-Id.
Без указания PAYPAL_CLIENT_ID и секретного ключа запустить интеграцию не получится. Передавать суммы нужно строго объектом с валютой и строковым десятичным числом, иначе REST API отклонит запрос.
Какие задачи решает
- создавать и списывать платежи по заказам через PayPal REST API
- оформлять регулярные подписки и отменять их действие
- проводить массовые выплаты партнёрам отдельными пакетами
- получать списки диспутов и принимать претензии покупателей
- проверять криптографические подписи входящих вебхуков
Примеры запросов агенту
- Создай заказ в PayPal на сумму 15.00 USD за подписку на тариф Pro
- Проверь статус выплаты с идентификатором batch-12345
- Покажи открытые споры по аккаунту и подтверди согласие с претензией claim-987
Как установить mcp-paypal
Командой платформы
claude mcp add --env PAYPAL_CLIENT_ID=<PAYPAL_CLIENT_ID> --env PAYPAL_CLIENT_SECRET=<PAYPAL_CLIENT_SECRET> --env PAYPAL_ENV=<PAYPAL_ENV> --transport stdio paypal -- npx -y @codespar/mcp-paypalВместо <…> подставьте свои значения
Командой платформы
codex mcp add paypal --env PAYPAL_CLIENT_ID=<PAYPAL_CLIENT_ID> --env PAYPAL_CLIENT_SECRET=<PAYPAL_CLIENT_SECRET> --env PAYPAL_ENV=<PAYPAL_ENV> -- npx -y @codespar/mcp-paypalВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"paypal": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-paypal"
],
"env": {
"PAYPAL_CLIENT_ID": "<PAYPAL_CLIENT_ID>",
"PAYPAL_CLIENT_SECRET": "<PAYPAL_CLIENT_SECRET>",
"PAYPAL_ENV": "<PAYPAL_ENV>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"paypal": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-paypal"
],
"env": {
"PAYPAL_CLIENT_ID": "<PAYPAL_CLIENT_ID>",
"PAYPAL_CLIENT_SECRET": "<PAYPAL_CLIENT_SECRET>",
"PAYPAL_ENV": "<PAYPAL_ENV>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e PAYPAL_CLIENT_ID=<PAYPAL_CLIENT_ID> -e PAYPAL_CLIENT_SECRET=<PAYPAL_CLIENT_SECRET> -e PAYPAL_ENV=<PAYPAL_ENV> paypal npx -y @codespar/mcp-paypalВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-paypal
Как установить mcp-paypal в Claude Code?
Выполните команду claude mcp add mcp-paypal -e PAYPAL_CLIENT_ID=<PAYPAL_CLIENT_ID> -e PAYPAL_CLIENT_SECRET=<PAYPAL_CLIENT_SECRET> -- npx -y @codespar/mcp-paypal. Подставьте собственные ключи приложения.
Что умеет делать этот MCP-сервер?
Он предоставляет 19 инструментов для управления заказами, списаниями, авторизациями, возвратами, подписками, массовыми выплатами и претензиями покупателей через PayPal REST API.
Как переключиться с тестовой среды на рабочую?
Задайте переменную окружения PAYPAL_ENV="live". По умолчанию сервер запускается со значением sandbox и направляет запросы на тестовый шлюз api-m.sandbox.paypal.com.
