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).
{
"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.
| Header | Wirkung |
|---|---|
| X-MCP-Scopes: invoices:read,customers:read | Wählt alle Tools der genannten Scopes (kommasepariert). whoami (ohne Scope) kommt nur über X-MCP-Tools dazu. |
| X-MCP-Tools: list_invoices,get_invoice | Wählt genau diese Tools (kommaseparierte Namen), feiner als ganze Scopes, addiert sich mit ihnen. |
| X-MCP-Read-Only: 1 | Kappt 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=1 | Gleiche Wirkung als Query-Parameter an der URL, für Clients, die keine eigenen Header setzen können. |
{
"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.
{
"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 Rechnungdownload_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 Belegsget_invoiceBeleg abrufenget_invoice_auditÄnderungshistorie (GoBD)get_invoice_girocodeGiroCode (EPC069-12) für den Rechnungsbetragget_invoice_summarySummen je Kunde, Status oder Monatget_jobStand eines asynchronen Auftrags (ZUGFeRD-Erzeugung)get_paymentZahlungseingang abrufenget_sales_documentBeleg lesenlist_custom_fieldsEigene Felder auflistenlist_invoicesBelege auflistenlist_paymentsZahlungseingänge auflistenlist_sales_documentsBelege auflisten
Schreibeninvoices:draft
add_invoice_items_from_templateVorlage in Rechnungsentwurf einfügencheck_invoice_recipient_vat_idEmpfänger-USt-IdNr. prüfen und festhaltenconvert_sales_documentBeleg umwandelncreate_invoice_draftRechnung anlegen (Entwurf)create_invoice_from_templateRechnung aus Vorlage erstellencreate_sales_documentBeleg anlegendelete_invoice_draftEntwurf löschendelete_sales_documentBeleg löschenmerge_sales_documentsSammelrechnung aus Belegenrevise_quoteNeue Fassung eines Angebotsupdate_invoice_draftEntwurf bearbeitenupdate_sales_documentBeleg ändernupdate_sales_document_statusBelegstatus setzen
Schreibeninvoices:write
amend_paymentZahlungseingang berichtigencancel_invoiceRechnung stornierencancel_paymentZahlungseingang stornierencreate_correctionRechnungskorrektur anlegenrecord_paymentZahlungseingang erfassenupdate_invoice_statusBeleg festschreiben
Kunden· Kundenstamm
Lesencustomers:read
get_customerKunde abrufenlist_customersKunden auflisten
Schreibencustomers:write
check_customer_vat_idUSt-IdNr. des Kunden prüfen und festhaltencreate_customerKunde anlegendelete_customerKunde löschenupdate_customerKunde ändern
Vorlagen· Positionen, Sets, Rechnungsvorlagen
Lesentemplates:read
list_invoice_templatesRechnungsvorlagen auflistenlist_item_template_setsSets auflistenlist_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 + Banknamecheck_vat_idUSt-IdNr. prüfen (VIES oder qualifiziert per BZSt)
Webhooks· Endpunkte und Signaturprüfung
Lesenwebhooks:read
get_webhookWebhook-Endpunkt abrufenlist_webhooksWebhook-Endpunkte auflistenverify_webhook_signatureEmpfangene Signatur prüfen
Schreibenwebhooks:write
create_webhookWebhook-Endpunkt registrierendelete_webhookWebhook-Endpunkt löschensend_webhook_testTest-Zustellung senden
datev
Lesendatev:read
export_datevDATEV-Buchungsstapel (EXTF-CSV)export_datev_creditorsDATEV-Stammdaten der Personenkonten (Debitoren und Kreditoren)