MCP · Model Context Protocol
Verbinde einen KI-Assistenten mit deinem Unternehmen
facturifirma stellt einen MCP-Server über streambares HTTP bereit. Jeder kompatible Client (Claude, Claude Code, andere Agenten) kann Rechnungen ausstellen, ans SPV senden, Kunden verwalten und Berichte direkt aus dem Gespräch erzeugen.
Was der MCP-Connector ist
MCP (Model Context Protocol) ist ein offener Standard, mit dem KI-Assistenten Tools einer Anwendung aufrufen. Der facturifirma-Connector gewährt vollen Lese-/Schreibzugriff auf deine Unternehmen, Belege, Kunden und Berichte, mit denselben Geschäftsregeln wie App und API.
Endpunkt
Streambarer HTTP-MCP-Server, verfügbar unter der Adresse unten.
https://app.facturifirma.ro/mcpAuthentifizierung
Variante 1 — OAuth (empfohlen für claude.ai / ChatGPT)
Für Clients, die keinen benutzerdefinierten Authorization-Header senden können (claude.ai-Web-Connectors, ChatGPT), erfolgt die Autorisierung im Browser über OAuth 2.1.
- 1. Öffne in claude.ai: Einstellungen → Connectors und klicke auf „Add custom connector“.
- 2. Gib ihm einen Namen (z. B. „facturifirma“), füge die Adresse https://app.facturifirma.ro/mcp ein und klicke auf „Add“.
- 3. Klicke beim neuen Connector auf „Connect“ — du wirst zur Anmeldung zu facturifirma weitergeleitet (falls nicht bereits angemeldet).
- 4. Klicke auf „Erlauben“ im Zustimmungsbildschirm. Du kehrst zu claude.ai zurück, der Connector ist „Connected“ — keine Client-ID oder Secret nötig.
https://app.facturifirma.ro/mcpVariante 2 — API-Schlüssel (Bearer)
Für Clients, die eigene Header senden können (Claude Code, Claude Desktop, andere Agenten), verwende einen API-Schlüssel als Bearer-Header.
- 1. Erstelle einen API-Schlüssel in der App: Einstellungen → API-Schlüssel.
- 2. Sende den Schlüssel bei jeder Anfrage als Authorization: Bearer <API_SCHLÜSSEL>.
- 3. Konfiguriere deinen MCP-Client (Claude Code, Claude Desktop usw.) mit Endpunkt und Header unten.
Claude Code (CLI)
claude mcp add --transport http facturifirma https://app.facturifirma.ro/mcp --header "Authorization: Bearer <API_KEY>"Allgemeine Konfiguration (JSON)
{
"mcpServers": {
"facturifirma": {
"url": "https://app.facturifirma.ro/mcp",
"headers": {
"Authorization": "Bearer <API_KEY>"
}
}
}
}Verfügbare Tools
Die tatsächliche Liste der vom Server bereitgestellten Tools, nach Bereich gruppiert:
Rechnungen & Belege
Rechnungen, Proformas und Gutschriften erstellen, bearbeiten, ausstellen und kassieren.
list_documentscreate_invoiceupdate_invoiceissue_documentdelete_documentrecord_paymentreverse_invoiceconvert_proformalist_purchasesANAF e-Factura
Belege ans SPV senden, Status verfolgen und empfangene Rechnungen importieren.
send_to_anafpoll_efacturasync_inboxlist_inboximport_inboxANAF e-Transport
Transporte deklarieren (UIT), Status verfolgen und Erklärungen stornieren, mit wiederverwendbaren Fahrzeugen.
declare_transportlist_transport_declarationsget_transport_declarationsync_etransportcancel_transport_declarationlist_vehiclescreate_vehicleUnternehmen
Die Unternehmen deines Kontos auflisten und verwalten.
list_companiescreate_companyget_companyupdate_companyKunden
Kunden (Vertragspartner) eines Unternehmens erstellen und verwalten.
list_clientscreate_clientget_clientupdate_clientdelete_clientLieferanten
Lieferanten (die Parteien, von denen du einkaufst) eines Unternehmens erstellen und verwalten.
list_suppliersget_suppliercreate_supplierupdate_supplierdelete_supplierAusgaben
Lieferantenausgaben erfassen und verwalten.
list_expensescreate_expenseupdate_expensedelete_expenseWiederkehrende Rechnungen
Vorlagen erstellen, die automatisch Rechnungsentwürfe nach einem Rhythmus generieren.
list_recurringcreate_recurringupdate_recurringdelete_recurringBankkonten
Bankkonten eines Unternehmens, Kunden oder Lieferanten auflisten und ersetzen.
list_bank_accountsreplace_bank_accountsÖffentliche ANAF-Daten
Ein rumänisches Unternehmen per CUI nachschlagen (Name, Adresse, USt-/e-Factura-Status).
lookup_companyKatalog & Betrieb
Produkte, Lager und Nummernkreise.
list_productscreate_productget_productupdate_productdelete_productlist_warehousescreate_warehouseupdate_warehousedelete_warehouselist_seriescreate_seriesupdate_seriesdelete_seriesBerichte
Verkaufsjournal, USt-Bericht und Bankabgleich.
sales_journalvat_reportreconcile_bankEinstellungen
Die Mandantenkonfiguration lesen und aktualisieren.
get_settings_schemaget_settingsupdate_settingsSicherheit
Ein API-Schlüssel ist an dein Konto (Mandant) gebunden und kann jederzeit unter Einstellungen → API-Schlüssel widerrufen werden. Jeder MCP-Aufruf läuft mit denselben Rechten wie der Nutzer, der den Schlüssel erstellt hat — nicht mehr.
Bereit, einen KI-Assistenten zu verbinden?
Erstelle einen API-Schlüssel in der App und füge ihn deinem bevorzugten MCP-Client hinzu.
App öffnen