ffacturifirma
Autentificare

MCP · Model Context Protocol

Conectează un asistent AI la firma ta

facturifirma expune un server MCP peste streamable HTTP. Orice client compatibil (Claude, Claude Code, alți agenți) poate emite facturi, trimite în SPV, gestiona clienți și genera rapoarte direct din conversație.

Începe gratuitUnelte disponibile

Ce este conectorul MCP

MCP (Model Context Protocol) e un standard deschis prin care un asistent AI apelează unelte (tools) expuse de o aplicație. Conectorul facturifirma pune la dispoziție acces complet de citire/scriere la firmele, documentele, clienții și rapoartele tale, cu aceleași reguli de business ca în aplicație și API.

Endpoint

Server MCP streamable HTTP, disponibil la adresa de mai jos.

https://app.facturifirma.ro/mcp

Autentificare

Varianta 1 — OAuth (recomandat pentru claude.ai / ChatGPT)

Pentru clienți care nu pot trimite un antet Authorization personalizat (conectorii web claude.ai, ChatGPT), autorizarea se face în browser, prin OAuth 2.1.

  1. 1. În claude.ai: deschide Setări → Connectors și apasă „Add custom connector”.
  2. 2. Dă-i un nume (ex. „facturifirma”), lipește adresa https://app.facturifirma.ro/mcp și apasă „Add”.
  3. 3. Apasă „Connect” la conectorul nou — ești dus la facturifirma pentru autentificare (dacă nu ești deja logat).
  4. 4. Apasă „Permite” pe ecranul de consimțământ. Revii în claude.ai cu conectorul „Connected” — fără client ID sau secret de configurat.
https://app.facturifirma.ro/mcp

Varianta 2 — Cheie API (Bearer)

Pentru clienți care pot trimite antete personalizate (Claude Code, Claude Desktop, alți agenți), folosește o cheie API ca antet Bearer.

  1. 1. Creează o cheie API din aplicație: Setări → Chei API.
  2. 2. Trimite cheia ca antet Authorization: Bearer <CHEIE_API> la fiecare cerere.
  3. 3. Configurează clientul MCP (Claude Code, Claude Desktop etc.) cu endpoint-ul și antetul de mai jos.

Claude Code (CLI)

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

Configurare generică (JSON)

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

Unelte disponibile

Lista reală a uneltelor expuse de server, grupate pe domenii:

Facturare și documente

Creează, editează, emite și încasează facturi, proforme și storno-uri.

list_documentscreate_invoiceupdate_invoiceissue_documentdelete_documentrecord_paymentreverse_invoiceconvert_proformalist_purchases

e-Factura ANAF

Trimite documente în SPV, urmărește starea și importă facturile primite.

send_to_anafpoll_efacturasync_inboxlist_inboximport_inbox

e-Transport ANAF

Declară transporturi (UIT), urmărește starea și anulează declarații, cu vehicule reutilizabile.

declare_transportlist_transport_declarationsget_transport_declarationsync_etransportcancel_transport_declarationlist_vehiclescreate_vehicle

Companii (firme)

Listează și administrează firmele din cont.

list_companiescreate_companyget_companyupdate_company

Clienți

Creează și administrează clienții (contrapărțile) unei firme.

list_clientscreate_clientget_clientupdate_clientdelete_client

Furnizori

Creează și administrează furnizorii (contrapărțile de la care cumperi) unei firme.

list_suppliersget_suppliercreate_supplierupdate_supplierdelete_supplier

Cheltuieli

Înregistrează și administrează cheltuielile de la furnizori.

list_expensescreate_expenseupdate_expensedelete_expense

Facturi recurente

Creează șabloane care emit automat facturi pe o anumită cadență.

list_recurringcreate_recurringupdate_recurringdelete_recurring

Conturi bancare

Listează și înlocuiește conturile bancare ale unei firme, unui client sau unui furnizor.

list_bank_accountsreplace_bank_accounts

Date publice ANAF

Caută o companie românească după CUI (denumire, adresă, statut TVA/e-Factura).

lookup_company

Catalog și operațiuni

Produse, gestiuni (depozite) și serii de numerotare.

list_productscreate_productget_productupdate_productdelete_productlist_warehousescreate_warehouseupdate_warehousedelete_warehouselist_seriescreate_seriesupdate_seriesdelete_series

Rapoarte

Jurnal de vânzări, raport TVA și reconciliere bancară.

sales_journalvat_reportreconcile_bank

Setări

Citește și actualizează configurația tenantului.

get_settings_schemaget_settingsupdate_settings

Securitate

O cheie API este legată de contul tău (tenant) și poate fi revocată oricând din Setări → Chei API. Fiecare apel MCP rulează cu aceleași permisiuni ca utilizatorul care a generat cheia — nimic mai mult.

Gata să conectezi un asistent AI?

Creează o cheie API din aplicație și adaug-o în clientul tău MCP preferat.

Deschide aplicația

← Înapoi la pagina principală