ffacturifirma

MCP · Model Context Protocol

Podłącz asystenta AI do swojej firmy

facturifirma udostępnia serwer MCP przez streamable HTTP. Dowolny zgodny klient (Claude, Claude Code, inne agenty) może wystawiać faktury, wysyłać do SPV, zarządzać klientami i generować raporty bezpośrednio z rozmowy.

Czym jest konektor MCP

MCP (Model Context Protocol) to otwarty standard, dzięki któremu asystenci AI wywołują narzędzia udostępniane przez aplikację. Konektor facturifirma daje pełny dostęp do odczytu/zapisu do Twoich firm, dokumentów, klientów i raportów, egzekwując te same reguły biznesowe co aplikacja i REST API.

Punkt końcowy

Serwer MCP przez streamable HTTP, dostępny pod adresem poniżej.

https://app.facturifirma.ro/mcp

Uwierzytelnianie

Opcja 1 — OAuth (zalecane dla claude.ai / ChatGPT)

Dla klientów, którzy nie mogą wysłać własnego nagłówka Authorization (konektory webowe claude.ai, ChatGPT), autoryzacja odbywa się w przeglądarce przez OAuth 2.1.

  1. 1. W claude.ai: otwórz Ustawienia → Konektory i kliknij „Dodaj własny konektor”.
  2. 2. Nadaj nazwę (np. „facturifirma”), wklej adres https://app.facturifirma.ro/mcp i kliknij „Dodaj”.
  3. 3. Kliknij „Połącz” przy nowym konektorze — zostaniesz przekierowany do facturifirma, aby się zalogować (jeśli jeszcze tego nie zrobiłeś).
  4. 4. Kliknij „Zezwól” na ekranie zgody. Wrócisz do claude.ai z konektorem w stanie „Połączono” — bez konfigurowania client ID ani sekretu.
https://app.facturifirma.ro/mcp

Opcja 2 — klucz API (Bearer)

Dla klientów, którzy mogą wysyłać własne nagłówki (Claude Code, Claude Desktop, inne agenty), użyj klucza API jako nagłówka Bearer.

  1. 1. Utwórz klucz API w aplikacji: Ustawienia → Klucze API.
  2. 2. Wysyłaj klucz jako nagłówek Authorization: Bearer <API_KEY> w każdym żądaniu.
  3. 3. Skonfiguruj swojego klienta MCP (Claude Code, Claude Desktop itd.) z punktem końcowym i nagłówkiem poniżej.

Claude Code (CLI)

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

Konfiguracja ogólna (JSON)

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

Dostępne narzędzia

Rzeczywista lista narzędzi udostępnianych przez serwer, pogrupowana według obszarów:

Faktury i dokumenty

Twórz, edytuj, wystawiaj faktury, proformy i noty kredytowe oraz przyjmuj płatności.

list_documentscreate_invoiceupdate_invoiceissue_documentdelete_documentrecord_paymentreverse_invoiceconvert_proformalist_purchases

ANAF e-Factura

Wysyłaj dokumenty do SPV, śledź ich status i importuj otrzymane faktury.

send_to_anafpoll_efacturasync_inboxlist_inboximport_inbox

ANAF e-Transport

Deklaruj transporty (UIT), śledź status i anuluj deklaracje, z pojazdami wielokrotnego użytku.

declare_transportlist_transport_declarationsget_transport_declarationsync_etransportcancel_transport_declarationlist_vehiclescreate_vehicle

Firmy

Przeglądaj i zarządzaj firmami na swoim koncie.

list_companiescreate_companyget_companyupdate_company

Klienci

Twórz i zarządzaj klientami firmy (kontrahentami).

list_clientscreate_clientget_clientupdate_clientdelete_client

Dostawcy

Twórz i zarządzaj dostawcami firmy (u których kupujesz).

list_suppliersget_suppliercreate_supplierupdate_supplierdelete_supplier

Wydatki

Rejestruj wydatki dostawców i zarządzaj nimi.

list_expensescreate_expenseupdate_expensedelete_expense

Faktury cykliczne

Twórz szablony, które automatycznie generują szkice faktur w rytmie.

list_recurringcreate_recurringupdate_recurringdelete_recurring

Rachunki bankowe

Przeglądaj i zastępuj rachunki bankowe firmy, klienta lub dostawcy.

list_bank_accountsreplace_bank_accounts

Publiczne dane ANAF

Wyszukaj rumuńską firmę po CUI (nazwa, adres, status VAT / e-Factura).

lookup_company

Katalog i operacje

Produkty, magazyny i serie numeracji.

list_productscreate_productget_productupdate_productdelete_productlist_warehousescreate_warehouseupdate_warehousedelete_warehouselist_seriescreate_seriesupdate_seriesdelete_series

Raporty

Rejestr sprzedaży, raport VAT i uzgodnienie bankowe.

sales_journalvat_reportreconcile_bank

Ustawienia

Odczytuj i aktualizuj konfigurację najemcy.

get_settings_schemaget_settingsupdate_settings

Bezpieczeństwo

Klucz API jest przypisany do Twojego konta (najemcy) i może zostać odwołany w dowolnej chwili w Ustawienia → Klucze API. Każde wywołanie MCP działa z tymi samymi uprawnieniami co użytkownik, który wygenerował klucz — nic więcej.

Gotowy, by podłączyć asystenta AI?

Utwórz klucz API w aplikacji i dodaj go do ulubionego klienta MCP.

Otwórz aplikację

← Powrót na stronę główną