quickbooks-mcp — MCP-сервер для Claude Code: как установить
MCP-сервер связывает чат с QuickBooks Online для работы с бухгалтерией на понятном языке. Он строит финансовые отчёты и находит контрагентов по именам, а не по внутренним ID.
claude mcp add --env QBO_CLIENT_ID=<QBO_CLIENT_ID> --env QBO_CLIENT_SECRET=<QBO_CLIENT_SECRET> --env QBO_CREDENTIAL_MODE=<QBO_CREDENTIAL_MODE> --env QBO_SANDBOX=<QBO_SANDBOX> --transport stdio quickbooks-mcp -- npx -y quickbooks-mcpЧто делает quickbooks-mcp
Сервер превращает текстовые запросы в вызовы API QuickBooks Online. Вместо ручного поиска идентификаторов поставщиков или счетов агент сопоставляет названия компаний и категорий расходов прямо из фразы. Для поиска по базе используется единый инструмент запросов в стиле SQL, поэтому не приходится вызывать отдельные методы под каждый тип сущности.
В систему встроена выгрузка баланса, отчёта о прибылях и убытках, а также оборотно-сальдовой ведомости с разбивкой по месяцам или классам. Любые операции записи и правки запускаются в режиме черновика и предварительного просмотра. Это защищает книги от случайных проводок.
Для запуска требуются Node.js 18+ и аккаунт на developer.intuit.com с зарегистрированным приложением. Ключи можно держать локально в ~/.quickbooks-mcp/credentials.json либо передавать через AWS Secrets Manager. Сервер сбрасывает крупные отчёты в каталог /tmp, поэтому в средах без доступа к локальной файловой системе вывод может потребовать переключения режима.
Какие задачи решает
- сформировать отчёт о прибылях и убытках через диалог с агентом
- подготовить счёт для контрагента по его названию без поиска внутренних ID
- проверить баланс счетов с помощью SQL-запроса к QuickBooks
- посмотреть черновик проводки перед отправкой данных в учёт
Примеры запросов агенту
- Сделай черновик счёта от PG&E на 450 долларов в категорию Utilities за 15 января 2025 года
- Построй отчёт о прибылях и убытках за прошлый квартал с разбивкой по месяцам
- Запусти
SELECT * FROM Purchase WHERE TxnDate >= '2025-01-01'через инструмент query
Как установить quickbooks-mcp
Командой платформы
claude mcp add --env QBO_CLIENT_ID=<QBO_CLIENT_ID> --env QBO_CLIENT_SECRET=<QBO_CLIENT_SECRET> --env QBO_CREDENTIAL_MODE=<QBO_CREDENTIAL_MODE> --env QBO_SANDBOX=<QBO_SANDBOX> --transport stdio quickbooks-mcp -- npx -y quickbooks-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add quickbooks-mcp --env QBO_CLIENT_ID=<QBO_CLIENT_ID> --env QBO_CLIENT_SECRET=<QBO_CLIENT_SECRET> --env QBO_CREDENTIAL_MODE=<QBO_CREDENTIAL_MODE> --env QBO_SANDBOX=<QBO_SANDBOX> -- npx -y quickbooks-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"quickbooks-mcp": {
"command": "npx",
"args": [
"-y",
"quickbooks-mcp"
],
"env": {
"QBO_CLIENT_ID": "<QBO_CLIENT_ID>",
"QBO_CLIENT_SECRET": "<QBO_CLIENT_SECRET>",
"QBO_CREDENTIAL_MODE": "<QBO_CREDENTIAL_MODE>",
"QBO_SANDBOX": "<QBO_SANDBOX>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"quickbooks-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"quickbooks-mcp"
],
"env": {
"QBO_CLIENT_ID": "<QBO_CLIENT_ID>",
"QBO_CLIENT_SECRET": "<QBO_CLIENT_SECRET>",
"QBO_CREDENTIAL_MODE": "<QBO_CREDENTIAL_MODE>",
"QBO_SANDBOX": "<QBO_SANDBOX>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e QBO_CLIENT_ID=<QBO_CLIENT_ID> -e QBO_CLIENT_SECRET=<QBO_CLIENT_SECRET> -e QBO_CREDENTIAL_MODE=<QBO_CREDENTIAL_MODE> -e QBO_SANDBOX=<QBO_SANDBOX> quickbooks-mcp npx -y quickbooks-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о quickbooks-mcp
Как установить quickbooks-mcp в Claude Code?
Выполните команду claude mcp add quickbooks-mcp -e QBO_CLIENT_ID=<QBO_CLIENT_ID> -e QBO_CLIENT_SECRET=<QBO_CLIENT_SECRET> -- npx -y quickbooks-mcp. Затем вызовите инструмент qbo_authenticate, чтобы пройти авторизацию через браузер и сохранить токены.
Что делает quickbooks-mcp?
Сервер даёт ИИ-ассистенту доступ к данным QuickBooks Online. Он позволяет строить финансовую отчётность, выполнять SQL-выборки и безопасно создавать черновики транзакций.
Чем этот сервер отличается от официального решения Intuit?
Официальный сервер требует указывать внутренние ID сущностей и сразу записывает изменения. Здесь названия поставщиков распознаются автоматически, операции сначала создаются как черновики, а также есть готовые инструменты для финансовых отчётов.
