Функции · · 5 мин чтения

Taxorio и MCP: работа со счетами из ИИ-ассистента

Как подключить Taxorio к Claude, Cursor, Cline или ChatGPT через MCP-сервер на тарифе PRO: вход по OAuth, доступные инструменты и примеры запросов.

Если вы работаете с ИИ-ассистентом — Claude (Code или Desktop), Cursor, Cline либо ChatGPT — Taxorio можно подключить к нему напрямую. Через MCP-сервер (Model Context Protocol) ассистент получает доступ к вашим счетам, клиентам и записям расходов: по вашей просьбе он выставит счёт, найдёт клиента или подготовит экспорт, и открывать браузер для этого не нужно. Интеграция доступна на тарифе PRO.

Что такое MCP и зачем он нужен

MCP (Model Context Protocol) — открытый стандарт, разработанный компанией Anthropic. Он позволяет ИИ-ассистенту безопасно обращаться к внешним инструментам и источникам данных. Вместо того чтобы отвечать только из того, что модель усвоила при обучении, она получает доступ к живым инструментам: к API, базам данных, файлам или приложениям вроде Taxorio.

На практике это выглядит так: в Claude Desktop или Cline вы пишете «выставь счёт компании Klient ABC s.r.o. за консультации на 40 000 Kč», и ассистент действительно это делает — обращается к API Taxorio, создаёт документ и показывает результат. Это не имитация диалога, а реальное действие в вашем аккаунте.

Какие инструменты доступны

MCP-сервер Taxorio отдаёт несколько десятков инструментов, сгруппированных по разделам приложения. Ниже — те, которыми пользуются чаще всего.

Счета

  • taxorio_list_invoices — список счетов с фильтрами (дата, статус, клиент)
  • taxorio_get_invoice — конкретный счёт по номеру или идентификатору
  • taxorio_create_invoice — новый счёт (клиент, позиции, DPH, срок оплаты)
  • taxorio_update_invoice — правка существующего счёта (добавить позицию, сдвинуть срок оплаты)
  • taxorio_delete_invoice — безвозвратное удаление неоплаченной проформы; выставленные счета не удаляются, а сторнируются (taxorio_cancel_invoice)

Клиенты

  • taxorio_list_clients — список всех клиентов
  • taxorio_get_client — карточка клиента вместе с историей счетов
  • taxorio_create_client — новый клиент
  • taxorio_ares_lookup — поиск фирмы в реестре ARES по IČO (чешский регистрационный номер организации) и автозаполнение реквизитов

Расходы

  • taxorio_list_expenses — расходы с фильтрами
  • taxorio_create_expense — новая запись о расходе

Сводки и экспорты

  • taxorio_get_dashboard_stats — сводные цифры (доходы, расходы, DPH)
  • taxorio_generate_vat_export — экспорт для декларации по DPH (daň z přidané hodnoty — чешский НДС)
  • taxorio_get_insurance_info — авансы и годовой расчёт социального и медицинского страхования OSVČ (osoba samostatně výdělečně činná — предприниматель без образования юридического лица)

Учётная запись

  • taxorio_get_user_info — данные о текущем пользователе и его настройках

Полный перечень ассистент показывает сам сразу после подключения — ориентируйтесь на него, набор инструментов меняется вместе с приложением.

Как выглядит диалог

Ниже — примеры того, о чём можно попросить ассистента и что при этом произойдёт.

Выставление счёта

Вы: Выстави счёт для Klient ABC s.r.o. (IČO 12345678) за разработку веб-приложения в марте 2026 года, всего 85 000 Kč без DPH, срок оплаты 14 дней.
Claude: Ищу клиента Klient ABC s.r.o. в Taxorio… Клиент найден. Создаю счёт № 20260047: Klient ABC s.r.o., позиция «Разработка веб-приложения 03/2026», 85 000 Kč + DPH 21 % = 102 850 Kč, срок оплаты 16 апреля 2026 года. Счёт создан и доступен для скачивания в PDF.

Поиск клиента через ARES

Вы: Добавь нового клиента — IČO 12345678.
Claude: Ищу в ARES… Найдено: Vzorová firma s.r.o., Ukázková 1, Praha 4, DIČ CZ12345678. Добавляю как нового клиента в Taxorio. Готово — клиент создан.

Сводка по просрочке

Вы: Какие счета просрочены больше чем на 30 дней?
Claude: Загружаю счета из Taxorio… Просрочка более 30 дней: (1) счёт № 20260019 — Klient XY, 8 700 Kč, просрочка 34 дня; (2) счёт № 20260008 — Klient ABC s.r.o., 52 000 Kč, просрочка 51 день. Итого 60 700 Kč. Подготовить письма-напоминания?

Авторизация: вход через браузер, без токенов и паролей

Доступ к вашим данным Taxorio защищает стандартом OAuth 2.0 — тем же, по которому вы подключаете к сторонним приложениям Google Drive или Slack. Никаких кодов для переписывания и токенов, которые надо где-то хранить.

Порядок действий простой:

  1. Добавьте Taxorio как коннектор в своём ИИ-ассистенте (Claude Code, Claude Desktop, Claude.ai или ChatGPT) — адрес всегда один: https://app.taxorio.cz/mcp
  2. Ассистент перенаправит вас в браузер на экран входа и подтверждения доступа Taxorio
  3. Войдите в свою учётную запись и подтвердите объём доступа (счета, клиенты, расходы, экспорты DPH)
  4. С этого момента ассистент работает с вашими данными — отозвать доступ можно в любой момент в настройках Taxorio

Ни пароль, ни токен никуда не копируются и напрямую ассистенту или его поставщику не передаются.

Как подключить Taxorio к ассистенту

На компьютер ничего устанавливать не нужно — ни Node.js, ни пакета, ни конфигурационного файла. Отличается только первый шаг, в зависимости от того, каким ассистентом вы пользуетесь:

  • Claude Code — в терминале выполните claude mcp add --transport http taxorio https://app.taxorio.cz/mcp
  • Claude Desktop / Claude.ai — в разделе Настройки → Коннекторы → Добавить свой коннектор укажите адрес https://app.taxorio.cz/mcp
  • ChatGPT — добавьте собственный коннектор с адресом https://app.taxorio.cz/mcp; готовый коннектор Taxorio используйте, только если он есть в каталоге

Во всех трёх случаях дальше идёт только вход и подтверждение доступа в браузере (см. шаг выше). Разницы в настройке между версиями клиента нет, потому что локально ничего не настраивается.

Кому это пригодится

Интеграция через MCP лучше всего подходит для таких сценариев:

  • Разработчики, которые весь день проводят в редакторе кода и не хотят переключаться в браузер ради одного счёта
  • Опытные пользователи Claude Desktop, которым удобно держать работу со счетами внутри своего рабочего процесса с ИИ
  • Повторяющиеся задачи — например, ежемесячные сводные счета для постоянных клиентов
  • Быстрые вопросы — «сколько мне заплатил клиент X в прошлом квартале» без открытия приложения

MCP-сервер Taxorio построен на открытом стандарте Model Context Protocol компании Anthropic, поэтому подключить его можно к любому совместимому клиенту — Claude (Code и Desktop), Cursor или Cline.

⚠️ Текущие границы Taxorio: Набор действий MCP со временем меняется. Используйте актуальный список инструментов коннектора, а не фиксированное число из статьи.

Границы Taxorio: Taxorio помогает ИП в Чехии выставлять счета и вести учёт доходов и расходов. Это не полноценная бухгалтерия и не персональная налоговая консультация. Нестандартный или неподдерживаемый случай перед подачей отчётности проверьте с чешским бухгалтером или налоговым консультантом.