mcp-picpay — MCP-сервер для Claude Code: что делает и как установить
Подключает агент к API бразильского кошелька PicPay. Позволяет создавать платежи, генерировать QR-коды Pix, оформлять подписки и переводить деньги пользователям.
claude mcp add --env PICPAY_TOKEN=<PICPAY_TOKEN> --env PICPAY_SELLER_TOKEN=<PICPAY_SELLER_TOKEN> --env PICPAY_BASE_URL=<PICPAY_BASE_URL> --transport stdio picpay -- npx -y @codespar/mcp-picpayЧто делает mcp-picpay
Сервер содержит 20 инструментов для работы с Checkout API и Recurrency API. Ассистент создаёт платёж, выдаёт ссылку на оплату и генерирует QR-коды для Pix. Также можно проверить баланс кошелька в BRL. Доступны и выплаты Business-to-Person: как разовые переводы, так и пакетная отправка средств.
Для авторизации запросов нужны переменные окружения PICPAY_TOKEN и PICPAY_SELLER_TOKEN. Токен продавца позволяет верифицировать входящие вебхуки через инструмент validate_notification. Проект опубликован в версии 0.1.0-alpha.1: схемы полей для планов и подписок разработчик рекомендует перепроверить по живой документации перед запуском в продакшен.
Какие задачи решает
- Выставить счёт покупателю и получить QR-код для Pix
- Проверить статус платежа или оформить возврат средств
- Запустить пакетную выплату B2P на счета пользователей PicPay
- Настроить тарифные планы и оформить рекуррентную подписку
- Проверить подлинность входящего вебхука через токен продавца
Примеры запросов агенту
- Создай платёж в PicPay на сумму 150 BRL и верни ссылку на оплату вместе с QR-кодом
- Проверь статус транзакции с идентификатором
order-789и покажи баланс кошелька - Отправь пакетный перевод B2P по списку получателей через
create_batch_payment
Как установить mcp-picpay
Командой платформы
claude mcp add --env PICPAY_TOKEN=<PICPAY_TOKEN> --env PICPAY_SELLER_TOKEN=<PICPAY_SELLER_TOKEN> --env PICPAY_BASE_URL=<PICPAY_BASE_URL> --transport stdio picpay -- npx -y @codespar/mcp-picpayВместо <…> подставьте свои значения
Командой платформы
codex mcp add picpay --env PICPAY_TOKEN=<PICPAY_TOKEN> --env PICPAY_SELLER_TOKEN=<PICPAY_SELLER_TOKEN> --env PICPAY_BASE_URL=<PICPAY_BASE_URL> -- npx -y @codespar/mcp-picpayВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"picpay": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-picpay"
],
"env": {
"PICPAY_TOKEN": "<PICPAY_TOKEN>",
"PICPAY_SELLER_TOKEN": "<PICPAY_SELLER_TOKEN>",
"PICPAY_BASE_URL": "<PICPAY_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"picpay": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-picpay"
],
"env": {
"PICPAY_TOKEN": "<PICPAY_TOKEN>",
"PICPAY_SELLER_TOKEN": "<PICPAY_SELLER_TOKEN>",
"PICPAY_BASE_URL": "<PICPAY_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e PICPAY_TOKEN=<PICPAY_TOKEN> -e PICPAY_SELLER_TOKEN=<PICPAY_SELLER_TOKEN> -e PICPAY_BASE_URL=<PICPAY_BASE_URL> picpay npx -y @codespar/mcp-picpayВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-picpay
Как установить mcp-picpay в Claude Code?
Выполните команду claude mcp add mcp-picpay -e PICPAY_TOKEN=<PICPAY_TOKEN> -e PICPAY_SELLER_TOKEN=<PICPAY_SELLER_TOKEN> -- npx -y @codespar/mcp-picpay. При необходимости укажите PICPAY_BASE_URL для изменения базового адреса API.
Что делает MCP-сервер mcp-picpay?
Он предоставляет 20 инструментов для взаимодействия с бизнес-интерфейсом PicPay. Агент может принимать платежи, настраивать подписки, формировать QR-коды и распределять выплаты.
Что требуется для проверки входящих вебхуков?
Серверу нужен ключ PICPAY_SELLER_TOKEN. Инструмент validate_notification сверяет заголовок x-seller-token в уведомлении, защищая обработчик от поддельных вызовов.
