mcp-iugu — MCP-сервер для Claude Code: что делает и как установить
MCP-сервер для интеграции с платёжной платформой iugu: создаёт инвойсы, управляет подписками, клиентами и переводами маркетплейса.
claude mcp add mcp-iugu -e IUGU_API_TOKEN=<IUGU_API_TOKEN> -- npx -y @codespar/mcp-iuguЧто делает mcp-iugu
Пакет @codespar/mcp-iugu подключает ассистента к платёжному сервису iugu через 23 встроенных инструмента. Агент умеет выставлять инвойсы под Pix, boleto или банковские карты, оформлять полные или частичные возвраты, а также дублировать счета с новым сроком оплаты. Дополнительно поддерживаются операции с клиентами: создание профилей, редактирование данных и привязка токенизированных карт.
Сервер закрывает задачи регулярного биллинга и сценарии маркетплейсов. С его помощью создаются тарифные планы, активируются подписки, настраиваются субсчета и регистрируются вебхуки для событий iugu. Агент может запрашивать вывод средств на банковский счёт.
Для запуска обязательно передаётся переменная окружения IUGU_API_TOKEN. Без валидного ключа доступ к платёжному API заблокирован. Чтобы исключить случайные списания во время тестов, включите тестовый режим через IUGU_SANDBOX="true".
Какие задачи решает
- выставить счёт на оплату через Pix, boleto или карту
- оформить возврат средств по оплаченному инвойсу
- создать тарифный план и приостановить подписку клиента
- перевести деньги между связанными субсчетами маркетплейса
- зарегистрировать вебхук для отслеживания платёжных событий
Примеры запросов агенту
- Выстави инвойс клиенту на сумму 150 BRL с оплатой через Pix
- Покажи статус подписки и список последних неоплаченных счетов
- Оформи частичный возврат по инвойсу
inv_12345
Как установить mcp-iugu
Командой платформы
claude mcp add mcp-iugu -e IUGU_API_TOKEN=<IUGU_API_TOKEN> -- npx -y @codespar/mcp-iuguВместо <…> подставьте свои значения
Командой платформы
codex mcp add iugu --env IUGU_API_TOKEN=<IUGU_API_TOKEN> -- npx -y @codespar/mcp-iuguВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"iugu": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-iugu"
],
"env": {
"IUGU_API_TOKEN": "<IUGU_API_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"iugu": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-iugu"
],
"env": {
"IUGU_API_TOKEN": "<IUGU_API_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e IUGU_API_TOKEN=<IUGU_API_TOKEN> iugu npx -y @codespar/mcp-iuguВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-iugu
Как установить mcp-iugu в Claude Code?
Выполните в терминале команду claude mcp add mcp-iugu -e IUGU_API_TOKEN=<IUGU_API_TOKEN> -- npx -y @codespar/mcp-iugu, подставив токен доступа из панели iugu.
Что умеет сервер mcp-iugu?
Он предоставляет 23 инструмента для управления счетами, возвратами, клиентами, тарифными планами, токенами карт и субсчетами платформы iugu.
Как тестировать платежи без реальных списаний?
Сгенерируйте API-токен в тестовом режиме личного кабинета iugu и передайте переменную окружения IUGU_SANDBOX="true".
