Documentația serverului MCP
Validați, creați, convertiți și extrageți facturi electronice din Claude, ChatGPT și alți clienți MCP
Serverul MCP la distanță conectează un asistent AI la Electronic Invoice API. Vă autentificați o singură dată cu propria cheie API; după aceea, asistentul poate valida facturi XRechnung și ZUGFeRD, le poate crea din datele dumneavoastră, le poate converti și exporta. Această pagină acoperă configurarea, instrumentele, formatele acceptate și depanarea.
Server
| URL | https://mcp.electronic-invoice.app/mcp (Streamable HTTP) |
|---|---|
| Registrul MCP | Listat în Registrul oficial MCP ca app.electronic-invoice/mcp |
| Autentificare | OAuth 2.1 sau Authorization: Bearer cu cheia dumneavoastră API pentru clienții direcți |
| Fără autentificare | Instrumentele de stare a serviciului și de limite |
| Pentru | Numai întreprinderi (B2B) |
Autentificare și cheie API
Serverul MCP nu are conturi proprii. Creați o cheie API în consolă. Când asistentul folosește pentru prima dată un instrument protejat, deschide o pagină de autentificare pe mcp.electronic-invoice.app, unde introduceți cheia respectivă. Pe durata conexiunii, cheia este stocată numai criptată cu AES-GCM. Este ștearsă când revocați conexiunea sau când aceasta expiră.
Clienții care nu acceptă OAuth pot trimite cheia direct ca Authorization: Bearer eia_live_.... Instrumentele pentru starea serviciului și limite funcționează fără nicio autentificare.
Configurare
Numele meniurilor se schimbă de la o versiune la alta; dacă o etichetă diferă, căutați intrarea echivalentă.
Claude
- Deschideți Setări sau Personalizare, apoi Conectori.
- Alegeți Adăugați un conector personalizat și introduceți
https://mcp.electronic-invoice.app/mcp. - Într-o conversație, cereți ceva care necesită un instrument pentru facturi. La prima utilizare a unui instrument protejat, Claude vă cere să vă conectați; autentificați-vă cu cheia dumneavoastră API.
ChatGPT
În prezent, acest lucru funcționează prin modul pentru dezvoltatori: în Setări, Aplicații, creați o aplicație cu URL-ul serverului și alegeți OAuth ca metodă de autentificare. Pașii exacți depind de planul și de setările spațiului de lucru.
Alți clienți
Orice client care acceptă servere MCP la distanță prin Streamable HTTP poate folosi URL-ul. Alegeți OAuth dacă este oferit sau setați antetul bearer cu cheia dumneavoastră API.
Instrumente
| Instrument | Ce face |
|---|---|
validate_invoice | Verifică o factură electronică (XML sau PDF) și returnează verdictul și constatările cu ID-ul regulii |
generate_invoice | Creează o factură XRechnung (UBL sau CII) sau un PDF ZUGFeRD/Factur-X din date de factură în format JSON |
convert_invoice | Convertește UBL în CII, CII în UBL sau XML în PDF |
extract_invoice | Citește datele facturii ca JSON, CSV sau export DATEV |
open_invoice_check | Deschide un câmp de încărcare în conversație, pentru clienții care nu pot transmite fișiere instrumentului (de exemplu Claude) |
get_service_status | Starea serviciului și versiunile setului de reguli, fără autentificare |
get_usage_limits | Limite tehnice (rată, dimensiune, coduri de stare facturabile), fără autentificare |
Formate acceptate pentru validare
Serverul MCP verifică aceleași formate ca API-ul: XRechnung, EN 16931, Peppol BIS, NLCIUS, CIUS-RO, regulile CIUS franceze, ZUGFeRD/Factur-X, iar Italia și Polonia numai conform schemei. Tabelul cu domeniul de aplicare al verificării pentru fiecare format se află pe pagina API. Crearea facturilor este limitată la XRechnung și ZUGFeRD/Factur-X. Serverul nu trimite facturi și nu are acces la Peppol.
Exemple de solicitări
- „Această factură electronică este validă?” cu un fișier PDF sau XML atașat. În Claude, asistentul deschide câmpul de încărcare.
- „Creați o factură XRechnung (CII) pentru Muster GmbH, 3 ore de consultanță la EUR 120, TVA de 19 la sută, referința cumpărătorului 04011000-12345-34.” Apoi verificați datele pe care asistentul le listează înainte de a utiliza fișierul.
- „Convertiți această factură UBL în CII.”
- „Exportați această factură ca lot de înregistrări DATEV.”
- „Care regulă este încălcată aici și ce trebuie să modific în XML?”
- „Serviciul de facturi este disponibil și care sunt limitele de rată și de dimensiune?”
Cotă și costuri
Fiecare apel facturabil se contează în cota planului dumneavoastră, exact ca un apel API direct. Planurile și limitele sunt listate pe pagina API. Deschiderea câmpului de încărcare este gratuită; o verificare se contează în momentul în care o porniți.
Depanare
- Buclă de autentificare: cheia a fost respinsă sau este revocată. Creați o cheie nouă în consolă, eliminați conectorul din client și adăugați-l din nou. Introduceți cheia numai pe pagina de autentificare, nu în setările conectorului.
- Eroare 401: cheia lipsește, este greșită sau revocată. Reconectați-vă cu o cheie activă; dacă folosiți un antet bearer, verificați valoarea antetului.
- 429 cotă depășită: cota lunară a planului dumneavoastră este epuizată. Așteptați următoarea perioadă sau schimbați planul. Pentru un 429 cu timp de așteptare (limită de rată), încercați din nou după secundele indicate.
- Fișier netransmis: clientul nu poate transmite fișierul instrumentului. Rugați asistentul să deschidă verificarea facturii; aceasta afișează un câmp de încărcare în conversație.
- Rezultatul pare greșit: cereți constatările cu ID-urile regulilor și comparați-le cu factura. Constatările sunt rezultatul regulilor oficiale, nu o afirmație privind contractul sau situația fiscală.
Încă nu ați reușit? Scrieți-ne prin pagina de contact.
Confidențialitate și condiții
Ce date sunt prelucrate, unde și pentru cât timp este descris în politica de confidențialitate, secțiunea despre serverul MCP. Se aplică condițiile API. Dacă introduceți o factură într-o conversație, furnizorul asistentului o vede de asemenea; în acest caz se aplică condițiile sale.
Notă: verificările și rezultatele sunt auxiliare tehnice, nu consultanță juridică sau fiscală.
Textele juridice sunt disponibile în germană și engleză: politica de confidențialitate, condițiile API și impresum. Numai versiunea germană este obligatorie din punct de vedere juridic.