Documentatie voor de MCP-server
Valideer, maak, converteer en extraheer e-facturen vanuit Claude, ChatGPT en andere MCP-clients
De externe MCP-server verbindt een AI-assistent met de Electronic Invoice API. U logt één keer in met uw eigen API-sleutel; daarna kan de assistent XRechnung- en ZUGFeRD-facturen valideren, ze op basis van uw gegevens aanmaken, converteren en exporteren. Deze pagina behandelt het instellen, de tools, de ondersteunde formaten en probleemoplossing.
Server
| URL | https://mcp.electronic-invoice.app/mcp (Streamable HTTP) |
|---|---|
| MCP Registry | Opgenomen in het officiële MCP Registry als app.electronic-invoice/mcp |
| Inloggen | OAuth 2.1, of Authorization: Bearer met uw API-sleutel voor directe clients |
| Zonder inloggen | Tools voor servicestatus en limieten |
| Voor | Alleen bedrijven (B2B) |
Inloggen en API-sleutel
De MCP-server heeft geen eigen accounts. U maakt een API-sleutel aan in de console. Wanneer de assistent voor het eerst een beschermde tool gebruikt, opent deze een inlogpagina op mcp.electronic-invoice.app, waar u die sleutel invoert. Tijdens de verbinding wordt de sleutel uitsluitend AES-GCM-versleuteld opgeslagen. De sleutel wordt verwijderd wanneer u de verbinding intrekt of wanneer de sleutel verloopt.
Clients die geen OAuth ondersteunen, kunnen de sleutel rechtstreeks meesturen als Authorization: Bearer eia_live_.... De tools voor servicestatus en limieten werken zonder enige vorm van inloggen.
Instellen
Menunamen verschillen per versie; als een label afwijkt, zoekt u naar de overeenkomstige vermelding.
Claude
- Open Instellingen of Aanpassen en daarna Connectors.
- Kies Aangepaste connector toevoegen en voer
https://mcp.electronic-invoice.app/mcpin. - Vraag in een chat om iets waarvoor een factuurtool nodig is. Bij het eerste gebruik van een beschermde tool vraagt Claude u om verbinding te maken; log in met uw API-sleutel.
ChatGPT
Op dit moment werkt dit via de ontwikkelaarsmodus: maak in Instellingen bij Apps een app aan met de server-URL en kies OAuth als authenticatie. De exacte stappen hangen af van uw abonnement en de instellingen van uw werkruimte.
Andere clients
Elke client die externe MCP-servers via Streamable HTTP ondersteunt, kan de URL gebruiken. Kies OAuth als dit wordt aangeboden, of stel de bearer-header in met uw API-sleutel.
Tools
| Tool | Wat het doet |
|---|---|
validate_invoice | Controleert een e-factuur (XML of PDF) en retourneert het oordeel en de bevindingen met regel-ID |
generate_invoice | Maakt een XRechnung (UBL of CII) of een ZUGFeRD/Factur-X PDF aan op basis van factuurgegevens als JSON |
convert_invoice | Converteert UBL naar CII, CII naar UBL of XML naar PDF |
extract_invoice | Leest factuurgegevens als JSON, CSV of een DATEV-export |
open_invoice_check | Opent een uploadveld in de chat, voor clients die geen bestanden aan de tool kunnen doorgeven (bijvoorbeeld Claude) |
get_service_status | Servicestatus en versies van regelsets, inloggen niet nodig |
get_usage_limits | Technische limieten (aanvraagsnelheid, grootte, factureerbare statuscodes), inloggen niet nodig |
Ondersteunde formaten voor validatie
De MCP-server controleert dezelfde formaten als de API: XRechnung, EN 16931, Peppol BIS, NLCIUS, CIUS-RO, Franse CIUS-regels, ZUGFeRD/Factur-X, en Italië en Polen uitsluitend tegen het schema. De tabel met de reikwijdte van de controle per formaat staat op de API-pagina. Het aanmaken van facturen is beperkt tot XRechnung en ZUGFeRD/Factur-X. De server verstuurt geen facturen en heeft geen toegang tot Peppol.
Voorbeeldprompts
- "Is deze e-factuur geldig?" met een PDF- of XML-bestand als bijlage. In Claude opent de assistent het uploadveld.
- "Maak een XRechnung (CII) voor Muster GmbH, 3 uur consultancy voor EUR 120, 19 procent btw, koperreferentie 04011000-12345-34." Controleer daarna de gegevens die de assistent vermeldt voordat u het bestand gebruikt.
- "Converteer deze UBL-factuur naar CII."
- "Exporteer deze factuur als DATEV-boekingsbatch."
- "Welke regel is hier geschonden en wat moet ik in de XML wijzigen?"
- "Is de factuurservice operationeel en wat zijn de limieten voor aanvraagsnelheid en grootte?"
Quotum en kosten
Elke factureerbare aanroep telt mee voor het quotum van uw abonnement, precies zoals een rechtstreekse API-aanroep. Abonnementen en limieten staan vermeld op de API-pagina. Het openen van het uploadveld is gratis; een controle telt zodra u deze start.
Probleemoplossing
- Inloglus: de sleutel is afgewezen of ingetrokken. Maak een nieuwe sleutel aan in de console, verwijder de connector in de client en voeg deze opnieuw toe. Voer de sleutel alleen in op de inlogpagina, niet in de connectorinstellingen.
- 401-fout: de sleutel ontbreekt, is onjuist of ingetrokken. Maak opnieuw verbinding met een actieve sleutel; controleer bij een bearer-header de waarde van de header.
- 429 quotum overschreden: het maandelijkse quotum van uw abonnement is verbruikt. Wacht op de volgende periode of wijzig uw abonnement. Probeer het bij een 429 met een wachttijd (snelheidslimiet) na het opgegeven aantal seconden opnieuw.
- Bestand niet doorgegeven: de client kan het bestand niet aan de tool doorgeven. Vraag de assistent de factuurcontrole te openen; deze toont een uploadveld in de chat.
- Resultaat lijkt onjuist: vraag om de bevindingen met regel-ID's en vergelijk deze met de factuur. Bevindingen zijn de uitvoer van de officiële regels, geen uitspraak over uw contract of fiscale positie.
Komt u er nog niet uit? Neem contact met ons op via de contactpagina.
Privacy en voorwaarden
Welke gegevens worden verwerkt, waar en hoe lang, is beschreven in de privacyverklaring, het onderdeel over de MCP-server. De API-voorwaarden zijn van toepassing. Als u een factuur in een chat plaatst, ziet de aanbieder van de assistent deze ook; daarvoor gelden de voorwaarden van die aanbieder.
Let op: controles en resultaten zijn technische hulpmiddelen, geen juridisch of fiscaal advies.
Juridische teksten zijn beschikbaar in het Duits en Engels: privacybeleid, API-voorwaarden en colofon. Alleen de Duitse versie is juridisch bindend.