mcp-pix-bcb — MCP-сервер Pix BCB
MCP-сервер, через который агент создаёт и ведёт заряды Pix по API Банка Бразилии: кобранса, возвраты, ключи DICT и вебхуки.
claude mcp add mcp-pix-bcb -e PIX_CLIENT_SECRET=<PIX_CLIENT_SECRET> -- npx -y @codespar/mcp-pix-bcbЧто делает mcp-pix-bcb
Сервер оборачивает эндпоинты Pix BCB в 18 инструментов. Агент умеет выставить немедленный заряд (create_cob) или заряд с датой (create_cobv), найти поступления по e2eid, запросить возврат через create_devolucao и настроить вебхук на ключ. Инструменты ключей работают с DICT: регистрация в PSP, поиск, перенос ключа, разбор заявки.
Авторизация идёт по OAuth2 client credentials поверх mTLS, и это главный барьер. Базовый URL, PIX_CLIENT_ID и PIX_CLIENT_SECRET выдаёт ваш банк-PSP, сертификат для mTLS кладут в PIX_CERT_PATH. Без сертификата и рабочих креденшелов сервер к API не подключится, а песочница есть не у каждого PSP.
Перед запуском проверьте, что ваш PSP вообще даёт доступ к Pix API. Ключи DICT требуют поддержки со стороны банка, иначе часть инструментов просто не сработает. Лицензия MIT, пакет ставится через npx @codespar/mcp-pix-bcb.
Какие задачи решает
- выставить немедленный заряд Pix из разговора с агентом
- найти поступление по endToEndId без похода в панель PSP
- запросить возврат по полученному платежу
- зарегистрировать ключ Pix в DICT
- повесить вебхук на ключ для уведомлений
Примеры запросов агенту
- Создай немедленный заряд Pix на 150.00 BRL и покажи qrcode
- Найди поступление по e2eid за вчерашний день
- Оформи возврат по этому платежу и выведи статус
Как установить mcp-pix-bcb
Командой платформы
claude mcp add mcp-pix-bcb -e PIX_CLIENT_SECRET=<PIX_CLIENT_SECRET> -- npx -y @codespar/mcp-pix-bcbВместо <…> подставьте свои значения
Командой платформы
codex mcp add pix-bcb --env PIX_CLIENT_SECRET=<PIX_CLIENT_SECRET> -- npx -y @codespar/mcp-pix-bcbВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"pix-bcb": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-pix-bcb"
],
"env": {
"PIX_CLIENT_SECRET": "<PIX_CLIENT_SECRET>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"pix-bcb": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-pix-bcb"
],
"env": {
"PIX_CLIENT_SECRET": "<PIX_CLIENT_SECRET>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e PIX_CLIENT_SECRET=<PIX_CLIENT_SECRET> pix-bcb npx -y @codespar/mcp-pix-bcbВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-pix-bcb
Как установить mcp-pix-bcb в Claude Code?
Добавьте сервер командой claude mcp add mcp-pix-bcb -e PIX_CLIENT_SECRET=<PIX_CLIENT_SECRET> -- npx -y @codespar/mcp-pix-bcb. Секрет подставьте свой, остальные переменные задайте в окружении.
Что делает mcp-pix-bcb?
Даёт агенту инструменты Pix BCB: создание и правка зарядов, поступления, возвраты, ключи DICT и вебхуки. Все вызовы идут в API вашего PSP.
Что нужно, чтобы сервер заработал?
OAuth2 client credentials и сертификат mTLS от банка-PSP, а также его базовый URL. PIX_BASE_URL, PIX_CLIENT_ID и PIX_CLIENT_SECRET обязательны, путь к сертификату передаётся в PIX_CERT_PATH.
