Доступ для ШІ (MCP)

МояФактура на Mac може надати ваші дані асистенту ШІ — наприклад, Claude, ChatGPT (Codex) або Cursor. Тоді ви можете запитувати про свій бізнес звичайною мовою, а асистент сам знайде потрібні документи й порахує результат:

«Хто був моїм найбільшим клієнтом минулого року?»
«Як змінювалася ціна пального за літр за останні 5 років?»
«Покажи продажі та витрати по місяцях і зміну у відсотках.»
«Які фактури прострочені?»
«Яких товарів менше, ніж мінімальний залишок?»

З’єднання використовує відкритий стандарт MCP (Model Context Protocol). Асистент може читати фактури та інші документи продажу, витрати, контрагентів, платежі, товари та дані складу.

Вимоги

МояФактура версії 3.3.1 або новішої на комп’ютері Mac
план Pro
програма МояФактура має бути запущена — асистент підключається лише тоді, коли вона відкрита
асистент ШІ, встановлений на тому самому Mac

Крок 1 — Увімкніть доступ

Відкрийте Налаштування програми (меню МояФактура → Налаштування…) і перейдіть на вкладку Доступ ШІ. Увімкніть перемикач Дозволити клієнтам ШІ читати дані. Поле Статус покаже зелену крапку й адресу сервера, наприклад http://127.0.0.1:64045/mcp.

Крок 2 — Оберіть облікові записи

У розділі Надані облікові записи позначте облікові записи (компанії), які асистент може читати. Типово жоден обліковий запис не надано. Ви можете будь-коли вимкнути доступ — це діє одразу.

Крок 3 — Підключіть асистента

Claude Desktop

Натисніть Установити в Claude Desktop… і збережіть файл MyInvoice.mcpb (наприклад, у теці «Завантаження»). Він відкриється в Claude Desktop; підтвердіть кнопкою Install. Порт і токен уже заповнені, жодне інше програмне забезпечення не потрібне.

Після зміни порту або створення нового токена встановіть розширення ще раз.

Claude Code

У розділі Підключити клієнта натисніть Копіювати біля Claude Code і вставте команду в Термінал.

ChatGPT / Codex

Скопіюйте конфігурацію з пункту ChatGPT / Codex і додайте її в застосунку ChatGPT для Mac (Settings → MCP servers) або у файл ~/.codex/config.toml. Цю конфігурацію використовують Codex у застосунку ChatGPT, Codex CLI та розширення для редакторів.

Звичайні розмови в ChatGPT (зокрема в браузері) підключаються лише до серверів, доступних публічно в інтернеті, тому не можуть користуватися даними, збереженими на вашому Mac.

Cursor

Скопіюйте конфігурацію з пункту Cursor і додайте її у файл ~/.cursor/mcp.json.

Інші програми

Будь-яка програма, що підтримує MCP через HTTP, може підключитися: вкажіть адресу сервера з поля Статус і заголовок Authorization: Bearer <token> із токеном із розділу Безпека.

Безпека та конфіденційність

Лише читання. Асистент не може нічого змінити чи видалити в програмі.
Лише цей Mac. Сервер приймає підключення тільки з того самого комп’ютера і тільки коли МояФактура запущена.
Токен доступу. Кожне підключення потребує токена. Якщо ви підозрюєте, що його хтось дізнався, скористайтеся Згенерувати токен повторно… — наявні підключення перестануть працювати, доки ви не оновите їхню конфігурацію.
Лише обрані облікові записи. Асистент бачить тільки облікові записи, позначені в розділі «Надані облікові записи».
Без чутливих даних. Номери банківських рахунків, а також файли й технічні дані KSeF не надаються.
Пам’ятайте: дані, які прочитає асистент, надсилаються постачальнику відповідної моделі ШІ (наприклад, Anthropic або OpenAI) і підпадають під його умови. Надавайте лише ті облікові записи, дані яких ви готові туди передати. Розробник програми МояФактура не бере участі в цьому з’єднанні й не має доступу до цих даних.

Усунення проблем

Асистент повідомляє, що МояФактура недоступна: Запустіть програму МояФактура на цьому Mac і перевірте, чи ввімкнено перемикач на вкладці «Доступ ШІ», а Статус показує зелену крапку.
Асистент повідомляє, що токен відхилено: Токен змінено. У Claude Desktop встановіть розширення ще раз, в інших програмах скопіюйте конфігурацію знову.
Асистент не бачить жодного облікового запису: Позначте принаймні один обліковий запис у розділі «Надані облікові записи».
Статус показує помилку порту: Порт зайнятий іншою програмою. Натисніть Вибрати інший порт, а потім оновіть конфігурацію асистента.
Вкладка показує лише інформацію про план Pro: Доступ для ШІ входить до плану Pro. Після переходу на план Pro всі параметри з’являться автоматично.
Асистент показує застарілі дані: Дані оновлюються за кілька секунд після кожної зміни в програмі. Запитайте ще раз.