Как подключить Quaderno к Gemini через MCP

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

Quaderno + Gemini

Управляйте налогами и счетами Quaderno из ИИ: рассчитывать налог с продаж, НДС и GST для любого места, проверять номера плательщиков НДС, искать контакты, счета, кредит-ноты, коммерческие предложения, расходы и товары, выставлять и отправлять счета по e-mail и запрашивать налоговые отчёты.

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

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

QUADERNO_ACCOUNT_NAME, QUADERNO_API_KEY

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

1. Войдите на https://quadernoapp.com и откройте Profile → API keys (https://quadernoapp.com/users/api-keys).
2. Скопируйте приватный ключ, который начинается с sk_, в QUADERNO_API_KEY. Публичный ключ (pk_) здесь не подходит. Ключ передаётся как имя пользователя HTTP Basic с пустым паролем и только в ваш аккаунт Quaderno.
3. На той же странице указан адрес API, например https://acme-1234.quadernoapp.com/api/. Впишите часть до .quadernoapp.com (здесь acme-1234) в QUADERNO_ACCOUNT_NAME и установите коннектор.
4. Проверьте настройку с помощью 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.

Шаг 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 — Добавьте коннектор в Gemini

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

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "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. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Quaderno.

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

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

• «Какой НДС применяется к SaaS-подписке за 49 EUR, проданной частному лицу в Лионе, Франция? А компании там же с действительным номером плательщика НДС?»
• «Действителен ли номер плательщика НДС DE123456789?»
• «Какие счета ещё не оплачены или просрочены и на какую сумму в каждой валюте?»
• «Выставь Northwind GmbH счёт за 10 часов консультаций по 120 EUR в час. Покажи всё перед созданием и пока не отправляй.»
• «Запроси налоговый сводный отчёт за третий квартал и дай ссылку на скачивание, когда он будет готов.»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

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

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