mcp-conta-azul — MCP-сервер для Conta Azul: счета, клиенты, продажи
MCP-сервер, который даёт ИИ-агенту доступ к Conta Azul: клиенты, товары, услуги, продажи, счета к получению и финансовый свод.
claude mcp add mcp-conta-azul -e CONTA_AZUL_ACCESS_TOKEN=<CONTA_AZUL_ACCESS_TOKEN> -- npx -y @codespar/mcp-conta-azulЧто делает mcp-conta-azul
Сервер оборачивает API Conta Azul в 20 инструментов. Агент умеет перечислять, создавать, править и удалять клиентов, товары и услуги, оформлять и отменять продажи, читать финансовую сводку, категории, банковские счета и счета к получению. Запросы идут от вашего имени: инструменты пишут в реальный аккаунт, поэтому delete_customer или cancel_sale из чата сработают по-настоящему.
Авторизация — OAuth2 Bearer-токен. Его нужно получить в портале разработчиков Conta Azul: зарегистрироваться, создать OAuth-приложение и положить токен в переменную окружения CONTA_AZUL_ACCESS_TOKEN. Без неё сервер не подключится. Для тестов в том же портале есть sandbox, и начинать стоит с него.
Подключение занимает одну команду в Claude или Codex, в Cursor и GitHub Copilot — блок JSON в конфиг. Conta Azul — бразильская система, интерфейс и данные там на португальском; токен живёт ограниченное время, так что просроченный доступ — самая частая причина пустых ответов.
Какие задачи решает
- выгрузить список клиентов из Conta Azul в разговор с агентом
- оформить продажу по данным из чата
- найти счёт к получению и проверить его статус
- поправить карточку товара или услуги без входа в веб-интерфейс
- посмотреть финансовую сводку за период
Примеры запросов агенту
- Покажи всех клиентов из Conta Azul, у которых нет email
- Создай продажу для клиента из последнего письма и приложи услугу консультации
- Выведи финансовую сводку и список счетов к получению
Как установить mcp-conta-azul
Командой платформы
claude mcp add mcp-conta-azul -e CONTA_AZUL_ACCESS_TOKEN=<CONTA_AZUL_ACCESS_TOKEN> -- npx -y @codespar/mcp-conta-azulВместо <…> подставьте свои значения
Командой платформы
codex mcp add conta-azul --env CONTA_AZUL_ACCESS_TOKEN=<CONTA_AZUL_ACCESS_TOKEN> -- npx -y @codespar/mcp-conta-azulВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"conta-azul": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-conta-azul"
],
"env": {
"CONTA_AZUL_ACCESS_TOKEN": "<CONTA_AZUL_ACCESS_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"conta-azul": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-conta-azul"
],
"env": {
"CONTA_AZUL_ACCESS_TOKEN": "<CONTA_AZUL_ACCESS_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e CONTA_AZUL_ACCESS_TOKEN=<CONTA_AZUL_ACCESS_TOKEN> conta-azul npx -y @codespar/mcp-conta-azulВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-conta-azul
Как установить mcp-conta-azul в Claude Code?
Выполните claude mcp add mcp-conta-azul -e CONTA_AZUL_ACCESS_TOKEN=<CONTA_AZUL_ACCESS_TOKEN> -- npx -y @codespar/mcp-conta-azul. Второй вариант — claude mcp add --env CONTA_AZUL_ACCESS_TOKEN=<CONTA_AZUL_ACCESS_TOKEN> --transport stdio conta-azul -- npx -y @codespar/mcp-conta-azul.
Что делает mcp-conta-azul?
Даёт агенту 20 инструментов для работы с Conta Azul: клиенты, товары, услуги, продажи, категории, банковские счета, счета к получению и финансовая сводка.
Что нужно, чтобы сервер заработал?
OAuth2 access token из портала разработчиков Conta Azul в переменной CONTA_AZUL_ACCESS_TOKEN. Токен выдаётся после регистрации OAuth-приложения; для проверки есть sandbox.
