BuchhaltungsButler — MCP-сервер для Claude Code: как установить
Подключает бухгалтерию BuchhaltungsButler к ИИ-ассистентам через 46 инструментов с разграничением прав. Управляет счетами, проводками и отчётами прямо в диалоге.
claude mcp add --env MCP_TRANSPORT=<MCP_TRANSPORT> --env BB_API_CLIENT=<BB_API_CLIENT> --env BB_API_SECRET=<BB_API_SECRET> --env BB_API_KEY=<BB_API_KEY> --env BB_RATE_LIMIT=<BB_RATE_LIMIT> --transport stdio buchhaltungsbutler -- docker run -i --rm -e MCP_TRANSPORT -e BB_API_CLIENT -e BB_API_SECRET -e BB_API_KEY -e BB_RATE_LIMIT ghcr.io/ohneben/buchhaltungsbutler-mcp:1.1.4Что делает BuchhaltungsButler
Сервер преобразует 54 эндпоинта спецификации BuchhaltungsButler API v1 в 46 инструментов MCP. С его помощью агент проверяет входящие документы и формирует черновики счетов. Встроенный лимитер держит частоту обращений строго ниже 100 запросов в минуту на клиента.
Все инструменты разделены по уровням риска на три категории: чтение, запись и удаление данных. Сервер проставляет подсказки readOnlyHint и destructiveHint. Клиент запрашивает одобрение перед опасными шагами.
Для запуска контейнера требуется Docker и набор переменных: BB_API_CLIENT, BB_API_SECRET и BB_API_KEY. Секреты модели не видны. Они подставляются сервером только при вызовах API.
Какие задачи решает
- выгрузить список открытых входящих документов за нужный период
- подготовить черновик счёта с почасовой оплатой услуг
- разнести банковскую транзакцию на бухгалтерский счёт 4400
- запросить отчёт BWA за квартал и показать сальдо
Примеры запросов агенту
- Покажи все открытые входящие счета за прошлый месяц.
- Создай черновик счёта для ACME GmbH на 10 часов консультаций по ставке 120 евро.
- Сформируй отчёт BWA за последний квартал и открой ведомость по счёту 4400.
Как установить BuchhaltungsButler
Командой платформы
claude mcp add --env MCP_TRANSPORT=<MCP_TRANSPORT> --env BB_API_CLIENT=<BB_API_CLIENT> --env BB_API_SECRET=<BB_API_SECRET> --env BB_API_KEY=<BB_API_KEY> --env BB_RATE_LIMIT=<BB_RATE_LIMIT> --transport stdio buchhaltungsbutler -- docker run -i --rm -e MCP_TRANSPORT -e BB_API_CLIENT -e BB_API_SECRET -e BB_API_KEY -e BB_RATE_LIMIT ghcr.io/ohneben/buchhaltungsbutler-mcp:1.1.4Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Командой платформы
codex mcp add buchhaltungsbutler --env MCP_TRANSPORT=<MCP_TRANSPORT> --env BB_API_CLIENT=<BB_API_CLIENT> --env BB_API_SECRET=<BB_API_SECRET> --env BB_API_KEY=<BB_API_KEY> --env BB_RATE_LIMIT=<BB_RATE_LIMIT> -- docker run -i --rm -e MCP_TRANSPORT -e BB_API_CLIENT -e BB_API_SECRET -e BB_API_KEY -e BB_RATE_LIMIT ghcr.io/ohneben/buchhaltungsbutler-mcp:1.1.4Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Файл настроек
{
"mcpServers": {
"buchhaltungsbutler": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MCP_TRANSPORT",
"-e",
"BB_API_CLIENT",
"-e",
"BB_API_SECRET",
"-e",
"BB_API_KEY",
"-e",
"BB_RATE_LIMIT",
"ghcr.io/ohneben/buchhaltungsbutler-mcp:1.1.4"
],
"env": {
"MCP_TRANSPORT": "<MCP_TRANSPORT>",
"BB_API_CLIENT": "<BB_API_CLIENT>",
"BB_API_SECRET": "<BB_API_SECRET>",
"BB_API_KEY": "<BB_API_KEY>",
"BB_RATE_LIMIT": "<BB_RATE_LIMIT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Файл настроек
{
"servers": {
"buchhaltungsbutler": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MCP_TRANSPORT",
"-e",
"BB_API_CLIENT",
"-e",
"BB_API_SECRET",
"-e",
"BB_API_KEY",
"-e",
"BB_RATE_LIMIT",
"ghcr.io/ohneben/buchhaltungsbutler-mcp:1.1.4"
],
"env": {
"MCP_TRANSPORT": "<MCP_TRANSPORT>",
"BB_API_CLIENT": "<BB_API_CLIENT>",
"BB_API_SECRET": "<BB_API_SECRET>",
"BB_API_KEY": "<BB_API_KEY>",
"BB_RATE_LIMIT": "<BB_RATE_LIMIT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Командой платформы
gemini mcp add -e MCP_TRANSPORT=<MCP_TRANSPORT> -e BB_API_CLIENT=<BB_API_CLIENT> -e BB_API_SECRET=<BB_API_SECRET> -e BB_API_KEY=<BB_API_KEY> -e BB_RATE_LIMIT=<BB_RATE_LIMIT> buchhaltungsbutler docker run -i --rm -e MCP_TRANSPORT -e BB_API_CLIENT -e BB_API_SECRET -e BB_API_KEY -e BB_RATE_LIMIT ghcr.io/ohneben/buchhaltungsbutler-mcp:1.1.4Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о BuchhaltungsButler
Как установить BuchhaltungsButler в Claude Code?
Выполните команду терминала: `claude mcp add --env MCP_TRANSPORT=<MCP_TRANSPORT> --env BB_API_CLIENT=<BB_API_CLIENT> --env BB_API_SECRET=<BB_API_SECRET> --env BB_API_KEY=<BB_API_KEY> --env BB_RATE_LIMIT=<BB_RATE_LIMIT> --transport stdio buchhaltungsbutler -- docker run -i --rm -e MCP_TRANSPORT -e BB_API_CLIENT -e BB_API_SECRET -e BB_API_KEY -e BB_RATE_LIMIT ghcr.io/ohneben/buchhaltungsbutler-mcp:1.1.4`. Замените плейсхолдеры в угловых скобках на реальные значения переменных.
Что делает MCP-сервер BuchhaltungsButler?
Он связывает модель с облачной бухгалтерией BuchhaltungsButler. Ассистент получает доступ к работе с накладными, контрагентами, платежами и финансовыми отчётами.
Как сервер защищает данные от случайного удаления?
Все вызовы размечены маркерами безопасности readOnlyHint и destructiveHint. Поддерживающие клиенты автоматически пропускают безопасное чтение и требуют подтверждения пользователя перед изменением или удалением записей.
