mcp-celcoin — MCP-сервер для Claude Code: Pix, boleto и переводы
MCP-сервер, который даёт агенту доступ к Celcoin: создать Pix-платёж, выпустить boleto, проверить баланс, сделать перевод. Полезен, когда нужно провести платёж в Бразилии прямо из чата.
claude mcp add mcp-celcoin -e CELCOIN_CLIENT_SECRET=<CELCOIN_CLIENT_SECRET> -- npx -y @codespar/mcp-celcoinЧто делает mcp-celcoin
Сервер закрывает 18 инструментов Celcoin. Через них агент создаёт Pix-платёж или мгновенное начисление cob с QR-кодом для плательщика, выпускает и отменяет boleto, читает штрихкод квитанции и подтверждает оплату, делает перевод TED/DOC. Плюс справочники: баланс, выписка за период, список банков Бразилии по кодам ISPB, операторы для пополнения телефона.
Аутентификация — OAuth2 client credentials, токен сервер обновляет сам. Нужны CELCOIN_CLIENT_ID и CELCOIN_CLIENT_SECRET из кабинета разработчика Celcoin. Для экспериментов есть песочница sandbox.openfinance.celcoin.dev, её включает CELCOIN_SANDBOX=true.
С продакшеном сложнее. Celcoin пускает боевые вызовы только по mTLS с их сертификатом и только с IP, которые вы заранее зарегистрировали. Сам сервер клиентский сертификат не предъявляет, поэтому прямой вызов продакшена вернёт 401. Рабочий вариант один: направить CELCOIN_BASE_URL на прокси, который держит сертификат и обрывает mTLS.
Какие задачи решает
- создать Pix-платёж и получить QR-код для плательщика
- выпустить boleto и потом его отменить
- прочитать штрихкод квитанции до оплаты
- сделать перевод TED/DOC из агента
- пополнить мобильный телефон через оператора
Примеры запросов агенту
- Создай Pix-платёж на 150 реалов и покажи copia-e-cola
- Проверь штрихкод из
boleto.txtи скажи сумму и срок оплаты - Покажи выписку по счёту Celcoin за прошлую неделю
Как установить mcp-celcoin
Командой платформы
claude mcp add mcp-celcoin -e CELCOIN_CLIENT_SECRET=<CELCOIN_CLIENT_SECRET> -- npx -y @codespar/mcp-celcoinВместо <…> подставьте свои значения
Командой платформы
codex mcp add celcoin --env CELCOIN_CLIENT_SECRET=<CELCOIN_CLIENT_SECRET> -- npx -y @codespar/mcp-celcoinВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"celcoin": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-celcoin"
],
"env": {
"CELCOIN_CLIENT_SECRET": "<CELCOIN_CLIENT_SECRET>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"celcoin": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-celcoin"
],
"env": {
"CELCOIN_CLIENT_SECRET": "<CELCOIN_CLIENT_SECRET>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e CELCOIN_CLIENT_SECRET=<CELCOIN_CLIENT_SECRET> celcoin npx -y @codespar/mcp-celcoinВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-celcoin
Как установить mcp-celcoin в Claude Code?
Одной командой: claude mcp add mcp-celcoin -e CELCOIN_CLIENT_SECRET=<CELCOIN_CLIENT_SECRET> -- npx -y @codespar/mcp-celcoin. Секрет подставьте свой.
Что делает mcp-celcoin?
Даёт агенту инструменты Celcoin: Pix, boleto, переводы TED/DOC, оплата квитанций, пополнение телефона, баланс и выписка.
Почему продакшен отвечает 401?
Celcoin принимает боевые вызовы только по mTLS с их сертификатом и с зарегистрированных IP. Сервер сертификат не предъявляет, так что нужен прокси с mTLS, а его адрес задаётся в CELCOIN_BASE_URL.
