mcp-braspag — MCP-сервер для Claude Code: платежи и установка
MCP-сервер подключает Braspag к агенту для платежей, рекуррентных списаний, токенизации карт и marketplace split.
claude mcp add --env BRASPAG_MERCHANT_ID=<BRASPAG_MERCHANT_ID> --env BRASPAG_MERCHANT_KEY=<BRASPAG_MERCHANT_KEY> --env BRASPAG_ENV=<BRASPAG_ENV> --transport stdio braspag -- npx -y @codespar/mcp-braspagЧто делает mcp-braspag
mcp-braspag даёт агенту доступ к операциям Braspag Transaction API и Query API. Через него можно создавать, подтверждать и отменять продажи, получать сведения по PaymentId или MerchantOrderId, запускать платежи Pix и Boleto, а также проводить 3DS-авторизацию и antifraud-анализ.
В сервере есть инструменты для рекуррентных платежей, Cartão Protegido, marketplace split и zero-dollar authorization. Сохранённый токен карты можно получить или удалить, а настройки рекуррентного платежа — изменить, деактивировать и повторно активировать.
Для работы нужны BRASPAG_MERCHANT_ID и BRASPAG_MERCHANT_KEY; Braspag использует их в заголовках API. До установки аккаунту нужно подключить Braspag Pagador в договоре с Cielo или Braspag, иначе сервер не получит рабочие учётные данные.
Какие задачи решает
- создать продажу через Braspag
- провести рекуррентное списание
- токенизировать карту в Cartão Protegido
- разделить платёж между субмерчантами
- получить статус продажи по
MerchantOrderId
Примеры запросов агенту
- Создай продажу через Braspag для заказа из
order.jsonи верниPaymentId. - Проверь статус платежа по
MerchantOrderIdи объясни причину отказа, если она есть. - Создай рекуррентный платёж, задай сумму и дату следующего списания.
Как установить mcp-braspag
Командой платформы
claude mcp add --env BRASPAG_MERCHANT_ID=<BRASPAG_MERCHANT_ID> --env BRASPAG_MERCHANT_KEY=<BRASPAG_MERCHANT_KEY> --env BRASPAG_ENV=<BRASPAG_ENV> --transport stdio braspag -- npx -y @codespar/mcp-braspagВместо <…> подставьте свои значения
Командой платформы
codex mcp add braspag --env BRASPAG_MERCHANT_ID=<BRASPAG_MERCHANT_ID> --env BRASPAG_MERCHANT_KEY=<BRASPAG_MERCHANT_KEY> --env BRASPAG_ENV=<BRASPAG_ENV> -- npx -y @codespar/mcp-braspagВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"braspag": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-braspag"
],
"env": {
"BRASPAG_MERCHANT_ID": "<BRASPAG_MERCHANT_ID>",
"BRASPAG_MERCHANT_KEY": "<BRASPAG_MERCHANT_KEY>",
"BRASPAG_ENV": "<BRASPAG_ENV>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"braspag": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-braspag"
],
"env": {
"BRASPAG_MERCHANT_ID": "<BRASPAG_MERCHANT_ID>",
"BRASPAG_MERCHANT_KEY": "<BRASPAG_MERCHANT_KEY>",
"BRASPAG_ENV": "<BRASPAG_ENV>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e BRASPAG_MERCHANT_ID=<BRASPAG_MERCHANT_ID> -e BRASPAG_MERCHANT_KEY=<BRASPAG_MERCHANT_KEY> -e BRASPAG_ENV=<BRASPAG_ENV> braspag npx -y @codespar/mcp-braspagВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-braspag
Как установить mcp-braspag в Claude Code?
Задайте значения BRASPAG_MERCHANT_ID и BRASPAG_MERCHANT_KEY, затем выполните `claude mcp add mcp-braspag -e BRASPAG_MERCHANT_ID=<BRASPAG_MERCHANT_ID> -e BRASPAG_MERCHANT_KEY=<BRASPAG_MERCHANT_KEY> -- npx -y @codespar/mcp-braspag`.
Что делает mcp-braspag?
Он связывает агента с Braspag для продаж, рекуррентных платежей, токенизации карт, split-операций, Pix, Boleto и antifraud-анализа.
Чем mcp-braspag отличается от сервера Cielo?
mcp-braspag работает как слой оркестрации поверх эквайеров: поддерживает маршрутизацию, vault карт, failover и split для marketplace. Сервер Cielo предназначен для прямого эквайринга.
