mcp-safrapay — MCP-сервер для Claude Code: что делает и как установить
Даёт агенту доступ к шлюзу Safrapay: выставление счетов Pix, создание платежей по картам, сплиты и выгрузка выписок бразильского эквайринга.
claude mcp add --env SAFRAPAY_CLIENT_ID=<SAFRAPAY_CLIENT_ID> --env SAFRAPAY_CLIENT_SECRET=<SAFRAPAY_CLIENT_SECRET> --env SAFRAPAY_MERCHANT_ID=<SAFRAPAY_MERCHANT_ID> --env SAFRAPAY_ENV=<SAFRAPAY_ENV> --transport stdio safrapay -- npx -y @codespar/mcp-safrapayЧто делает mcp-safrapay
MCP-сервер связывает модель со шлюзом Safrapay на базе платформы Aditum. В набор входят 22 инструмента: авторизация списаний по картам, генерация Pix, оформление boleto и запуск проверок 3-D Secure. Агент может создавать платёжные ссылки, проверять детали открытых споров по чарджбэкам и задавать правила сплита средств.
Архитектура Aditum распределяет операции по четырём хостам. Отдельные адреса выделены под платежи, выверку, вебхуки и портал. Для авторизации сервер делает двухэтапный вход по CNPJ и MerchantToken с хешем BCRYPT, сохраняя полученный JWT в памяти на время сессии. Из-за неполного описания схемы склейки хеша в открытых документах логику входа необходимо валидировать на живом аккаунте песочницы.
Сервер запускается по stdio через npx или слушает входящий HTTP-порт. Для работы нужны переменные окружения SAFRAPAY_CLIENT_ID, SAFRAPAY_CLIENT_SECRET и SAFRAPAY_MERCHANT_ID, а выбор песочницы или продакшена задаётся через SAFRAPAY_ENV.
Какие задачи решает
- выставить счёт Pix или сформировать boleto
- провести авторизацию и списание по банковской карте
- настроить сплит платежа между получателями
- запросить статус чарджбэка и выгрузить отчёт сверки
Примеры запросов агенту
- Выстави счёт Pix на сумму 150 BRL для заказа 1042.
- Проверь статус чарджбэка по платежу
ch_987654черезquery_chargeback. - Создай регулярную подписку на ежемесячный платёж через
create_recurrence.
Как установить mcp-safrapay
Командой платформы
claude mcp add --env SAFRAPAY_CLIENT_ID=<SAFRAPAY_CLIENT_ID> --env SAFRAPAY_CLIENT_SECRET=<SAFRAPAY_CLIENT_SECRET> --env SAFRAPAY_MERCHANT_ID=<SAFRAPAY_MERCHANT_ID> --env SAFRAPAY_ENV=<SAFRAPAY_ENV> --transport stdio safrapay -- npx -y @codespar/mcp-safrapayВместо <…> подставьте свои значения
Командой платформы
codex mcp add safrapay --env SAFRAPAY_CLIENT_ID=<SAFRAPAY_CLIENT_ID> --env SAFRAPAY_CLIENT_SECRET=<SAFRAPAY_CLIENT_SECRET> --env SAFRAPAY_MERCHANT_ID=<SAFRAPAY_MERCHANT_ID> --env SAFRAPAY_ENV=<SAFRAPAY_ENV> -- npx -y @codespar/mcp-safrapayВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"safrapay": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-safrapay"
],
"env": {
"SAFRAPAY_CLIENT_ID": "<SAFRAPAY_CLIENT_ID>",
"SAFRAPAY_CLIENT_SECRET": "<SAFRAPAY_CLIENT_SECRET>",
"SAFRAPAY_MERCHANT_ID": "<SAFRAPAY_MERCHANT_ID>",
"SAFRAPAY_ENV": "<SAFRAPAY_ENV>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"safrapay": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-safrapay"
],
"env": {
"SAFRAPAY_CLIENT_ID": "<SAFRAPAY_CLIENT_ID>",
"SAFRAPAY_CLIENT_SECRET": "<SAFRAPAY_CLIENT_SECRET>",
"SAFRAPAY_MERCHANT_ID": "<SAFRAPAY_MERCHANT_ID>",
"SAFRAPAY_ENV": "<SAFRAPAY_ENV>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e SAFRAPAY_CLIENT_ID=<SAFRAPAY_CLIENT_ID> -e SAFRAPAY_CLIENT_SECRET=<SAFRAPAY_CLIENT_SECRET> -e SAFRAPAY_MERCHANT_ID=<SAFRAPAY_MERCHANT_ID> -e SAFRAPAY_ENV=<SAFRAPAY_ENV> safrapay npx -y @codespar/mcp-safrapayВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-safrapay
Как установить mcp-safrapay в Claude Code?
Выполните команду `claude mcp add mcp-safrapay -e SAFRAPAY_CLIENT_ID=<SAFRAPAY_CLIENT_ID> -e SAFRAPAY_CLIENT_SECRET=<SAFRAPAY_CLIENT_SECRET> -e SAFRAPAY_MERCHANT_ID=<SAFRAPAY_MERCHANT_ID> -- npx -y @codespar/mcp-safrapay`.
Что делает mcp-safrapay?
Подключает ассистента к API эквайринга Safrapay на платформе Aditum для обработки бразильских способов оплаты, рекуррентных списаний и выгрузки финансовой отчётности.
Почему сервер находится в статусе альфа-версии?
Публичная документация Aditum не содержит точной спецификации входной строки для вычисления BCRYPT-хеша при первичной авторизации. Интеграцию нужно проверять на реальном аккаунте песочницы.
