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

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

Zoho Books + Gemini

Дайте ИИ работать в Zoho Books: находить и вести клиентов, поставщиков и товары, создавать счета, отправлять их по почте, отмечать как отправленные и аннулировать, создавать коммерческие предложения, регистрировать платежи клиентов, счета поставщиков и расходы, а также читать план счетов, обороты по счетам и банковские операции. Любой дата-центр Zoho, вход через Zoho OAuth.

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

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

ZOHO_BOOKS_CLIENT_ID, ZOHO_BOOKS_CLIENT_SECRET, ZOHO_BOOKS_ORGANIZATION_ID, ZOHO_BOOKS_ACCOUNTS_URL, ZOHO_BOOKS_API_URL

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

1. Определите свой дата-центр Zoho: он виден в адресной строке, когда вы работаете в Zoho Books (например, books.zoho.eu или books.zoho.com). Укажите этот дата-центр в ZOHO_BOOKS_ACCOUNTS_URL и ZOHO_BOOKS_API_URL, без косой черты в конце: https://accounts.zoho.eu и https://www.zohoapis.eu для ЕС, https://accounts.zoho.com и https://www.zohoapis.com для США. Индия, Австралия, Япония, Саудовская Аравия, ОАЭ и Китай устроены так же (.in, .com.au, .jp, .sa, .ae, .com.cn); для Канады используются https://accounts.zohocloud.ca и https://www.zohoapis.ca.
2. Откройте Zoho API Console по адресу api-console.zoho.com, войдя в свою учётную запись Zoho, и выберите Add Client → Server-based Applications.
3. Дайте клиенту имя (например, AnythingMCP), укажите сайт компании как homepage URL и https://cloud.anythingmcp.com/api/mcp-oauth/callback как Authorized Redirect URI. Если вы размещаете AnythingMCP сами, укажите вместо него https://your-anythingmcp-host/api/mcp-oauth/callback. Создайте клиент.
4. На вкладке Client Secret скопируйте Client ID (начинается с 1000.) и Client Secret в ZOHO_BOOKS_CLIENT_ID и ZOHO_BOOKS_CLIENT_SECRET. Если ваша организация Books находится в другом дата-центре, чем тот, в котором открылась консоль, включите этот дата-центр на вкладке Settings клиента (Multi-DC) и используйте показанный там client secret.
5. Найдите ID организации: в Zoho Books нажмите на название организации (вверху справа) и откройте Manage Organizations; ID указан рядом с каждой организацией. Вставьте цифры в ZOHO_BOOKS_ORGANIZATION_ID. Один коннектор работает с одной организацией; для второй установите его ещё раз.
6. Установите коннектор, нажмите Authorize with Provider на странице коннектора, войдите в Zoho и подтвердите запрошенный доступ.
7. Запустите zoho_books_list_organizations и проверьте, что ваш ID организации есть в списке, затем zoho_books_get_organization, чтобы сверить название и базовую валюту, прежде чем ИИ что-либо прочитает или запишет.

Как не потерять авторизацию: access-токены действуют час и обновляются автоматически с помощью сохранённого refresh-токена, который не истекает, пока его не отзовут. Zoho хранит не более 20 refresh-токенов на пользователя и клиент: если авторизовать один и тот же клиент в 21-й раз, в AnythingMCP или где-то ещё, самый старый токен будет молча отозван. Если коннектор потерял авторизацию, снова нажмите Authorize with Provider.

Разрешения и режим только для чтения: коннектор запрашивает ZohoBooks.settings.ALL, ZohoBooks.contacts.ALL, ZohoBooks.invoices.ALL, ZohoBooks.estimates.ALL, ZohoBooks.customerpayments.ALL, ZohoBooks.bills.ALL, ZohoBooks.expenses.ALL, ZohoBooks.accountants.READ, ZohoBooks.banking.READ. Товары, налоги и настройки организации относятся к ZohoBooks.settings, план счетов к ZohoBooks.accountants. Коннектор работает от имени пользователя Zoho, который его авторизовал, в пределах роли этого пользователя. Для режима только для чтения замените в настройках OAuth коннектора каждое .ALL на .READ, авторизуйтесь заново и выключите zoho_books_create_contact, zoho_books_update_contact, zoho_books_mark_contact_inactive, zoho_books_create_item, zoho_books_update_item, zoho_books_mark_item_inactive, zoho_books_create_invoice, zoho_books_email_invoice, zoho_books_mark_invoice_sent, zoho_books_void_invoice, zoho_books_mark_invoice_draft, zoho_books_create_estimate, zoho_books_create_customer_payment, zoho_books_create_bill и zoho_books_create_expense.

Выключены при установке: инструменты удаления zoho_books_delete_contact, zoho_books_delete_invoice, zoho_books_delete_estimate, zoho_books_delete_customer_payment, zoho_books_delete_bill и zoho_books_delete_expense. Удалённую запись нельзя восстановить, поэтому включайте такой инструмент, только если ИИ действительно должен удалять записи этого типа.

Запись происходит по-настоящему: zoho_books_email_invoice отправляет клиенту письмо от имени вашей организации, zoho_books_mark_invoice_sent и zoho_books_void_invoice меняют учёт, а zoho_books_create_customer_payment, zoho_books_create_bill и zoho_books_create_expense делают проводки в главной книге. ИИ заранее говорит, что собирается провести или отправить, и ждёт вашего согласия. Регистрация платежа клиента только отражает его в учёте: деньги не списываются.

Счета и исправления: новый счёт создаётся как черновик с номером из автонумерации вашей организации и отправляется по почте, только если вы попросите отправить его сразу. Отправленный счёт Zoho удалить не даёт: вместо этого аннулируйте его с помощью zoho_books_void_invoice. Аннулированный счёт остаётся в учёте, как того требуют правила бухгалтерского учёта, например немецкие GoBD, а zoho_books_mark_invoice_draft снова превращает его в редактируемый черновик, чтобы исправить и выставить заново.

Итоги и остатки: Zoho не документирует API отчётов для Books. Для итогов ИИ читает остатки из плана счетов, операции по одному счёту через zoho_books_list_account_transactions или списки с фильтром по датам.

Лимиты: 100 запросов в минуту на организацию и в день 1 000 на тарифе Free, 2 000 на Standard, 5 000 на Professional и 10 000 на Premium и выше. При превышении Zoho отвечает 429 (код 44 за минуту, 45 за день): подождите минуту или до следующего дня.

Частые ошибки: invalid_client при входе или пустой список организаций означает, что оба адреса не относятся к вашему дата-центру. 401 с кодом 57 ("You are not authorized to perform this operation") или invalid_oauthtoken означает, что авторизации не хватает scope, она отозвана или в ZOHO_BOOKS_API_URL указан не тот дата-центр: проверьте оба адреса и снова нажмите Authorize with Provider. 400 или 404 с упоминанием организации означает, что ZOHO_BOOKS_ORGANIZATION_ID неверен или не виден этому пользователю: сравните его с результатом zoho_books_list_organizations. Остальные ошибки 400 называют поле (повторяющееся имя, недопустимое значение, отсутствующее обязательное поле). Код 4529 означает, что отправленный счёт нельзя удалить: аннулируйте его. Код 3000 при удалении контакта означает, что на него ещё ссылаются счета или платежи: используйте zoho_books_mark_contact_inactive.

Коннектор не работает с заказами клиентов, заказами поставщикам, кредит-нотами, платежами поставщикам, ручными проводками, проектами, повторяющимися счетами, вложениями и PDF.

Шаг 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 теперь может вызывать инструменты Zoho Books.

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

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

• «Какие счета просрочены и сколько ещё должен каждый клиент?»
• «Покажи остаток по счёту расходов «Канцтовары» и все операции по нему за сентябрь.»
• «Создай черновик счёта для ООО «Акме»: 12 часов услуги «Консалтинг» по 95 EUR, оплата в течение 14 дней. Пока не отправляй.»
• «Зарегистрируй сегодняшний перевод от ООО «Акме» на 1 140 EUR как оплату счёта INV-000123.»

FAQ

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

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

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