f facturifirma

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. 1. Öffne in claude.ai: Einstellungen → Connectors und klicke auf „Add custom connector“.
  2. 2. Gib ihm einen Namen (z. B. „facturifirma“), füge die Adresse https://app.facturifirma.ro/mcp ein und klicke auf „Add“.
  3. 3. Klicke beim neuen Connector auf „Connect“ — du wirst zur Anmeldung zu facturifirma weitergeleitet (falls nicht bereits angemeldet).
  4. 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. 1. Erstelle einen API-Schlüssel in der App: Einstellungen → API-Schlüssel.
  2. 2. Sende den Schlüssel bei jeder Anfrage als Authorization: Bearer <API_SCHLÜSSEL>.
  3. 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

← Zurück zur Startseite