Как подключить QuickBooks Online к Cursor через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → QuickBooks Online, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

QuickBooks Online + Cursor

Дайте ИИ работать с QuickBooks Online: запрашивать клиентов, поставщиков, товары и услуги, счета клиентам, счета поставщиков, платежи и бухгалтерские счета, читать отдельные записи, формировать отчёт о прибылях и убытках, баланс и отчёты по срокам дебиторской и кредиторской задолженности, а также создавать клиентов и счета. Вход через Intuit OAuth, тестовая (sandbox) или рабочая компания.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

QBO_CLIENT_ID, QBO_CLIENT_SECRET, QBO_REALM_ID, QBO_API_URL

Шаг 1 — Получите учётные данные

1. Войдите на developer.intuit.com, откройте My Hub → App dashboard → Create an app, выберите QuickBooks Online and Payments и отметьте scope com.intuit.quickbooks.accounting.
2. В разделе Settings → Redirect URIs добавьте https://cloud.anythingmcp.com/api/mcp-oauth/callback для Development, а позже и для Production. Если вы размещаете AnythingMCP сами, укажите вместо него https://your-anythingmcp-host/api/mcp-oauth/callback. URI должен совпадать в точности.
3. Скопируйте Client ID и Client Secret из Keys & credentials в QBO_CLIENT_ID и QBO_CLIENT_SECRET. Ключи Development работают только с тестовыми (sandbox) компаниями. Ключи Production работают с реальными компаниями; Intuit выдаёт их после короткой проверки приложения (анкеты в панели приложения).
4. Найдите realm id компании (Company ID): в QuickBooks нажмите значок шестерёнки, откройте Account and settings → Billing & subscription и скопируйте Company ID без пробелов. Для тестовой компании он указан на сайте для разработчиков в разделе Sandboxes. Вставьте его в QBO_REALM_ID.
5. Укажите в QBO_API_URL адрес https://quickbooks.api.intuit.com для реальной компании или https://sandbox-quickbooks.api.intuit.com для тестовой. Адрес должен соответствовать ключам: ключи Development используются с адресом sandbox, ключи Production с рабочим адресом.
6. Установите коннектор, нажмите Authorize with Provider на странице коннектора, войдите в Intuit и подключите ту же компанию.
7. Начните с qbo_get_company_info и проверьте название компании, прежде чем ИИ что-либо прочитает или запишет. Один коннектор работает с одной компанией; для второй компании установите его ещё раз.

Как не потерять авторизацию: access-токены действуют час и обновляются автоматически. Refresh-токен, который не использовался 100 дней, истекает, а любая авторизация заканчивается не позднее чем через 5 лет. После этого, а также если приложение отключено в QuickBooks, снова нажмите Authorize with Provider. Не используйте одно и то же приложение Intuit одновременно в другом инструменте: Intuit заменяет refresh-токен примерно раз в день, и у одного из двух инструментов остался бы старый.

Разрешения и режим только для чтения: scope com.intuit.quickbooks.accounting даёт доступ на чтение и запись к бухгалтерским данным в пределах роли пользователя QuickBooks, который выполнил вход. Отдельного scope только для чтения бухгалтерских данных у Intuit нет. Для режима только для чтения войдите под пользователем, роль которого не позволяет создавать операции, и отключите qbo_create_customer, qbo_update_customer и qbo_create_invoice.

Выключены при установке: qbo_send_invoice, который отправляет счёт клиенту по электронной почте от имени вашей компании, и qbo_delete_invoice. Включайте их, только если ИИ должен отправлять или удалять счета.

Счета проводятся сразу: в QuickBooks нет черновиков счетов. Счёт, созданный ИИ, сразу увеличивает задолженность клиента и появляется в отчётах, но по электронной почте не отправляется. Клиентов нельзя удалить, их можно только сделать неактивными.

Имена клиентов: отображаемое имя клиента должно быть уникальным среди клиентов, поставщиков и сотрудников и не может содержать двоеточие (им QuickBooks отделяет подклиентов), табуляцию или перенос строки.

Частые ошибки: 401 AuthenticationFailed (3200) означает, что авторизация истекла или отозвана либо QBO_API_URL не соответствует ключам: проверьте адрес, затем снова нажмите Authorize with Provider. 403 ApplicationAuthorizationFailed (3100) означает, что realm id относится к компании, доступ к которой при этом входе не предоставлялся, или что роли пользователя не хватает прав. 400 QueryParserError означает синтаксическую ошибку в запросе. 6240 Duplicate Name Exists Error означает, что такое отображаемое имя уже занято; 2040 Invalid String означает, что имя содержит двоеточие, табуляцию или перенос строки; 5010 Stale Object Error означает, что запись тем временем изменилась и её нужно прочитать заново. 429 означает, что достигнут лимит в 500 запросов в минуту: подождите минуту.

Коннектор не работает с PDF-файлами счетов и вложениями, не регистрирует платежи, не работает с банковскими лентами (bank feeds), расчётом зарплаты и QuickBooks Desktop и ничего не удаляет, кроме счетов.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Cursor

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Cursor читает MCP-серверы из ~/.cursor/mcp.json. Добавь эту запись:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти Cursor.
3. Открой Cursor → Settings → MCP и проверь, что anythingmcp есть в списке и подключён.
4. Начинай общаться: агент теперь может вызывать инструменты QuickBooks Online.

Доступные инструменты

Примеры запросов

• «Какие счета просрочены и сколько должен каждый клиент?»
• «Покажи отчёт о прибылях и убытках за текущий финансовый год по месяцам.»
• «Создай счёт для Acme Ltd: 10 часов услуги «Консалтинг», оплата в течение 30 дней.»
• «Какие счета поставщиков просрочены больше чем на 60 дней?»

FAQ

Поддерживает ли Cursor собственные MCP-серверы на бесплатном тарифе? Да, MCP доступен на тарифах Hobby, Pro и Business.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Gemini
• Подключить к Meta Muse