ffacturifirma
Увійти

MCP · Model Context Protocol

Підключіть ШІ-асистента до вашої компанії

facturifirma надає MCP-сервер через streamable HTTP. Будь-який сумісний клієнт (Claude, Claude Code, інші агенти) може виставляти рахунки, надсилати до SPV, керувати клієнтами та формувати звіти прямо в розмові.

Почати безкоштовноДоступні інструменти

Що таке конектор MCP

MCP (Model Context Protocol) — це відкритий стандарт, за яким ШІ-асистенти викликають інструменти, що їх надає застосунок. Конектор facturifirma дає повний доступ на читання/запис до ваших компаній, документів, клієнтів і звітів, застосовуючи ті самі бізнес-правила, що й застосунок і REST API.

Кінцева точка

MCP-сервер через streamable HTTP, доступний за адресою нижче.

https://app.facturifirma.ro/mcp

Автентифікація

Варіант 1 — OAuth (рекомендовано для claude.ai / ChatGPT)

Для клієнтів, які не можуть надсилати власний заголовок Authorization (веб-конектори claude.ai, ChatGPT), авторизація відбувається в браузері через OAuth 2.1.

  1. 1. У claude.ai: відкрийте Налаштування → Конектори та натисніть «Додати власний конектор».
  2. 2. Дайте назву (напр. «facturifirma»), вставте адресу https://app.facturifirma.ro/mcp і натисніть «Додати».
  3. 3. Натисніть «Підключити» на новому конекторі — вас перенаправить до facturifirma для входу (якщо ви ще не увійшли).
  4. 4. Натисніть «Дозволити» на екрані згоди. Ви повернетесь до claude.ai із конектором у стані «Підключено» — без налаштування client ID чи секрету.
https://app.facturifirma.ro/mcp

Варіант 2 — API-ключ (Bearer)

Для клієнтів, які можуть надсилати власні заголовки (Claude Code, Claude Desktop, інші агенти), використовуйте API-ключ як заголовок Bearer.

  1. 1. Створіть API-ключ у застосунку: Налаштування → API-ключі.
  2. 2. Надсилайте ключ як заголовок Authorization: Bearer <API_KEY> у кожному запиті.
  3. 3. Налаштуйте свій MCP-клієнт (Claude Code, Claude Desktop тощо) з кінцевою точкою та заголовком нижче.

Claude Code (CLI)

claude mcp add --transport http facturifirma https://app.facturifirma.ro/mcp --header "Authorization: Bearer <API_KEY>"

Загальна конфігурація (JSON)

{
  "mcpServers": {
    "facturifirma": {
      "url": "https://app.facturifirma.ro/mcp",
      "headers": {
        "Authorization": "Bearer <API_KEY>"
      }
    }
  }
}

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

Реальний перелік інструментів, що їх надає сервер, згруповано за напрямами:

Рахунки та документи

Створюйте, редагуйте, виставляйте рахунки, проформи та кредит-ноти й приймайте оплату.

list_documentscreate_invoiceupdate_invoiceissue_documentdelete_documentrecord_paymentreverse_invoiceconvert_proformalist_purchases

ANAF e-Factura

Надсилайте документи до SPV, відстежуйте їх статус та імпортуйте отримані рахунки.

send_to_anafpoll_efacturasync_inboxlist_inboximport_inbox

ANAF e-Transport

Декларуйте перевезення (UIT), відстежуйте статус і скасовуйте декларації, з багаторазовими транспортними засобами.

declare_transportlist_transport_declarationsget_transport_declarationsync_etransportcancel_transport_declarationlist_vehiclescreate_vehicle

Компанії

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

list_companiescreate_companyget_companyupdate_company

Клієнти

Створюйте та керуйте клієнтами компанії (контрагентами).

list_clientscreate_clientget_clientupdate_clientdelete_client

Постачальники

Створюйте та керуйте постачальниками компанії (у кого ви купуєте).

list_suppliersget_suppliercreate_supplierupdate_supplierdelete_supplier

Витрати

Обліковуйте витрати постачальників і керуйте ними.

list_expensescreate_expenseupdate_expensedelete_expense

Регулярні рахунки

Створюйте шаблони, що автоматично генерують чернетки рахунків за графіком.

list_recurringcreate_recurringupdate_recurringdelete_recurring

Банківські рахунки

Переглядайте та замінюйте банківські рахунки компанії, клієнта чи постачальника.

list_bank_accountsreplace_bank_accounts

Публічні дані ANAF

Знайдіть румунську компанію за CUI (назва, адреса, статус ПДВ / e-Factura).

lookup_company

Каталог та операції

Товари, склади та серії нумерації.

list_productscreate_productget_productupdate_productdelete_productlist_warehousescreate_warehouseupdate_warehousedelete_warehouselist_seriescreate_seriesupdate_seriesdelete_series

Звіти

Журнал продажів, звіт з ПДВ і банківська звірка.

sales_journalvat_reportreconcile_bank

Налаштування

Читайте та оновлюйте конфігурацію орендаря.

get_settings_schemaget_settingsupdate_settings

Безпека

API-ключ прив'язаний до вашого облікового запису (орендаря) і може бути відкликаний будь-коли в Налаштування → API-ключі. Кожен виклик MCP виконується з тими самими правами, що й користувач, який створив ключ — не більше.

Готові підключити ШІ-асистента?

Створіть API-ключ у застосунку та додайте його до улюбленого MCP-клієнта.

Відкрити застосунок

← Назад на головну