mcp-pagbrasil — MCP-сервер для Claude Code: платежи в Бразилии
Даёт агенту три инструмента PagBrasil: создать заказ, узнать статус и вернуть деньги. Пригодится, если магазин продаёт в Бразилию и принимает Pix или boleto.
claude mcp add --env PAGBRASIL_PBTOKEN=<PAGBRASIL_PBTOKEN> --env PAGBRASIL_SECRET=<PAGBRASIL_SECRET> --env PAGBRASIL_BASE_URL=<PAGBRASIL_BASE_URL> --transport stdio pagbrasil -- npx -y @codespar/mcp-pagbrasilЧто делает mcp-pagbrasil
Сервер подключается к API PagBrasil — эквайера для иностранных продавцов на бразильском рынке. Внутри три инструмента: create_order создаёт заказ или запрос на оплату (pix, boleto, creditcard), get_order отдаёт текущий статус заказа, refund_order возвращает деньги по проведённому платежу. Ответы на Pix несут pix_code и pix_image, на boleto — штрихкод и ссылку на PDF.
Работать придётся с необычным форматом. API принимает form-urlencoded и отвечает XML, а не JSON, поэтому сервер отдаёт агенту сырой XML в поле xml — так ни одно поле не теряется. Токен мерчанта и секретная фраза идут полями тела на каждом запросе, заголовка авторизации нет; сервер подставляет их из PAGBRASIL_PBTOKEN и PAGBRASIL_SECRET. Обе переменные обязательны, их выдают в дашборде PagBrasil.
Без корректного customer_taxid заказ не пройдёт: нужен действующий CPF или CNPJ, а придумывать его нельзя — агент должен спросить у пользователя. order_number уникален в пределах одного налогоплательщика: тот же номер с тем же taxid даёт идемпотентный пропуск, с другим taxid — отказ Duplicated order. Сумма amount_brl пишется строкой в основных единицах: '125.00' значит R$ 125,00. По умолчанию запросы уходят на песочницу https://sandbox.pagbrasil.com/api; боевой адрес выдаётся мерчанту после подписания Payment Service Agreement и задаётся через PAGBRASIL_BASE_URL.
Какие задачи решает
- выставить счёт на оплату через Pix и получить код и картинку QR
- создать boleto и отдать покупателю штрихкод со ссылкой на PDF
- проверить, прошёл ли платёж, опрашивая статус заказа
- оформить частичный или полный возврат по проведённому заказу
- принять оплату картой с рассрочкой у бразильского покупателя
Примеры запросов агенту
- Создай заказ на 249.90 для покупателя с CPF, который я сейчас пришлю, и покажи код Pix.
- Проверь статус заказа
order_number1042 — платёж уже прошёл? - Верни покупателю часть суммы, 50.00, по заказу 1042.
Как установить mcp-pagbrasil
Командой платформы
claude mcp add --env PAGBRASIL_PBTOKEN=<PAGBRASIL_PBTOKEN> --env PAGBRASIL_SECRET=<PAGBRASIL_SECRET> --env PAGBRASIL_BASE_URL=<PAGBRASIL_BASE_URL> --transport stdio pagbrasil -- npx -y @codespar/mcp-pagbrasilВместо <…> подставьте свои значения
Командой платформы
codex mcp add pagbrasil --env PAGBRASIL_PBTOKEN=<PAGBRASIL_PBTOKEN> --env PAGBRASIL_SECRET=<PAGBRASIL_SECRET> --env PAGBRASIL_BASE_URL=<PAGBRASIL_BASE_URL> -- npx -y @codespar/mcp-pagbrasilВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"pagbrasil": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-pagbrasil"
],
"env": {
"PAGBRASIL_PBTOKEN": "<PAGBRASIL_PBTOKEN>",
"PAGBRASIL_SECRET": "<PAGBRASIL_SECRET>",
"PAGBRASIL_BASE_URL": "<PAGBRASIL_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"pagbrasil": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-pagbrasil"
],
"env": {
"PAGBRASIL_PBTOKEN": "<PAGBRASIL_PBTOKEN>",
"PAGBRASIL_SECRET": "<PAGBRASIL_SECRET>",
"PAGBRASIL_BASE_URL": "<PAGBRASIL_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e PAGBRASIL_PBTOKEN=<PAGBRASIL_PBTOKEN> -e PAGBRASIL_SECRET=<PAGBRASIL_SECRET> -e PAGBRASIL_BASE_URL=<PAGBRASIL_BASE_URL> pagbrasil npx -y @codespar/mcp-pagbrasilВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-pagbrasil
Как установить mcp-pagbrasil в Claude Code?
Одной командой: claude mcp add mcp-pagbrasil -e PAGBRASIL_PBTOKEN=<PAGBRASIL_PBTOKEN> -e PAGBRASIL_SECRET=<PAGBRASIL_SECRET> -- npx -y @codespar/mcp-pagbrasil. Если нужен свой PAGBRASIL_BASE_URL, есть второй вариант с --env и --transport stdio.
Что делает mcp-pagbrasil?
Создаёт заказы на оплату в PagBrasil, отдаёт их статус и оформляет возвраты. Агент получает ответ API в виде XML и разбирает его сам.
Чем PagBrasil отличается от PagBank и PagSeguro?
Это другой эквайер: он обслуживает иностранных продавцов, торгующих в Бразилию, и принимает Pix, Boleto Flash, PEC Flash и местные карты с рассрочкой. Сервер работает именно с API PagBrasil.
