QuickBooks Online MCP: Документация

Подключение

Локальный stdio-сервер (git clone + npm install && npm run build, запуск node dist/index.js). Переменные: QUICKBOOKS_CLIENT_ID, QUICKBOOKS_CLIENT_SECRET, QUICKBOOKS_REFRESH_TOKEN, QUICKBOOKS_REALM_ID, QUICKBOOKS_ENVIRONMENT=sandbox|production. Приложение регистрируется на Intuit Developer Portal; для sandbox подходит redirect URI http://localhost:8000/callback (команда npm run auth проводит OAuth-хендшейк), для production localhost не принимается — нужен временный HTTPS-туннель (например, ngrok) только на момент первичной авторизации.

Инструменты

144 инструмента: CRUD (create_/get_/update_/delete_/search_) по 29 сущностям — клиенты, счета (с get_invoice_pdf), платежи, счета поставщиков и сами поставщики, платежи поставщикам, чеки продаж, кредитные и возвратные ноты, депозиты, ручные проводки и другие. Плюс 11 отчётов: get_profit_and_loss, get_balance_sheet, get_cash_flow, get_trial_balance, get_general_ledger, get_customer_sales, get_aged_receivables, get_aged_receivables_detail, get_customer_balance, get_aged_payables, get_vendor_expenses.

Сценарий для агента

«Выставь счёт ООО «Ромашка» на 1200 $», «покажи P&L за прошлый квартал», «какие счета поставщиков просрочены?», «создай депозит на сумму сегодняшних чеков продаж».

Важно

Сервер оперирует реальными бухгалтерскими документами компании — удаление и правки необратимо влияют на учёт. Переменные QUICKBOOKS_DISABLE_WRITE, QUICKBOOKS_DISABLE_UPDATE, QUICKBOOKS_DISABLE_DELETE отключают соответствующие категории инструментов; начинайте с sandbox-компании, прежде чем подключать production-данные.

Тарифы

MCP-сервер бесплатный (open source); доступ к самому QuickBooks Online — по тарифам Intuit (есть бесплатная sandbox-компания для разработки).