mcp-cielo — MCP-сервер для Claude Code: платежи Cielo
Подключает к агенту 22 инструмента Cielo: карточные списания, boleto, Pix, рекуррентные платежи и ссылки на оплату. Пригодится, когда платёжную логику надо собрать прямо в коде.
claude mcp add mcp-cielo -e CIELO_API_KEY=<CIELO_API_KEY> -- npx -y @codespar/mcp-cieloЧто делает mcp-cielo
Сервер вызывает API Cielo из чата агента: создать продажу по карте, захватить предавторизацию, отменить её целиком или частично, выпустить boleto и Pix с QR-кодом. Рекуррентные подписки тоже здесь: сумму и дату следующего списания можно поменять, платёж — приостановить и вернуть обратно. Карту разрешено сохранить токеном и дальше списывать без повторного ввода данных, а нулевая авторизация проверяет карту без денег.
Авторизация идёт через заголовки MerchantId и MerchantKey, поэтому нужны оба ключа из портала разработчиков Cielo. Для тестов есть песочница: переменная CIELO_SANDBOX=true переключает сервер на apisandbox.cieloecommerce.cielo.com.br. Ключи подставляются в окружение при регистрации сервера, вручную в промпте их передавать не надо.
Счёт инструментов расходится с планами в репозитории: Pix, дебетовые карты, кошельки и антифрод значатся и в таблице инструментов, и в разделе про версию 0.2. Сверьтесь с фактическим списком инструментов после установки, прежде чем строить на них рабочий процесс. Отдельно учтите дебет: для create_debit нужна аутентификация 3DS.
Какие задачи решает
- создать продажу по кредитной или дебетовой карте
- выпустить boleto с оплатой по коду
- сгенерировать Pix-платёж с QR-кодом
- настроить рекуррентное списание и менять его сумму
- проверить карту нулевой авторизацией без списания
Примеры запросов агенту
- Покажи детали продажи по PaymentId 123456789
- Оформи рекуррентный платёж на 49.90 и приостанови его на следующем цикле
- Создай ссылку на оплату для заказа 8842
Как установить mcp-cielo
Командой платформы
claude mcp add mcp-cielo -e CIELO_API_KEY=<CIELO_API_KEY> -- npx -y @codespar/mcp-cieloВместо <…> подставьте свои значения
Командой платформы
codex mcp add cielo --env CIELO_API_KEY=<CIELO_API_KEY> -- npx -y @codespar/mcp-cieloВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"cielo": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-cielo"
],
"env": {
"CIELO_API_KEY": "<CIELO_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"cielo": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-cielo"
],
"env": {
"CIELO_API_KEY": "<CIELO_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e CIELO_API_KEY=<CIELO_API_KEY> cielo npx -y @codespar/mcp-cieloВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-cielo
Как установить mcp-cielo в Claude Code?
Выполните claude mcp add mcp-cielo -e CIELO_API_KEY=<CIELO_API_KEY> -- npx -y @codespar/mcp-cielo. Ключ MerchantId и MerchantKey из портала Cielo подставьте в переменные окружения.
Что делает mcp-cielo?
Даёт агенту инструменты платёжного шлюза Cielo: продажи по картам, boleto, Pix, рекуррентные платежи, токенизация карт, ссылки на оплату и антифрод.
Где проверить интеграцию без реальных денег?
Выставьте CIELO_SANDBOX=true, и сервер будет обращаться к песочнице Cielo по адресу apisandbox.cieloecommerce.cielo.com.br.
