mcp-quickbooks — MCP-сервер для Claude Code: QuickBooks Online из чата
Даёт агенту 22 инструмента для QuickBooks Online: клиенты, счета, платежи, позиции, счета поставщиков и отчёт о прибыли. Пригодится, когда бухгалтерия живёт в QuickBooks, а работать с ней хочется из терминала.
claude mcp add --env QB_ACCESS_TOKEN=<QB_ACCESS_TOKEN> --env QB_REALM_ID=<QB_REALM_ID> --env QB_ENV=<QB_ENV> --env QB_MINOR_VERSION=<QB_MINOR_VERSION> --transport stdio quickbooks -- npx -y @codespar/mcp-quickbooksЧто делает mcp-quickbooks
Сервер закрывает повседневную бухгалтерию: заводит и правит клиентов и поставщиков, выставляет, отправляет, гасит и удаляет счета, фиксирует оплаты, ведёт позиции и план счетов, строит отчёт о прибылях и убытках за нужный период. Списки клиентов, позиций, счетов, поставщиков и счетов к оплате фильтруются через SQL-подобный язык запросов QuickBooks: строка вида SELECT * FROM Customer WHERE Active = true MAXRESULTS 50 уходит целиком в соответствующий инструмент.
Перед запуском нужен действующий QB_ACCESS_TOKEN — OAuth2-токен на час. Сервер его не получает и не обновляет, это забота вашего хранилища учётных данных или агента. Ещё понадобится QB_REALM_ID, идентификатор компании, выданный при авторизации. Без валидного токена ни один вызов не пройдёт.
Транспорт выбирается при запуске: по умолчанию stdio, для HTTP — MCP_HTTP=true MCP_PORT=3000. QB_ENV по умолчанию sandbox, так что первые запросы уходят в песочницу, а не в боевые книги. QB_MINOR_VERSION необязателен, по умолчанию 70.
Какие задачи решает
- завести клиента в QuickBooks прямо из разговора с агентом
- выставить счёт и отправить его покупателю
- записать оплату по одному или нескольким счетам
- сверить план счетов и позиции перед отчётом
- получить P&L за нужный период без похода в интерфейс
Примеры запросов агенту
- Найди в QuickBooks всех активных клиентов через
list_customersи покажи первые 50 - Создай счёт для клиента и отправь его на почту
- Покажи отчёт о прибылях и убытках за прошлый квартал
Как установить mcp-quickbooks
Командой платформы
claude mcp add --env QB_ACCESS_TOKEN=<QB_ACCESS_TOKEN> --env QB_REALM_ID=<QB_REALM_ID> --env QB_ENV=<QB_ENV> --env QB_MINOR_VERSION=<QB_MINOR_VERSION> --transport stdio quickbooks -- npx -y @codespar/mcp-quickbooksВместо <…> подставьте свои значения
Командой платформы
codex mcp add quickbooks --env QB_ACCESS_TOKEN=<QB_ACCESS_TOKEN> --env QB_REALM_ID=<QB_REALM_ID> --env QB_ENV=<QB_ENV> --env QB_MINOR_VERSION=<QB_MINOR_VERSION> -- npx -y @codespar/mcp-quickbooksВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"quickbooks": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-quickbooks"
],
"env": {
"QB_ACCESS_TOKEN": "<QB_ACCESS_TOKEN>",
"QB_REALM_ID": "<QB_REALM_ID>",
"QB_ENV": "<QB_ENV>",
"QB_MINOR_VERSION": "<QB_MINOR_VERSION>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"quickbooks": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-quickbooks"
],
"env": {
"QB_ACCESS_TOKEN": "<QB_ACCESS_TOKEN>",
"QB_REALM_ID": "<QB_REALM_ID>",
"QB_ENV": "<QB_ENV>",
"QB_MINOR_VERSION": "<QB_MINOR_VERSION>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e QB_ACCESS_TOKEN=<QB_ACCESS_TOKEN> -e QB_REALM_ID=<QB_REALM_ID> -e QB_ENV=<QB_ENV> -e QB_MINOR_VERSION=<QB_MINOR_VERSION> quickbooks npx -y @codespar/mcp-quickbooksВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-quickbooks
Как установить mcp-quickbooks в Claude Code?
Одной командой: claude mcp add mcp-quickbooks -e QB_ACCESS_TOKEN=<QB_ACCESS_TOKEN> -e QB_REALM_ID=<QB_REALM_ID> -- npx -y @codespar/mcp-quickbooks. Если нужны QB_ENV и QB_MINOR_VERSION, есть вариант с --env и явным --transport stdio.
Что делает mcp-quickbooks?
Подключает QuickBooks Online к агенту через MCP и отдаёт 22 инструмента для работы с клиентами, счетами, платежами, позициями, поставщиками и отчётностью.
Почему запросы падают с ошибкой авторизации?
Сервер ждёт готовый QB_ACCESS_TOKEN и сам его не обновляет. Токен живёт час, так что обновление должно быть на стороне вашего менеджера учётных данных.
