Пропустите установку. Заработает меньше чем за 2 минуты.
Начните бесплатный период на cloud.anythingmcp.com, добавьте Quaderno одним кликом и направьте свой ИИ-клиент (Claude, ChatGPT, Copilot или Cursor) на сгенерированный MCP-эндпоинт. Без Docker, без git clone, без опыта разработки.
Кратко
Управляйте налогами и счетами Quaderno из ИИ: рассчитывать налог с продаж, НДС и GST для любого места, проверять номера плательщиков НДС, искать контакты, счета, кредит-ноты, коммерческие предложения, расходы и товары, выставлять и отправлять счета по e-mail и запрашивать налоговые отчёты.
Попробуй спросить
Примеры промптов для Quaderno
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Quaderno, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без
git clone, без локального сервера.
Quaderno
Управляйте налогами и счетами Quaderno из ИИ: рассчитывать налог с продаж, НДС и GST для любого места, проверять номера плательщиков НДС, искать контакты, счета, кредит-ноты, коммерческие предложения, расходы и товары, выставлять и отправлять счета по e-mail и запрашивать налоговые отчёты.
Настройка
- Войдите на
https://quadernoapp.comи откройте Profile → API keys (https://quadernoapp.com/users/api-keys). - Скопируйте приватный ключ, который начинается с
sk_, вQUADERNO_API_KEY. Публичный ключ (pk_) здесь не подходит. Ключ передаётся как имя пользователя HTTP Basic с пустым паролем и только в ваш аккаунт Quaderno. - На той же странице указан адрес API, например
https://acme-1234.quadernoapp.com/api/. Впишите часть до.quadernoapp.com(здесьacme-1234) вQUADERNO_ACCOUNT_NAMEи установите коннектор. - Проверьте настройку с помощью
quaderno_ping: он подтверждает ключ и показывает, сколько запросов осталось в текущем окне.
Счета выставляются и отправляются только после вашего «да»: выставленный счёт является налоговым документом. Quaderno присваивает ему порядковый номер, и удалить его нельзя, только аннулировать или сторнировать кредит-нотой в приложении Quaderno. Перед quaderno_create_invoice ИИ показывает клиента, позиции, цены и валюту. Перед quaderno_deliver_invoice, который сразу отправляет счёт клиенту по e-mail без возможности отмены, он говорит, какой счёт уходит на какой адрес. quaderno_create_contact и quaderno_request_report тоже сначала спрашивают. Создание счёта ещё не отправляет его. quaderno_delete_contact при установке выключен.
Расчёт налогов: quaderno_calculate_tax возвращает налог с продаж, НДС или GST для продажи в любое место: название налога, ставку, сумму налога, сумму без налога и итог, налоговую юрисдикцию вплоть до города и пометки, например обратное начисление для действительного номера плательщика НДС в ЕС. Он только считает и ничего не сохраняет. quaderno_validate_tax_id проверяет номер плательщика НДС или регистрационный номер компании по официальному реестру её страны (VIES в ЕС, Великобритания, Швейцария, Квебек, Австралия, Новая Зеландия).
Что он читает: контакты, счета, кредит-ноты, коммерческие предложения (в Quaderno это проформы), расходы, товары, налоговые юрисдикции и налоговые коды. Налоговые отчёты (собранные налоги по юрисдикциям для деклараций, список счетов или список кредит-нот) формируются в фоне: ИИ запрашивает отчёт за период, проверяет, пока он не будет готов, и даёт ссылку для скачивания.
Конфиденциальные данные: счета и контакты содержат имена, адреса и налоговые номера ваших клиентов и являются налоговыми записями. Показывайте их только тем, кто занимается выставлением счетов.
Суммы: поля с окончанием _cents указаны в центах (12345 это 123,45); цены и результаты расчёта налога указаны в единицах валюты.
Лимит запросов: 100 вызовов за 15 секунд. Ответ 429 означает, что нужно дождаться сброса окна.
Частые ошибки: 401 Wrong API key or the user does not exist: ключ неверный, это ключ pk_ или он принадлежит другому аккаунту, а не QUADERNO_ACCOUNT_NAME. 406: недопустимое значение, например неизвестный налоговый код. 422: документ нельзя создать в таком виде, например без позиций.
Не входит: изменение и аннулирование счетов и пометка их как безнадёжных, учёт платежей, чеки, повторяющиеся документы, транзакции, сессии оплаты и купоны, доказательства местонахождения, вебхуки, Sandbox и аккаунты Quaderno Connect.
Предварительные требования: QUADERNO_ACCOUNT_NAME, QUADERNO_API_KEY
Локальная установка коннектора
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
Откройте http://localhost:3000/connectors/store, выберите Quaderno и введите переменные, перечисленные в Предварительных требованиях.
Доступные инструменты
| Tool | What it does |
|---|---|
quaderno_ping | Check that the API key works and see the requests left in the current rate-limit window |
quaderno_list_contacts | List or search customers and suppliers (contacts) by name, email or tax id: id, kind (person or company), name, email, tax id and tax… |
quaderno_get_contact | Get one contact with full address, phone, website, language, default discount, notes and the link to their billing area |
quaderno_create_contact | Create a customer or supplier contact |
quaderno_delete_contact | Delete one contact for good |
quaderno_list_invoices | List or search invoices by number, customer name or PO number, issue date range, state or customer: id, number, dates, state (outstanding… |
quaderno_get_invoice | Get one invoice in full: customer and billing address, line items with their taxes, the tax breakdown, payments, deliveries, alerts, the… |
quaderno_create_invoice | Issue a new invoice |
quaderno_deliver_invoice | Email an invoice to its customer from Quaderno, with the PDF and the link to it |
quaderno_list_credit_notes | List or search credit notes (refunds and corrections of invoices) by number, customer name or PO number, issue date range or state: id… |
quaderno_get_credit_note | Get one credit note in full: customer, line items, tax breakdown, payments, deliveries, the related invoice, the public link and the PDF… |
quaderno_list_quotes | List or search quotes (Quaderno calls them proformas; they replaced estimates) by number, customer name or PO number, issue date range… |
quaderno_get_quote | Get one quote (proforma) in full: customer, line items, tax breakdown, validity, the public link and the PDF link |
quaderno_list_expenses | List or search expenses (purchase invoices from suppliers) by number, supplier name or PO number, issue date range, state or supplier: id… |
quaderno_list_products | List or search products (items) by name or code: id, code, name, description, unit cost, currency, kind (one-off or subscription), product… |
quaderno_calculate_tax | Calculate the sales tax, VAT or GST for a sale to a customer location: tax name, rate, taxable part, tax amount, subtotal and total, the… |
quaderno_validate_tax_id | Check a business tax id against the official registry of its country (EU VIES, UK, Switzerland, Quebec, Australia, New Zealand): returns… |
quaderno_list_tax_jurisdictions | List the tax jurisdictions Quaderno knows, optionally for one country or region: id, name, country and region |
quaderno_list_tax_codes | List the tax codes products can be classified with (e.g. eservice, saas, ebook, consulting, standard, reduced, exempt): id, name and what… |
quaderno_list_reports | List the reports requested so far: id, type (tax_summary, invoices_list, credits_list), state, period, when it completed and the download… |
quaderno_request_report | Ask Quaderno to build a report for a period: tax_summary (taxes collected per jurisdiction, for filing returns), invoices_list or… |
quaderno_get_report | Check one report request: state (pending, suceeded or failed), period, when it completed and the report_url to download it once ready |
Примеры запросов
- «Какой НДС применяется к SaaS-подписке за 49 EUR, проданной частному лицу в Лионе, Франция? А компании там же с действительным номером плательщика НДС?»
- «Действителен ли номер плательщика НДС DE123456789?»
- «Какие счета ещё не оплачены или просрочены и на какую сумму в каждой валюте?»
- «Выставь Northwind GmbH счёт за 10 часов консультаций по 120 EUR в час. Покажи всё перед созданием и пока не отправляй.»
- «Запроси налоговый сводный отчёт за третий квартал и дай ссылку на скачивание, когда он будет готов.»
Следующие шаги
Это руководство помогло?
