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/mcpUwierzytelnianie
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. W claude.ai: otwórz Ustawienia → Konektory i kliknij „Dodaj własny konektor”.
- 2. Nadaj nazwę (np. „facturifirma”), wklej adres https://app.facturifirma.ro/mcp i kliknij „Dodaj”.
- 3. Kliknij „Połącz” przy nowym konektorze — zostaniesz przekierowany do facturifirma, aby się zalogować (jeśli jeszcze tego nie zrobiłeś).
- 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/mcpOpcja 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. Utwórz klucz API w aplikacji: Ustawienia → Klucze API.
- 2. Wysyłaj klucz jako nagłówek Authorization: Bearer <API_KEY> w każdym żądaniu.
- 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_purchasesANAF e-Factura
Wysyłaj dokumenty do SPV, śledź ich status i importuj otrzymane faktury.
send_to_anafpoll_efacturasync_inboxlist_inboximport_inboxANAF 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_vehicleFirmy
Przeglądaj i zarządzaj firmami na swoim koncie.
list_companiescreate_companyget_companyupdate_companyKlienci
Twórz i zarządzaj klientami firmy (kontrahentami).
list_clientscreate_clientget_clientupdate_clientdelete_clientDostawcy
Twórz i zarządzaj dostawcami firmy (u których kupujesz).
list_suppliersget_suppliercreate_supplierupdate_supplierdelete_supplierWydatki
Rejestruj wydatki dostawców i zarządzaj nimi.
list_expensescreate_expenseupdate_expensedelete_expenseFaktury cykliczne
Twórz szablony, które automatycznie generują szkice faktur w rytmie.
list_recurringcreate_recurringupdate_recurringdelete_recurringRachunki bankowe
Przeglądaj i zastępuj rachunki bankowe firmy, klienta lub dostawcy.
list_bank_accountsreplace_bank_accountsPubliczne dane ANAF
Wyszukaj rumuńską firmę po CUI (nazwa, adres, status VAT / e-Factura).
lookup_companyKatalog i operacje
Produkty, magazyny i serie numeracji.
list_productscreate_productget_productupdate_productdelete_productlist_warehousescreate_warehouseupdate_warehousedelete_warehouselist_seriescreate_seriesupdate_seriesdelete_seriesRaporty
Rejestr sprzedaży, raport VAT i uzgodnienie bankowe.
sales_journalvat_reportreconcile_bankUstawienia
Odczytuj i aktualizuj konfigurację najemcy.
get_settings_schemaget_settingsupdate_settingsBezpieczeń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ę