API ВЕГАКоннектор Kema Invoice для MCP
Kema Invoice — это программное обеспечение для электронного выставления счетов, соответствующее нормативным требованиям и доступное для управления AI-агентами через Model Context Protocol. Подключите удалённый MCP-сервер к Claude, Cursor или любому MCP-клиенту, один раз пройдите авторизацию через OAuth 2.1 — и агент сможет на обычном языке создавать, оформлять, отправлять и отслеживать счета, коммерческие предложения и документы на абонентское обслуживание. Счета формируются в формате Factur-X (EN 16931) и передаются через аккредитованную платформу. Устанавливать ничего не нужно: сервер работает по адресу https://mcp.kema-studio.com/api/mcp.
Веб-сайт · Документация · Подключение агента · Запись в MCP Registry · Французская версия
Что находится в этом репозитории
Коннектор — это удалённый MCP-сервер, использующий Streamable HTTP и OAuth 2.1. Устанавливаемого пакета нет, а код сервера в этом репозитории не публикуется. Здесь собраны материалы, необходимые интеграторам и каталогам:
| Файл | Назначение |
|---|---|
tools.json | Список 41 инструмента с названиями, описаниями, группами и сведениями о доступе. Файл генерируется из кода сервера и не редактируется вручную. |
server.json | Описание сервера, опубликованное в официальном MCP Registry (com.kema-studio/invoice). |
examples/ | Готовые конфигурации клиентов и руководство по работе с запросами. |
scripts/verify-connection.ts | Небольшой скрипт с открытым исходным кодом: он выполняет OAuth-процесс и выводит список инструментов, чтобы проверить подключение целиком. |
CHANGELOG.md | История версий коннектора. |
Подключение за две минуты
| Клиент | Как подключить |
|---|---|
| claude.ai / Claude Desktop | Откройте Settings › Connectors › Add custom connector, вставьте https://mcp.kema-studio.com/api/mcp и пройдите авторизацию. |
| Claude Code | claude mcp add kema-invoice --transport http --url https://mcp.kema-studio.com/api/mcp |
| Cursor | Добавьте examples/cursor-mcp.json в .cursor/mcp.json. |
| Любой MCP-клиент | Используйте транспорт Streamable HTTP и указанный выше URL. Для авторизации требуется OAuth 2.1 с PKCE и динамической регистрацией клиента (RFC 7591). Метаданные сервера авторизации обнаруживаются по адресу /.well-known/oauth-protected-resource. |
При первом вызове откроется страница подтверждения на auth.kema-studio.com. Войдите в учётную запись Kema Invoice, подтвердите доступ — после этого клиент сохранит токен. Доступ можно отозвать в любое время в приложении или клиенте.
Ещё нет учётной записи? Создайте её: 14-дневный пробный период, включающий 10 счетов и одного пользователя, без привязки банковской карты. Затем доступен единый тариф: €10 за пользователя в месяц без учёта НДС. В тариф включены все функции, отменить подписку можно в любое время.
Возможности агента
Счета (16)
| Инструмент | Назначение | Доступ |
|---|---|---|
create_invoice | Создаёт счёт для компании с позициями. В этом продукте создание счёта означает его оформление. После вызова кратко покажите пользователю итоговые сведения: клиента, позиции и суммы. Получив подтверждение пользователя, вызовите issue_invoice с параметром confirm:true. Оставляйте счёт черновиком, только если пользователь прямо просит сначала проверить или отредактировать его в приложении. НДС рассчитывается автоматически по строгим серверным налоговым правилам (сценарий и значения по умолчанию) — никогда не спрашивайте пользователя о ставке НДС. Налоговый сценарий и снимок данных клиента фиксируются при создании. В снимке содержится юридическое наименование компании (legal_name), которое будет указано в счёте, даже если оно отличается от отображаемого названия. | write |
issue_invoice | Оформляет счёт Draft — то есть создаёт его юридически (в продукте это действие называется «Créer la facture»). Счёт становится окончательным юридическим документом со статусом Sent, отображаемым как «Créée». ПО ФРАНЦУЗСКОМУ ЗАКОНОДАТЕЛЬСТВУ ДЕЙСТВИЕ НЕОБРАТИМО: отменить его можно только кредит-нотой. ПЕРЕД вызовом с параметром confirm:true обязательно покажите пользователю сводку по счёту и получите его явное подтверждение. Без confirm инструмент вернёт предварительный просмотр. Налоговая сертификация выполняется внутри этого вызова и является внутренним техническим процессом. После успешного завершения сообщите пользователю только, что счёт создан. НЕ упоминайте сертификацию, налоговый статус, неизменность документа или обработку, если этот инструмент не вернул ошибку. | write, destructive |
list_invoices | Выводит счета текущего пользователя в порядке от новых к старым. Поддерживает фильтрацию по статусу и типу документа, поиск по номеру счёта или имени клиента, а также постраничную выдачу. | read |
get_invoice | Возвращает сведения об одном счёте по его id, включая позиции, данные клиента и итоговые суммы. Если вызывающий не имеет доступа к счёту, возвращается ошибка с пустыми значениями. | read |
get_invoice_pdf | Возвращает временную подписанную ссылку для скачивания PDF счёта. Ссылка действует 1 час. Инструмент работает с любым доступным вызывающему документом: для импортированных счетов возвращается загруженный файл, а счета, оформленные в Kema Invoice — в приложении или агентом, — формируются на сервере с фирменным оформлением рабочего пространства. После сертификации в них также включается XML Factur-X. Черновики тоже можно преобразовать в PDF (с пометкой is_draft: true), но они ещё не являются юридическими документами. | read |
update_invoice | Изменяет поля счёта Draft: даты, условия оплаты, примечания или назначенную компанию. Изменять можно только счета Draft — счёт Sent/сертифицированный является неизменяемым. | write |
delete_invoice | Помечает счёт Draft как удалённый. Для пользователя это действие необратимо. Чтобы удалить счёт, вызовите инструмент с confirm:true; без этого параметра он вернёт предварительный просмотр того, что будет удалено. | write, destructive |
cancel_invoice | Отменяет счёт DRAFT, меняя его статус на Cancelled. Действие необратимо. Оформленные документы (Sent, Overdue, Paid) являются налоговыми документами и не могут быть отменены напрямую: используйте create_credit_note, чтобы выпустить сертифицированную кредит-ноту (avoir) и отменить исходный счёт. Для выполнения действия вызовите инструмент с confirm:true; в противном случае он вернёт предварительный просмотр. | write, destructive |
mark_invoice_paid | Отмечает счёт со статусом Sent или Overdue как Paid. При необходимости можно указать дату платежа; по умолчанию используется текущая дата. | write |
add_invoice_item | Добавляет позицию в счёт Draft. Итоговые суммы пересчитываются автоматически. | write |
update_invoice_item | Изменяет позицию в счёте Draft. Итоговые суммы пересчитываются автоматически. Идентификаторы позиций можно получить с помощью get_invoice или add_invoice_item. | write |
delete_invoice_item | Удаляет позицию из счёта Draft. Итоговые суммы пересчитываются автоматически. Идентификаторы позиций можно получить с помощью get_invoice или add_invoice_item. Чтобы удалить позицию, вызовите инструмент с confirm:true; без этого параметра он вернёт предварительный просмотр позиции. | write, destructive |
reorder_invoice_items | Задаёт порядок отображения позиций в счёте. Передайте полный требуемый порядок: идентификатор каждой позиции и её 0-based значение display_order. Идентификаторы позиций можно получить с помощью get_invoice или add_invoice_item. | write |
update_invoice_matter | Привязывает к счёту досье (matter) или отвязывает его. Это только организационное действие: его можно выполнить даже после присвоения счёту статуса Sent, но нельзя — для счёта Cancelled. Чтобы отвязать досье, передайте matter_id со значением null. | write |
check_certification_status | Служебный инструмент: обновляет статус налоговой сертификации оформленного документа, запрашивая данные у провайдера сертификации, и синхронизирует их с базой данных. После вызова issue_invoice сертификация автоматически завершается в фоновом режиме. НЕ вызывайте этот инструмент заранее и не упоминайте сертификацию пользователю. Используйте его, только если пользователь прямо спрашивает о сертификации или если issue_invoice вернул ошибку сертификации. | write |
create_credit_note | Отменяет счёт со статусом Sent или Paid путём выпуска кредит-ноты (avoir). Кредит-нота — юридический налоговый документ; если исходный счёт был сертифицирован, кредит-нота также проходит налоговую сертификацию. После создания документ становится НЕИЗМЕНЯЕМЫМ. ДЕЙСТВИЕ НЕОБРАТИМО. ПЕРЕД вызовом с параметром confirm:true обязательно получите явное подтверждение пользователя. Без confirm инструмент вернёт предварительный просмотр. | write, destructive |
Исправление и импорт (3)
| Инструмент | Назначение | Доступ |
|---|---|---|
rectify_invoice | Создаёт корректировочный счёт (facture rectificative) на основе отправленного или оплаченного счёта: новый счёт в статусе Draft, предварительно заполненный данными исходного (тот же клиент, те же позиции, если не указано иное) и связанный с ним в соответствии с требованиями законодательства. Исходный счёт получает статус Rectified только после выставления корректировочного. Передайте confirm:true, чтобы создать счёт; без этого параметра инструмент вернёт предварительный просмотр. | write |
get_rectification_links | Возвращает цепочку корректировок для одного счёта: исходный счёт, который он заменяет (если это корректировочный счёт), и/или корректировочный счёт, которым он был заменён (если исходный счёт был скорректирован). Если счёт не входит в такую цепочку, оба значения равны null. | read |
import_external_invoice | Импортирует исторический или внешний счёт с его собственным номером (сохраняется без изменений), суммами и статусом — без позиций. Используйте для переноса ранее выставленных счетов, оформленных вне Kema Invoice. Не используйте для создания новых счетов — для этого предназначен create_invoice. | write |
Коммерческие предложения (5)
| Инструмент | Назначение | Доступ |
|---|---|---|
create_quote | Создаёт коммерческое предложение (devis) для компании в статусе Draft. Коммерческие предложения не являются фискальными документами и не проходят сертификацию. По умолчанию сервер устанавливает дату выставления на сегодня, а срок оплаты или действия — на 30 дней позже. Необходимо указать идентификатор дела (dossier), к которому относится предложение. | write |
send_quote | Переводит коммерческое предложение из статуса Draft в Sent — этот статус виден клиенту. Сертификация не требуется: коммерческие предложения относятся к коммерческим документам. Для французских клиентов применяются правила проверки SIREN/VAT. | write, destructive |
accept_quote | Отмечает отправленное коммерческое предложение как принятое клиентом. Чтобы выставить счёт, после этого используйте convert_quote_to_invoice. | write, destructive |
reject_quote | Отмечает отправленное коммерческое предложение как отклонённое клиентом. После этого его жизненный цикл завершается. Передайте confirm:true, чтобы применить изменение; без этого параметра инструмент вернёт предварительный просмотр. | write, destructive |
convert_quote_to_invoice | Создаёт новый счёт в статусе Draft на основе принятого коммерческого предложения. Позиции копируются, а значение source_quote_id сохраняется для отслеживания источника. Далее счёт проходит стандартный жизненный цикл: для придания ему юридической силы используйте issue_invoice. Передайте confirm:true, чтобы выполнить преобразование; без этого параметра инструмент вернёт предварительный просмотр. | write |
Авансы (6)
| Инструмент | Назначение | Доступ |
|---|---|---|
create_provision | Создаёт документ на аванс (avance sur honoraires, retainer) для компании в статусе Draft; при необходимости его можно привязать к делу. Документ не выставлен и не сертифицирован: для его юридического оформления используйте send_provision. НДС рассчитывается автоматически по строгим серверным фискальным правилам — никогда не запрашивайте у пользователя ставку НДС. Для авансов используется отдельная серия номеров PROV. После оплаты аванс становится кредитом клиента, который можно вычесть из итогового счёта с помощью apply_provisions_to_invoice. | write |
send_provision | Выставляет аванс в статусе Draft — оформляет его юридически. Аванс становится окончательным юридическим документом со статусом Sent и номером из серии PROV. Действие НЕОБРАТИМО и имеет юридическую силу согласно законодательству Франции. Перед вызовом с confirm:true ОБЯЗАТЕЛЬНО покажите пользователю сведения об авансе и получите его явное подтверждение; без этого параметра инструмент вернёт предварительный просмотр. Фискальная сертификация выполняется в рамках этого вызова и является внутренним процессом: после успешного выполнения сообщите пользователю только о создании аванса. НИКОГДА не упоминайте сертификацию, фискальный статус, неизменность документа или обработку, если инструмент не вернул ошибку. | write, destructive |
mark_provision_paid | Отмечает выставленный аванс со статусом Sent или Overdue как оплаченный. Оплаченный аванс становится кредитом клиента, который можно вычесть из его итогового счёта с помощью apply_provisions_to_invoice. | write |
list_available_provisions | Составляет список ОПЛАЧЕННЫХ авансов (avances sur honoraires, retainers), ещё не учтённых в итоговом счёте: это кредит клиента, доступный для вычета. Если matter_id не указан, выводятся авансы, не привязанные к делу. В Kema Invoice это стандартный вариант. Если matter_id указан, выводятся авансы, привязанные к соответствующему делу. Используйте перед вызовом apply_provisions_to_invoice. | read |
apply_provisions_to_invoice | Вычитает один или несколько ОПЛАЧЕННЫХ авансов из ЧЕРНОВИКА итогового счёта того же клиента и, если аванс привязан к делу, того же дела. Обновляет значения advances_total и amount_due в счёте. Пока счёт остаётся в статусе Draft, действие можно отменить с помощью remove_provision_from_invoice. | write |
remove_provision_from_invoice | Отвязывает аванс от ЧЕРНОВИКА итогового счёта и пересчитывает значения advances_total и amount_due. После этого аванс снова становится доступен для соответствующего дела. | write |
Клиенты (5)
| Инструмент | Назначение | Доступ |
|---|---|---|
list_companies | Выводит список компаний-клиентов текущего аккаунта: название, адрес электронной почты, VAT/tax ID и страну. Помогает найти идентификатор компании перед другими запросами. | read |
get_company | Возвращает полную запись компании-клиента со всеми данными, необходимыми для выставления счетов: юридические сведения, VAT/SIREN, адрес, контактные данные и классификацию профиля клиента. | read |
create_company | Создаёт компанию-клиента для текущего аккаунта. Чтобы в дальнейшем выставлять ей счета как компании B2B, необходимо указать VAT/tax ID. | write |
update_company | Обновляет данные существующей компании-клиента: название, контактные сведения, адрес, номер VAT или SIREN. Меняются только переданные поля. Перед сертификацией счёта для этого клиента часто необходимо исправить VAT, SIREN или адрес с помощью этого инструмента. | write |
delete_company | Помечает компанию-клиента как удалённую. Удаление невозможно, если с ней связаны контакты. Передайте confirm:true, чтобы удалить компанию; без этого параметра инструмент вернёт предварительный просмотр. | write, destructive |
Профили клиентов (3)
| Инструмент | Назначение | Доступ |
|---|---|---|
get_invoice_client_profile | Возвращает настройки выставления счетов для конкретной компании: условия оплаты, способ доставки и пользовательский префикс номера счёта. Если профиль не создан, результат содержит {profile: null}. Профили создаются только при необходимости. | read |
upsert_invoice_client_profile | Создаёт или обновляет настройки выставления счетов компании: условия оплаты, способ доставки и префикс номера счёта. Эти настройки автоматически заполняют соответствующие поля в будущих счетах для этого клиента. | write |
delete_invoice_client_profile | Удаляет настройки выставления счетов компании, не затрагивая саму компанию. Передайте confirm:true, чтобы удалить профиль; без этого параметра инструмент вернёт предварительный просмотр. | write, destructive |
Отчётность (3)
| Инструмент | Назначение | Доступ |
|---|---|---|
get_revenue_summary | Сводит данные о выручке: поступления за период (по дате оплаты), текущую сумму задолженности и просроченных платежей на момент запроса, документы, выставленные за период, количество черновиков и чистое влияние кредит-нот. По умолчанию используется текущий месяц. | read |
get_settings | Возвращает настройки выставления счетов текущего аккаунта только для чтения: юридические сведения, страну и фискальный режим, ставку НДС и условия оплаты по умолчанию, адрес электронной почты для выставления счетов и язык интерфейса вызывающего пользователя. Изменить настройки можно только в приложении. | read |
list_mcp_activity | Показывает журнал недавних действий агента в текущем аккаунте: по одной записи на каждый успешно выполненный вызов инструмента MCP, включая название инструмента, связанный номер счёта (если известен) и временную метку. Записи отсортированы от новых к старым. | read |
Сервер придерживается следующих правил проектирования: для каждого инструмента задано одно название; для операций чтения используется readOnlyHint, а для операций записи явно указывается destructiveHint; каждый параметр снабжён описанием; каждый результат содержит outputSchema и structuredContent. Названия инструментов зафиксированы, поэтому ваши запросы и автоматизации продолжат работать в следующих версиях.
Если вызов отклонён — например, из-за отсутствия активной подписки или исчерпанной квоты, — отказ возвращается как результат инструмента, сформулированный для модели, а не как ошибка транспортного уровня. Соединение с коннектором остаётся активным, и список инструментов доступен.
Попробуйте
Обратитесь к агенту на удобном вам языке:
-
«Выставь счёт Dupont SARL за 3 дня консультаций по €800 в день».
-
«Покажи неоплаченные счета и отметь FAC-2026-0412 как оплаченный».
-
«Преобразуй коммерческое предложение DEV-2026-0031 в счёт и отправь его».
Другие примеры: examples/prompts.md.
Соответствие требованиям и данные
-
Счета формируются в формате Factur-X (PDF/A-3 со встроенным XML по стандарту EN 16931) и передаются через аккредитованную платформу. Они готовы к использованию в рамках обязательного перехода Франции на электронные счета.
-
Данные размещаются в Европейском союзе: база данных и аутентификация находятся в AWS eu-north-1, Стокгольм; периферийная сеть и хранилище — в ЕС. Список субподрядчиков и сроки хранения данных приведены в политике конфиденциальности.
-
Каждый вызов MCP записывается в приложении в разделе «Активность агента», поэтому вы всегда можете посмотреть, что сделал ваш агент.
Проверка соединения
git clone https://github.com/Kema-Studio/kema-invoice-mcp && cd kema-invoice-mcp
npm install
npm run verify # opens the consent page, then lists the tools
Поддержка
-
Вопросы об аккаунте или счетах: обратитесь в поддержку из приложения (кнопка «Помощь») или напишите на hello@kema-studio.com.
-
Сообщения об ошибках самого коннектора (например, ошибка инструмента или проблема со схемой): создайте обращение.
Лицензия
Содержимое этого репозитория (документация, примеры и скрипты) распространяется на условиях лицензии MIT. Сервис Kema Invoice и его сервер — проприетарное программное обеспечение Kema Studio.
Французская версия
Kema Invoice — это соответствующее требованиям программное обеспечение для электронного выставления счетов, которым управляют ИИ-агенты через Model Context Protocol. Подключите удалённый MCP-сервер к Claude, Cursor или любому MCP-клиенту, один раз пройдите авторизацию через OAuth 2.1 — и агент сможет на естественном языке создавать, выставлять, отправлять и отслеживать счета, коммерческие предложения и авансовые счета. Счета формируются в формате Factur-X (EN 16931) и передаются через аккредитованную платформу. Ничего устанавливать не нужно: сервер доступен по адресу https://mcp.kema-studio.com/api/mcp.
Подключение
| Клиент | Инструкция |
|---|---|
| claude.ai / Claude Desktop | Откройте «Настройки» › «Коннекторы» › «Добавить пользовательский коннектор», вставьте https://mcp.kema-studio.com/api/mcp и пройдите авторизацию. |
| Claude Code | claude mcp add kema-invoice --transport http --url https://mcp.kema-studio.com/api/mcp |
| Cursor | Добавьте examples/cursor-mcp.json в .cursor/mcp.json. |
| Другой MCP-клиент | Используйте транспорт Streamable HTTP, OAuth 2.1 с PKCE и динамическую регистрацию клиента (RFC 7591). |
Ещё нет аккаунта? Создайте его: 14-дневный пробный период, в который включены 10 счетов и один пользователь. Банковская карта не требуется. Затем — единый тариф: 10 € без НДС в месяц за пользователя. В него входят все функции, обязательств по сроку подписки нет.
Возможности агента
Счета (16)
| Инструмент | Описание | Доступ |
|---|---|---|
create_invoice | Создаёт счёт для компании с позициями. В этом продукте создание счёта означает его выставление: после вызова покажите пользователю краткую сводку (клиент, позиции, итоги), а затем, получив его одобрение, вызовите issue_invoice с confirm:true. Оставляйте счёт черновиком, только если пользователь прямо просит сначала проверить или отредактировать его в приложении. НДС рассчитывается автоматически по строгим серверным налоговым правилам (сценарий и значения по умолчанию): никогда не спрашивайте пользователя о ставке НДС. Налоговый сценарий и снимок данных клиента фиксируются при создании. В снимке указано юридическое наименование компании (legal_name) — именно оно отображается в счёте, даже если отличается от отображаемого названия. | запись |
issue_invoice | Выставляет черновик счёта: это юридический акт его создания (в продукте он называется «Создать счёт»). Счёт становится окончательным юридическим документом (статус Sent, отображаемый как «Создан»). По французскому законодательству действие НЕОБРАТИМО; отменить его можно только кредит-нотой. ПРЕЖДЕ чем вызвать инструмент с confirm:true, ВСЕГДА покажите пользователю сводку счёта и получите его явное одобрение. Если confirm не указан, инструмент возвращает предварительный просмотр. Налоговая сертификация выполняется в рамках этого вызова и является внутренним техническим процессом: после успешного ответа сообщите пользователю, что счёт создан, и не вдавайтесь в подробности. НИКОГДА не упоминайте сертификацию, налоговый статус, неизменность документа или обработку, если инструмент не вернул ошибку. | запись, деструктивный |
list_invoices | Возвращает счета авторизованного клиента, начиная с самых новых. Поддерживает фильтрацию по статусу и типу документа, поиск по номеру счёта или имени клиента, а также постраничную выдачу. | чтение |
get_invoice | Возвращает счёт по идентификатору, включая позиции, данные клиента и итоги. Если счёт недоступен вызывающему пользователю, возвращает ошибку с полями, содержащими null. | чтение |
get_invoice_pdf | Возвращает временную подписанную ссылку для скачивания PDF-файла счёта, действующую в течение 1 часа. Работает с любым документом, доступным вызывающему пользователю: для импортированных счетов возвращает загруженный файл, а счета, выставленные в Kema Invoice (через приложение или агента), формируются на сервере с фирменным оформлением рабочего пространства и после сертификации содержат XML Factur-X. Черновики также формируются (с флагом is_draft: true), но пока не являются юридическими документами. | чтение |
update_invoice | Изменяет поля черновика счёта: даты, условия оплаты, примечания или назначенную компанию. Изменять можно только черновики: отправленный или сертифицированный счёт неизменяем. | запись |
delete_invoice | Помечает черновик счёта как удалённый. Для пользователя это действие необратимо. Чтобы выполнить удаление, вызовите инструмент с confirm:true; без этого параметра он покажет предварительный просмотр того, что будет удалено. | запись, деструктивный |
cancel_invoice | Отменяет черновик счёта (статус → Cancelled). Действие необратимо. Выставленные документы (Sent, Overdue, Paid) являются налоговыми документами и не могут быть отменены напрямую: используйте create_credit_note, чтобы выпустить сертифицированную кредит-ноту (avoir) и отменить исходный счёт. Чтобы выполнить действие, вызовите инструмент с confirm:true; в противном случае он покажет предварительный просмотр. | запись, деструктивный |
mark_invoice_paid | Отмечает счёт со статусом Sent или Overdue как оплаченный (Paid). При необходимости можно указать дату оплаты; по умолчанию используется текущая дата. | запись |
add_invoice_item | Добавляет позицию в черновик счёта. Итоги пересчитываются автоматически. | запись |
update_invoice_item | Изменяет позицию в черновике счёта. Итоги пересчитываются автоматически. Идентификаторы позиций можно получить с помощью get_invoice или add_invoice_item. | запись |
delete_invoice_item | Удаляет позицию из черновика счёта. Итоги пересчитываются автоматически. Идентификаторы позиций можно получить с помощью get_invoice или add_invoice_item. Чтобы удалить позицию, вызовите инструмент с confirm:true; без этого параметра он покажет предварительный просмотр позиции. | запись, деструктивный |
reorder_invoice_items | Задаёт порядок отображения позиций в счёте. Передайте полный список в нужном порядке: идентификатор каждой позиции и её 0-based display_order. Идентификаторы позиций можно получить с помощью get_invoice или add_invoice_item. | запись |
update_invoice_matter | Привязывает дело (dossier) к счёту или отвязывает его. Это только организационное изменение: его можно выполнять даже после отправки счёта, но не для отменённого счёта. Чтобы отвязать дело, передайте matter_id null. | запись |
check_certification_status | Инструмент обслуживания: обновляет статус налоговой сертификации выставленного документа, запрашивая данные у поставщика сертификации, и синхронизирует их с базой данных. Сертификация — внутренний технический процесс, который завершается автоматически после вызова issue_invoice: НИКОГДА не вызывайте этот инструмент по собственной инициативе и не упоминайте сертификацию пользователю. Используйте его, только если пользователь прямо спрашивает о сертификации или если issue_invoice вернул ошибку сертификации. | запись |
create_credit_note | Отменяет счёт со статусом Sent или Paid путём выпуска кредит-ноты (avoir). Кредит-нота — юридический налоговый документ; если исходный счёт был сертифицирован, кредит-нота также проходит налоговую сертификацию. После создания документ НЕИЗМЕНЯЕМ. Действие НЕОБРАТИМО. ПРЕЖДЕ чем вызвать инструмент с confirm:true, ВСЕГДА получите явное одобрение пользователя. Без confirm инструмент возвращает предварительный просмотр. | запись, деструктивный |
Исправление и импорт (3)
| Инструмент | Описание | Доступ |
|---|---|---|
rectify_invoice | Создаёт исправленный счёт (facture rectificative) для счёта со статусом Sent или Paid: новый черновик, заполненный данными исходного счёта (тот же клиент, скопированные позиции, если не указано иное) и юридически связанный с ним. Исходный счёт получает статус Rectified только после выставления исправленного счёта. Чтобы создать документ, вызовите инструмент с confirm:true; в противном случае он покажет предварительный просмотр. | запись |
get_rectification_links | Возвращает цепочку исправлений для одного счёта: исходный счёт, который он заменяет (если это исправленный счёт), и/или исправленный счёт, который заменил его (если исходный счёт был исправлен). Если счёт не входит в цепочку, для обоих полей возвращается null. | чтение |
import_external_invoice | Импортирует исторический или внешний счёт с его СОБСТВЕННЫМ номером (сохраняется без изменений), итоговыми суммами и статусом — без позиций. Используйте для переноса прошлых счетов, выставленных вне Kema Invoice. НЕ используйте для создания новых счетов: для этого предназначен create_invoice. | запись |
Коммерческие предложения (5)
| Инструмент | Назначение | Доступ |
|---|---|---|
create_quote | Создать черновик коммерческого предложения (devis) для компании. Коммерческие предложения не являются фискальными документами и не проходят сертификацию. По умолчанию даты задаются на стороне сервера: дата выставления — текущий день, срок оплаты или действия — через 30 дней. Необходимо указать идентификатор дела (dossier), к которому относится предложение. | запись |
send_quote | Перевести коммерческое предложение из статуса Draft в Sent — состояние, в котором его видит клиент. Сертификация не требуется: коммерческое предложение является коммерческим документом. Для арендаторов из Франции применяется проверка B2B-реквизитов (SIREN/VAT). | запись, деструктивное действие |
accept_quote | Отметить предложение в статусе Sent как принятое клиентом (Accepted). Чтобы выставить счёт, затем вызовите convert_quote_to_invoice. | запись, деструктивное действие |
reject_quote | Отметить предложение в статусе Sent как отклонённое клиентом (Rejected). Это завершает жизненный цикл предложения. Чтобы применить изменение, вызовите инструмент с параметром confirm:true; без него инструмент вернёт предварительный просмотр. | запись, деструктивное действие |
convert_quote_to_invoice | Создать новый черновик счёта на основе принятого предложения (Accepted). Позиции копируются, а для отслеживания источника указывается source_quote_id. Далее счёт проходит обычный жизненный цикл: вызовите issue_invoice, чтобы придать ему юридическую силу. Чтобы применить изменение, вызовите инструмент с параметром confirm:true; без него инструмент вернёт предварительный просмотр. | запись |
Авансы (6)
| Инструмент | Назначение | Доступ |
|---|---|---|
create_provision | Создать документ на аванс (avance sur honoraires, retainer) в статусе Draft для компании, при необходимости связав его с делом. Документ не выставлен и не сертифицирован: для юридически значимого выставления используйте send_provision. НДС рассчитывается автоматически по строгим фискальным правилам на стороне сервера — никогда не запрашивайте у пользователя ставку НДС. Для авансов используется отдельная серия номеров PROV. После оплаты аванс становится кредитом клиента, который можно вычесть из итогового счёта с помощью apply_provisions_to_invoice. | запись |
send_provision | Выставить аванс в статусе Draft — совершить юридическое действие по его оформлению. Аванс становится окончательным юридическим документом (статус Sent, серия PROV). Это действие НЕОБРАТИМО и имеет юридическую силу в соответствии с законодательством Франции. ВСЕГДА покажите пользователю сведения об авансе и получите его явное подтверждение, прежде чем вызывать инструмент с параметром confirm:true; без подтверждения инструмент вернёт предварительный просмотр. Фискальная сертификация выполняется в рамках этого вызова и является внутренним процессом: после успешного выполнения сообщите пользователю только о создании аванса. НИКОГДА не упоминайте пользователю сертификацию, фискальный статус, неизменяемость документа или обработку, если только инструмент не вернул ошибку. | запись, деструктивное действие |
mark_provision_paid | Отметить выставленный аванс (в статусе Sent или Overdue) как оплаченный (Paid). Оплаченный аванс становится кредитом клиента, который можно вычесть из итогового счёта этого клиента с помощью apply_provisions_to_invoice. | запись |
list_available_provisions | Показать ОПЛАЧЕННЫЕ авансы (avances sur honoraires, retainers), которые ещё не были учтены в итоговом счёте и доступны для вычета как кредит клиента. Если параметр matter_id не указан, отображаются отдельные авансы (не связанные с делом) — это обычный сценарий в Kema Invoice. Если matter_id указан, отображаются авансы, связанные с этим делом. Используйте перед вызовом apply_provisions_to_invoice. | чтение |
apply_provisions_to_invoice | Вычесть один или несколько ОПЛАЧЕННЫХ авансов из ЧЕРНОВИКА итогового счёта для того же клиента и, если указано дело, для того же дела. Инструмент обновляет значения advances_total и amount_due в счёте. Изменение можно отменить, пока счёт остаётся в статусе Draft, с помощью remove_provision_from_invoice. | запись |
remove_provision_from_invoice | Отвязать аванс от ЧЕРНОВИКА итогового счёта и пересчитать значения advances_total и amount_due. После этого аванс снова станет доступен для этого дела. | запись |
Клиенты (5)
| Инструмент | Назначение | Доступ |
|---|---|---|
list_companies | Показать компании-клиенты текущего аутентифицированного арендатора: название, адрес электронной почты, VAT/tax id и страну. Инструмент помогает найти идентификатор компании перед выполнением других запросов. | чтение |
get_company | Получить полную информацию о компании-клиенте, необходимую для выставления счетов: юридические данные, VAT/SIREN, адрес, контактные данные и классификацию профиля клиента. | чтение |
create_company | Создать компанию-клиента для арендатора. Чтобы позднее выставить ей счёт как B2B-клиенту, потребуется VAT/tax id. | запись |
update_company | Изменить данные существующей компании-клиента: название, контактную информацию, адрес, номер VAT или SIREN. Изменяются только указанные поля. Перед сертификацией счёта для этого клиента часто необходимо исправить номер VAT/SIREN или адрес. | запись |
delete_company | Выполнить мягкое удаление компании-клиента. Удаление невозможно, пока с ней связаны контакты. Чтобы удалить компанию, вызовите инструмент с параметром confirm:true; без него инструмент вернёт предварительный просмотр. | запись, деструктивное действие |
Профили клиентов (3)
| Инструмент | Назначение | Доступ |
|---|---|---|
get_invoice_client_profile | Получить индивидуальные настройки выставления счетов для компании: условия оплаты, канал доставки и пользовательский префикс счёта. Если у компании нет профиля, инструмент вернёт {profile: null}; профили создаются по мере необходимости. | чтение |
upsert_invoice_client_profile | Создать или обновить индивидуальные настройки выставления счетов для компании: условия оплаты, канал доставки и префикс счёта. Эти настройки автоматически подставляются в новые счета для данного клиента. | запись |
delete_invoice_client_profile | Удалить индивидуальные настройки выставления счетов компании, не затрагивая саму компанию. Чтобы удалить профиль, вызовите инструмент с параметром confirm:true; без него инструмент вернёт предварительный просмотр. | запись, деструктивное действие |
Управление (3)
| Инструмент | Назначение | Доступ |
|---|---|---|
get_revenue_summary | Сводные данные о выручке: поступления за период (по дате оплаты), текущая задолженность и просроченные платежи на момент запроса, документы, выставленные за период, количество черновиков и чистый эффект кредит-нот. По умолчанию используется текущий месяц. | чтение |
get_settings | Просмотр настроек выставления счетов арендатора: юридические данные, страна и налоговый режим, ставка НДС и условия оплаты по умолчанию, адрес электронной почты для выставления счетов и язык интерфейса вызывающего пользователя. Изменить настройки можно ТОЛЬКО в приложении. | чтение |
list_mcp_activity | Просмотреть недавнюю активность агентов арендатора: для каждого успешно выполненного вызова инструмента MCP указаны его название, номер связанного счёта, если он известен, и временная метка. Записи отсортированы от новых к старым. | чтение |
Соответствие требованиям и данные
Счета Factur-X (PDF/A-3 с XML EN 16931) передаются через аккредитованную платформу; данные хранятся в Европейском союзе (база данных и аутентификация размещены в AWS eu-north-1, Стокгольм); каждый вызов MCP регистрируется в приложении в разделе «Активность агента». Политика конфиденциальности · Условия использования · Юридическая информация.
Поддержка
По вопросам учётной записи и счетов обратитесь через приложение (кнопка «Помощь») или напишите на hello@kema-studio.com. Чтобы сообщить об ошибке коннектора, создайте issue.