KI MCP-Server

Die MaxRechnung-REST-API als Werkzeuge für Claude Desktop, IDE-Erweiterungen und eigene Agent-Frameworks. Ein HTTP-Endpunkt, Authentifizierung mit deinem Business-API-Key.

Verbinden

In die Konfigurationsdatei deines MCP-Clients übernehmen und mxr_live_… durch einen eigenen API-Key ersetzen. Keys entstehen unter Einstellungen → API (Business-Tarif).

mcp.json / claude_desktop_config.json
{
  "mcpServers": {
    "maxrechnung": {
      "type": "http",
      "url": "https://maxrechnung.de/mcp",
      "headers": {
        "Authorization": "Bearer mxr_live_…"
      }
    }
  }
}

Clients ohne JSON-Konfiguration tragen den Server von Hand ein: Transport Streamable HTTP, URL https://maxrechnung.de/mcp, Header Authorization: Bearer mxr_live_….

Der Server hält keine Daten vor; er reicht den Key bei jedem Aufruf an /api/v1 durch. Dieselben Scopes, Rechte und Rate-Limits wie für jeden anderen API-Client.

Zugriff eingrenzen

X-MCP-Scopes und X-MCP-Tools wählen positiv aus und addieren sich. X-MCP-Read-Only und die echten Key-Scopes begrenzen das Ergebnis. Ohne jede Angabe: alle Tools, die der Key zulässt.

HeaderWirkung
X-MCP-Scopes: invoices:read,customers:readWählt alle Tools der genannten Scopes (kommasepariert). whoami (ohne Scope) kommt nur über X-MCP-Tools dazu.
X-MCP-Tools: list_invoices,get_invoiceWählt genau diese Tools (kommaseparierte Namen), feiner als ganze Scopes, addiert sich mit ihnen.
X-MCP-Read-Only: 1Kappt die Auswahl auf nur lesende Tools (28 von 55); auch namentlich genannte schreibende Tools fallen weg. Allein gesetzt: alle lesenden Tools.
?scopes=…&tools=…&read_only=1Gleiche Wirkung als Query-Parameter an der URL, für Clients, die keine eigenen Header setzen können.
Nur Rechnungen und Kunden, nur lesend
{
  "mcpServers": {
    "maxrechnung": {
      "type": "http",
      "url": "https://maxrechnung.de/mcp",
      "headers": {
        "Authorization": "Bearer mxr_live_…",
        "X-MCP-Scopes": "invoices:read,customers:read"
      }
    }
  }
}

Weil X-MCP-Scopes und X-MCP-Tools sich addieren, lässt sich ein Toolset gezielt um einzelne Tools erweitern. Beispiel: der ganze invoices:write-Scope plus zwei namentlich genannte Lese-Tools, nicht der komplette invoices:read-Scope.

Ein Scope + zwei einzelne Tools dazu
{
  "mcpServers": {
    "maxrechnung": {
      "type": "http",
      "url": "https://maxrechnung.de/mcp",
      "headers": {
        "Authorization": "Bearer mxr_live_…",
        "X-MCP-Scopes": "invoices:write",
        "X-MCP-Tools": "list_invoices,get_invoice"
      }
    }
  }
}

55 Werkzeuge

Die Werkzeuge entstehen automatisch aus der OpenAPI-Spezifikation der REST-API: 55 der 66 Endpunkte. Nur über REST laufen Einzelabruf, Ändern und Löschen von Vorlagen sowie das Anlegen von Sets und Rechnungsvorlagen. Eine Karte je Ressource: links die lesenden, rechts die schreibenden Werkzeuge, jeweils unter dem verlangten Scope.

Ohne Scope· mit jedem gültigen Key

Lesenkein Scope

  • whoamiAPI-Key prüfen (Whoami)

Rechnungen· Rechnungen, Angebote und weitere Belege, Zahlungen, Exporte

Leseninvoices:read

  • download_invoice_pdfPDF der Rechnung
  • download_invoice_xrechnungE-Rechnung (XRechnung 3.0.2 / CII-XML)
  • download_invoice_zugferdZUGFeRD 2.5.2 / Factur-X 1.09.2 (PDF/A-3 mit eingebettetem XML)
  • download_sales_document_pdfPDF des Belegs
  • get_invoiceBeleg abrufen
  • get_invoice_auditÄnderungshistorie (GoBD)
  • get_invoice_girocodeGiroCode (EPC069-12) für den Rechnungsbetrag
  • get_invoice_summarySummen je Kunde, Status oder Monat
  • get_jobStand eines asynchronen Auftrags (ZUGFeRD-Erzeugung)
  • get_paymentZahlungseingang abrufen
  • get_sales_documentBeleg lesen
  • list_custom_fieldsEigene Felder auflisten
  • list_invoicesBelege auflisten
  • list_paymentsZahlungseingänge auflisten
  • list_sales_documentsBelege auflisten

Schreibeninvoices:draft

  • add_invoice_items_from_templateVorlage in Rechnungsentwurf einfügen
  • check_invoice_recipient_vat_idEmpfänger-USt-IdNr. prüfen und festhalten
  • convert_sales_documentBeleg umwandeln
  • create_invoice_draftRechnung anlegen (Entwurf)
  • create_invoice_from_templateRechnung aus Vorlage erstellen
  • create_sales_documentBeleg anlegen
  • delete_invoice_draftEntwurf löschen
  • delete_sales_documentBeleg löschen
  • merge_sales_documentsSammelrechnung aus Belegen
  • revise_quoteNeue Fassung eines Angebots
  • update_invoice_draftEntwurf bearbeiten
  • update_sales_documentBeleg ändern
  • update_sales_document_statusBelegstatus setzen

Schreibeninvoices:write

  • amend_paymentZahlungseingang berichtigen
  • cancel_invoiceRechnung stornieren
  • cancel_paymentZahlungseingang stornieren
  • create_correctionRechnungskorrektur anlegen
  • record_paymentZahlungseingang erfassen
  • update_invoice_statusBeleg festschreiben

Kunden· Kundenstamm

Lesencustomers:read

  • get_customerKunde abrufen
  • list_customersKunden auflisten

Schreibencustomers:write

  • check_customer_vat_idUSt-IdNr. des Kunden prüfen und festhalten
  • create_customerKunde anlegen
  • delete_customerKunde löschen
  • update_customerKunde ändern

Vorlagen· Positionen, Sets, Rechnungsvorlagen

Lesentemplates:read

  • list_invoice_templatesRechnungsvorlagen auflisten
  • list_item_template_setsSets auflisten
  • list_item_templatesPositions-Vorlagen auflisten

Schreibentemplates:write

  • create_item_templatePositions-Vorlage anlegen

Prüfungen· USt-IdNr.- und IBAN-Prüfung

Lesenchecks:read

  • check_ibanIBAN prüfen + Bankname
  • check_vat_idUSt-IdNr. prüfen (VIES oder qualifiziert per BZSt)

Webhooks· Endpunkte und Signaturprüfung

Lesenwebhooks:read

  • get_webhookWebhook-Endpunkt abrufen
  • list_webhooksWebhook-Endpunkte auflisten
  • verify_webhook_signatureEmpfangene Signatur prüfen

Schreibenwebhooks:write

  • create_webhookWebhook-Endpunkt registrieren
  • delete_webhookWebhook-Endpunkt löschen
  • send_webhook_testTest-Zustellung senden

datev

Lesendatev:read

  • export_datevDATEV-Buchungsstapel (EXTF-CSV)
  • export_datev_creditorsDATEV-Stammdaten der Personenkonten (Debitoren und Kreditoren)