mcp-midaz — MCP-сервер для Claude Code: что делает и как установить
Подключает ИИ-ассистента к вашему self-hosted реестру Midaz для проверки балансов, создания счетов и проведения сбалансированных проводок.
claude mcp add --env MIDAZ_BASE_URL=<MIDAZ_BASE_URL> --env MIDAZ_TRANSACTION_URL=<MIDAZ_TRANSACTION_URL> --env MIDAZ_API_KEY=<MIDAZ_API_KEY> --transport stdio midaz -- npx -y @codespar/mcp-midazЧто делает mcp-midaz
Midaz — это открытый мультивалютный гроссбух двойной записи, который вы разворачиваете на собственных серверах. Сервер открывает агенту пять инструментов для прямого взаимодействия с этой системой. Модель умеет запрашивать постраничные списки счетов, проверять доступные и замороженные суммы по разным активам, а также заводить новые учётные записи внутри конкретных книг учёта.
Для фиксации операций агент формирует двойную запись, где сумма списаний обязана строго сходиться с суммой зачислений: проводку с перекосом баланса Midaz сразу отклонит. Внутренняя архитектура опирается на строгую цепочку организации, книги учёта, счёта и транзакции, поэтому идентификаторы organization_id и ledger_id передаются инструментам в явном виде.
Без собственного рабочего инстанса Midaz этот сервер бесполезен, так как облачного SaaS у проекта нет. Подключение настраивается через переменные MIDAZ_BASE_URL и MIDAZ_TRANSACTION_URL, а токен MIDAZ_API_KEY требуется только тогда, когда во внутреннем сетевом контуре активирована авторизация.
Какие задачи решает
- Проверять доступные остатки и холды по счетам в нужных валютах
- Проводить сбалансированные финансовые проводки между счетами
- Заводить новые лицевые счета внутри выбранной книги учёта
- Получать детали конкретной транзакции вместе со связанными операциями
Примеры запросов агенту
- Переведи 1250 BRL со счёта treasury на счёт vendor-acme и выведи обновлённые балансы обоих счетов.
- Покажи список открытых счетов в книге учёта ledger_main организации org_fin.
- Проверь доступный и замороженный остаток по активу USD на счёте acc_789.
Как установить mcp-midaz
Командой платформы
claude mcp add --env MIDAZ_BASE_URL=<MIDAZ_BASE_URL> --env MIDAZ_TRANSACTION_URL=<MIDAZ_TRANSACTION_URL> --env MIDAZ_API_KEY=<MIDAZ_API_KEY> --transport stdio midaz -- npx -y @codespar/mcp-midazВместо <…> подставьте свои значения
Командой платформы
codex mcp add midaz --env MIDAZ_BASE_URL=<MIDAZ_BASE_URL> --env MIDAZ_TRANSACTION_URL=<MIDAZ_TRANSACTION_URL> --env MIDAZ_API_KEY=<MIDAZ_API_KEY> -- npx -y @codespar/mcp-midazВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"midaz": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-midaz"
],
"env": {
"MIDAZ_BASE_URL": "<MIDAZ_BASE_URL>",
"MIDAZ_TRANSACTION_URL": "<MIDAZ_TRANSACTION_URL>",
"MIDAZ_API_KEY": "<MIDAZ_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"midaz": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-midaz"
],
"env": {
"MIDAZ_BASE_URL": "<MIDAZ_BASE_URL>",
"MIDAZ_TRANSACTION_URL": "<MIDAZ_TRANSACTION_URL>",
"MIDAZ_API_KEY": "<MIDAZ_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e MIDAZ_BASE_URL=<MIDAZ_BASE_URL> -e MIDAZ_TRANSACTION_URL=<MIDAZ_TRANSACTION_URL> -e MIDAZ_API_KEY=<MIDAZ_API_KEY> midaz npx -y @codespar/mcp-midazВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-midaz
Как установить mcp-midaz в Claude Code?
Выполните команду:
claude mcp add mcp-midaz -e MIDAZ_BASE_URL=<MIDAZ_BASE_URL> -e MIDAZ_API_KEY=<MIDAZ_API_KEY> -- npx -y @codespar/mcp-midaz
Что делает mcp-midaz?
Сервер связывает языковую модель с вашим экземпляром Midaz, позволяя через протокол MCP управлять счетами, проверять остатки и фиксировать двойные проводки.
Обязательно ли задавать MIDAZ_API_KEY?
Токен нужен только в том случае, если на вашем сервере Midaz настроена проверка подлинности. В изолированных внутренних сетях запросы могут отправляться без авторизации.
