mcp-sicoob — MCP-сервер для Claude Code: что делает и установка
Подключает агента к Sicoob для операций с Pix, boleto и балансом счёта. Нужен для сценариев, где платежи выполняются через инструменты MCP.
claude mcp add --env SICOOB_CLIENT_ID=<SICOOB_CLIENT_ID> --env SICOOB_CLIENT_SECRET=<SICOOB_CLIENT_SECRET> --env SICOOB_CERT_PATH=<SICOOB_CERT_PATH> --env SICOOB_KEY_PATH=<SICOOB_KEY_PATH> --env SICOOB_ENV=<SICOOB_ENV> --transport stdio sicoob -- npx -y @codespar/mcp-sicoobЧто делает mcp-sicoob
mcp-sicoob даёт агенту инструменты Sicoob для создания и просмотра Pix-платежей, работы с DICT-ключами, выпуска и отмены boleto, а также проверки баланса кооперативного счёта. Есть операции для Pix cob и cobv, включая платежи с датой погашения.
Сервер получает OAuth2-токен по client credentials, кэширует его до скорого истечения и отправляет запросы с mTLS. Для запуска нужны SICOOB_CLIENT_ID, SICOOB_CLIENT_SECRET, клиентский сертификат и приватный ключ из Developers Portal. Переменная SICOOB_ENV задаёт sandbox или production.
Сервер находится в alpha, а пути API помечены как требующие проверки. Без подтверждения путей по OpenAPI-спецификации вашей кооперативы отдельные вызовы могут не сработать.
Какие задачи решает
- создать немедленный Pix с QR-кодом
- найти владельца DICT-ключа перед переводом
- выпустить и отменить boleto
- проверить баланс кооперативного счёта
Примеры запросов агенту
- Создай немедленный Pix через
create_pix_cobи верни данные QR-кода. - Проверь владельца ключа CPF через
lookup_dict_keyперед отправкой платежа. - Получи текущий баланс счёта через
get_account_balance.
Как установить mcp-sicoob
Командой платформы
claude mcp add --env SICOOB_CLIENT_ID=<SICOOB_CLIENT_ID> --env SICOOB_CLIENT_SECRET=<SICOOB_CLIENT_SECRET> --env SICOOB_CERT_PATH=<SICOOB_CERT_PATH> --env SICOOB_KEY_PATH=<SICOOB_KEY_PATH> --env SICOOB_ENV=<SICOOB_ENV> --transport stdio sicoob -- npx -y @codespar/mcp-sicoobВместо <…> подставьте свои значения
Командой платформы
codex mcp add sicoob --env SICOOB_CLIENT_ID=<SICOOB_CLIENT_ID> --env SICOOB_CLIENT_SECRET=<SICOOB_CLIENT_SECRET> --env SICOOB_CERT_PATH=<SICOOB_CERT_PATH> --env SICOOB_KEY_PATH=<SICOOB_KEY_PATH> --env SICOOB_ENV=<SICOOB_ENV> -- npx -y @codespar/mcp-sicoobВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"sicoob": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-sicoob"
],
"env": {
"SICOOB_CLIENT_ID": "<SICOOB_CLIENT_ID>",
"SICOOB_CLIENT_SECRET": "<SICOOB_CLIENT_SECRET>",
"SICOOB_CERT_PATH": "<SICOOB_CERT_PATH>",
"SICOOB_KEY_PATH": "<SICOOB_KEY_PATH>",
"SICOOB_ENV": "<SICOOB_ENV>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"sicoob": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-sicoob"
],
"env": {
"SICOOB_CLIENT_ID": "<SICOOB_CLIENT_ID>",
"SICOOB_CLIENT_SECRET": "<SICOOB_CLIENT_SECRET>",
"SICOOB_CERT_PATH": "<SICOOB_CERT_PATH>",
"SICOOB_KEY_PATH": "<SICOOB_KEY_PATH>",
"SICOOB_ENV": "<SICOOB_ENV>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e SICOOB_CLIENT_ID=<SICOOB_CLIENT_ID> -e SICOOB_CLIENT_SECRET=<SICOOB_CLIENT_SECRET> -e SICOOB_CERT_PATH=<SICOOB_CERT_PATH> -e SICOOB_KEY_PATH=<SICOOB_KEY_PATH> -e SICOOB_ENV=<SICOOB_ENV> sicoob npx -y @codespar/mcp-sicoobВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-sicoob
Как установить mcp-sicoob в Claude Code?
Выполните `claude mcp add mcp-sicoob -e SICOOB_CLIENT_ID=<SICOOB_CLIENT_ID> -e SICOOB_CLIENT_SECRET=<SICOOB_CLIENT_SECRET> -e SICOOB_CERT_PATH=<SICOOB_CERT_PATH> -e SICOOB_KEY_PATH=<SICOOB_KEY_PATH> -- npx -y @codespar/mcp-sicoob`.
Что делает mcp-sicoob?
Сервер связывает агента с API Sicoob для Pix, DICT, boleto и запроса баланса счёта. Аутентификация использует OAuth2 и mTLS.
Что нужно для работы mcp-sicoob?
Нужны OAuth-данные Sicoob, клиентский сертификат и приватный ключ, выданные после подключения кооператива через Developers Portal. Оба механизма аутентификации требуются для каждого вызова.
