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/mcp Authentifizierung
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/mcp Variante 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_purchases ANAF e-Factura
Belege ans SPV senden, Status verfolgen und empfangene Rechnungen importieren.
send_to_anafpoll_efacturasync_inboxlist_inboximport_inbox Unternehmen
Die Unternehmen deines Kontos auflisten und verwalten.
list_companiescreate_companyget_companyupdate_company Kunden
Kunden (Vertragspartner) eines Unternehmens erstellen und verwalten.
list_clientscreate_clientget_clientupdate_clientdelete_client Lieferanten
Lieferanten (die Parteien, von denen du einkaufst) eines Unternehmens erstellen und verwalten.
list_suppliersget_suppliercreate_supplierupdate_supplierdelete_supplier Ausgaben
Lieferantenausgaben erfassen und verwalten.
list_expensescreate_expenseupdate_expensedelete_expense Wiederkehrende Rechnungen
Vorlagen erstellen, die automatisch Rechnungsentwürfe nach einem Rhythmus generieren.
list_recurringcreate_recurringupdate_recurringdelete_recurring Bankkonten
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_company Katalog & Betrieb
Produkte, Lager und Nummernkreise.
list_productscreate_productget_productupdate_productdelete_productlist_warehousescreate_warehouseupdate_warehousedelete_warehouselist_seriescreate_seriesupdate_seriesdelete_series Berichte
Verkaufsjournal, USt-Bericht und Bankabgleich.
sales_journalvat_reportreconcile_bank Einstellungen
Die Mandantenkonfiguration lesen und aktualisieren.
get_settings_schemaget_settingsupdate_settings Sicherheit
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