mcp-stone — MCP-сервер для Claude Code: банк Stone и Pix
MCP-сервер открывает агенту платежи, переводы и баланс в бразильском Stone через OAuth2. Пригодится, когда код должен реально создавать платёж, а не описывать его.
claude mcp add mcp-stone -e STONE_CLIENT_SECRET=<STONE_CLIENT_SECRET> -- npx -y @codespar/mcp-stoneЧто делает mcp-stone
Пакет @codespar/mcp-stone даёт агенту 21 инструмент: баланс и выписка по счёту, история транзакций, платежи, банковские переводы, исходящий Pix и Pix-коб с QR-кодом, boleto, отмена и возврат проводки, токенизация карты. Отдельная группа — эквайринг: списание с кредитной или дебетовой карты, поиск будущих поступлений, лимиты антесипации и её создание, список POS-терминалов с их статусом. Есть инструменты для регистрации вебхука и просмотра зарегистрированных точек.
Доступ оформлен через OAuth2 client credentials, обновлением токена сервер занимается сам. Для запуска нужны STONE_CLIENT_ID и STONE_CLIENT_SECRET — их выдаёт портал для разработчиков Stone. Без обоих ключей сервер не авторизуется, и ни один инструмент не сработает. Песочница подключается через STONE_BASE_URL и STONE_AUTH_URL.
До версии 0.2.2 включительно адрес токена в коде вёл на login.openbank.stone.com.br, а такого хоста не существует. Отсюда падала любая авторизация. Если у вас старый релиз, проверьте STONE_AUTH_URL явно, иначе платежи не пойдут.
Какие задачи решает
- узнать остаток на счёте Stone прямо из чата с агентом
- выставить счёт клиенту через Pix-коб или boleto
- сделать возврат или отменить несписанную транзакцию
- посмотреть лимиты антесипации и будущие поступления
- проверить, онлайн ли POS-терминал, и зарегистрировать вебхук
Примеры запросов агенту
- Покажи баланс и выписку за прошлый месяц, затем создай boleto на 250 реалов для клиента из заметки.
- Создай Pix-коб на 80 реалов и отдай QR-код, а через час проверь статус.
- Какие у мерчанта лимиты антесипации и какие терминалы сейчас офлайн?
Как установить mcp-stone
Командой платформы
claude mcp add mcp-stone -e STONE_CLIENT_SECRET=<STONE_CLIENT_SECRET> -- npx -y @codespar/mcp-stoneВместо <…> подставьте свои значения
Командой платформы
codex mcp add stone --env STONE_CLIENT_SECRET=<STONE_CLIENT_SECRET> -- npx -y @codespar/mcp-stoneВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"stone": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-stone"
],
"env": {
"STONE_CLIENT_SECRET": "<STONE_CLIENT_SECRET>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"stone": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-stone"
],
"env": {
"STONE_CLIENT_SECRET": "<STONE_CLIENT_SECRET>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e STONE_CLIENT_SECRET=<STONE_CLIENT_SECRET> stone npx -y @codespar/mcp-stoneВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-stone
Как установить mcp-stone в Claude Code?
Выполните claude mcp add mcp-stone -e STONE_CLIENT_SECRET=<STONE_CLIENT_SECRET> -- npx -y @codespar/mcp-stone. Ключ STONE_CLIENT_ID задайте так же через -e или в переменных окружения.
Что делает mcp-stone?
Через OAuth2 подключается к API Stone Open Bank и даёт агенту инструменты для баланса, выписки, платежей, переводов, Pix, boleto, эквайринга по картам, антесипации и терминалов.
Что нужно, чтобы сервер заработал?
Учётные данные OAuth2 из портала разработчиков Stone в переменных STONE_CLIENT_ID и STONE_CLIENT_SECRET. Для тестов можно переключить STONE_BASE_URL и STONE_AUTH_URL на адреса песочницы.
