mcp-asaas — MCP-сервер для Claude Code: что делает и как установить
Подключает бразильский платёжный сервис Asaas к ассистенту для выставления счетов через Pix, boleto и рассрочек по картам.
claude mcp add mcp-asaas -e ASAAS_API_KEY=<ASAAS_API_KEY> -- npx -y @codespar/mcp-asaasЧто делает mcp-asaas
Сервер даёт агенту 24 инструмента для прямого управления расчётами через бразильскую платформу Asaas. С его помощью модель умеет регистрировать клиентов, формировать штрихкоды boleto, запрашивать статические QR-коды Pix и выставлять счета по банковским картам с разделением суммы на ежемесячные взносы. Также поддерживаются регулярные подписки, запросы выписок, возвраты и банковские переводы.
Пакет запускается через npx и взаимодействует с окружением по стандартному протоколу MCP. Для обращения к боевой системе или песочнице на sandbox.asaas.com необходим ключ в переменной ASAAS_API_KEY. Без действующего ключа реальные сетевые запросы завершатся сбоем.
Если ключа ещё нет, сервер позволяет запустить эмуляцию через флаг --demo или переменную MCP_DEMO=true. В демо-режиме вызовы не обращаются к API Asaas, но сохраняют состояние платежей в локальной памяти и позволяют рассчитывать график рассрочки без расходов.
Какие задачи решает
- выставить счёт на оплату через Pix, boleto или банковскую карту
- рассчитать и проверить график платежей в рассрочку
- оформить регулярную подписку и управлять её статусом
- сгенерировать статический QR-код Pix для приёма переводов
- получить баланс счёта и список событий вебхуков
Примеры запросов агенту
- Сгенерируй статический Pix QR-код для получения оплаты на сумму 120 BRL
- Создай платёж по кредитной карте с разделением на 3 равных взноса
- Проверь баланс в Asaas и покажи последние поступившие вебхуки
Как установить mcp-asaas
Командой платформы
claude mcp add mcp-asaas -e ASAAS_API_KEY=<ASAAS_API_KEY> -- npx -y @codespar/mcp-asaasВместо <…> подставьте свои значения
Командой платформы
codex mcp add asaas --env ASAAS_API_KEY=<ASAAS_API_KEY> -- npx -y @codespar/mcp-asaasВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"asaas": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-asaas"
],
"env": {
"ASAAS_API_KEY": "<ASAAS_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"asaas": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-asaas"
],
"env": {
"ASAAS_API_KEY": "<ASAAS_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e ASAAS_API_KEY=<ASAAS_API_KEY> asaas npx -y @codespar/mcp-asaasВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-asaas
Как установить mcp-asaas в Claude Code?
Выполните команду claude mcp add mcp-asaas -e ASAAS_API_KEY=<ASAAS_API_KEY> -- npx -y @codespar/mcp-asaas. Подставьте вместо <ASAAS_API_KEY> ключ, полученный в панели управления Asaas.
Что делает mcp-asaas?
Он связывает ИИ-ассистента с API Asaas. Это позволяет агенту проводить платежи, генерировать платёжные документы, отслеживать подписки и переводы без ручного входа в веб-панель.
Можно ли протестировать сервер без боевого API-ключа?
Да, запустите сервер с флагом --demo или укажите переменную MCP_DEMO=true. В этом режиме утилита возвращает фиктивные ответы и сохраняет тестовые рассрочки без сетевых вызовов.
