Dokumentacja serwera MCP
Walidacja, tworzenie, konwersja i odczyt e-faktur z poziomu Claude, ChatGPT i innych klientów MCP
Zdalny serwer MCP łączy asystenta AI z Electronic Invoice API. Logowanie odbywa się jednorazowo przy użyciu własnego klucza API; następnie asystent może walidować faktury XRechnung i ZUGFeRD, tworzyć je na podstawie własnych danych, konwertować i eksportować. Ta strona obejmuje konfigurację, narzędzia, obsługiwane formaty i rozwiązywanie problemów.
Serwer
| URL | https://mcp.electronic-invoice.app/mcp (Streamable HTTP) |
|---|---|
| MCP Registry | Wpisany w oficjalnym MCP Registry jako app.electronic-invoice/mcp |
| Logowanie | OAuth 2.1 lub Authorization: Bearer z kluczem API dla klientów bezpośrednich |
| Bez logowania | Narzędzia statusu usługi i limitów |
| Dla | Wyłącznie firmy (B2B) |
Logowanie i klucz API
Serwer MCP nie ma własnych kont. Klucz API tworzy się w konsoli. Gdy asystent po raz pierwszy użyje chronionego narzędzia, otwiera stronę logowania w domenie mcp.electronic-invoice.app, gdzie należy wprowadzić ten klucz. Na czas trwania połączenia klucz jest przechowywany wyłącznie w formie zaszyfrowanej AES-GCM. Jest usuwany po unieważnieniu połączenia lub po upływie jego ważności.
Klienci, którzy nie obsługują OAuth, mogą przesyłać klucz bezpośrednio jako Authorization: Bearer eia_live_.... Narzędzia statusu usługi i limitów działają bez żadnego logowania.
Konfiguracja
Nazwy menu zmieniają się między wersjami; jeśli etykieta się różni, należy szukać równoważnej pozycji.
Claude
- Proszę otworzyć Ustawienia lub Dostosuj, a następnie Konektory.
- Proszę wybrać Dodaj niestandardowy konektor i wprowadzić
https://mcp.electronic-invoice.app/mcp. - W czacie można poprosić o coś, co wymaga narzędzia do faktur. Przy pierwszym użyciu chronionego narzędzia Claude prosi o połączenie; należy zalogować się kluczem API.
ChatGPT
Obecnie działa to w trybie deweloperskim: w Ustawieniach, w sekcji Aplikacje, należy utworzyć aplikację z adresem URL serwera i wybrać OAuth jako metodę uwierzytelniania. Dokładne kroki zależą od planu i ustawień przestrzeni roboczej.
Inni klienci
Z adresu URL może korzystać każdy klient obsługujący zdalne serwery MCP przez Streamable HTTP. Należy wybrać OAuth, jeśli jest oferowany, lub ustawić nagłówek bearer z kluczem API.
Narzędzia
| Narzędzie | Działanie |
|---|---|
validate_invoice | Waliduje e-fakturę (XML lub PDF) i zwraca wynik oraz uwagi z identyfikatorem reguły |
generate_invoice | Tworzy XRechnung (UBL lub CII) lub plik PDF ZUGFeRD/Factur-X na podstawie danych faktury w formacie JSON |
convert_invoice | Konwertuje UBL na CII, CII na UBL lub XML na PDF |
extract_invoice | Odczytuje dane faktury jako JSON, CSV lub eksport DATEV |
open_invoice_check | Otwiera pole przesyłania w czacie, dla klientów, którzy nie mogą przekazać plików do narzędzia (na przykład Claude) |
get_service_status | Status usługi i wersje zestawów reguł, logowanie nie jest wymagane |
get_usage_limits | Limity techniczne (częstotliwość, rozmiar, rozliczane kody statusu), logowanie nie jest wymagane |
Obsługiwane formaty walidacji
Serwer MCP waliduje te same formaty co API: XRechnung, EN 16931, Peppol BIS, NLCIUS, CIUS-RO, francuskie reguły CIUS, ZUGFeRD/Factur-X, a w przypadku Włoch i Polski wyłącznie pod kątem schematu. Tabela z zakresem kontroli dla poszczególnych formatów znajduje się na stronie API. Tworzenie faktur jest ograniczone do XRechnung i ZUGFeRD/Factur-X. Serwer nie wysyła faktur i nie ma dostępu do Peppol.
Przykładowe zapytania
- „Czy ta e-faktura jest prawidłowa?” z załączonym plikiem PDF lub XML. W Claude asystent otwiera pole przesyłania.
- „Utwórz XRechnung (CII) dla Muster GmbH, 3 godziny konsultacji po EUR 120, 19 proc. VAT, referencja nabywcy 04011000-12345-34.” Przed użyciem pliku należy sprawdzić dane wskazane przez asystenta.
- „Przekonwertuj tę fakturę UBL na CII.”
- „Wyeksportuj tę fakturę jako partię księgowań DATEV.”
- „Która reguła jest tu naruszona i co muszę zmienić w XML?”
- „Czy usługa faktur działa i jakie są limity częstotliwości i rozmiaru?”
Limit i koszty
Każde rozliczane wywołanie obciąża limit planu, dokładnie tak jak bezpośrednie wywołanie API. Plany i limity są wymienione na stronie API. Otwarcie pola przesyłania jest bezpłatne; walidacja jest rozliczana z chwilą jej rozpoczęcia.
Rozwiązywanie problemów
- Pętla logowania: klucz został odrzucony lub został unieważniony. Należy utworzyć nowy klucz w konsoli, usunąć konektor w kliencie i dodać go ponownie. Klucz należy wprowadzać wyłącznie na stronie logowania, a nie w ustawieniach konektora.
- Błąd 401: brakuje klucza, jest nieprawidłowy lub unieważniony. Należy połączyć się ponownie z aktywnym kluczem; w przypadku nagłówka bearer należy sprawdzić wartość nagłówka.
- 429 przekroczony limit: miesięczny limit planu został wyczerpany. Należy poczekać na następny okres lub zmienić plan. W przypadku 429 z czasem oczekiwania (limit częstotliwości) należy ponowić próbę po podanej liczbie sekund.
- Plik nie został przekazany: klient nie może przekazać pliku do narzędzia. Należy poprosić asystenta o otwarcie walidacji faktury; w czacie pojawi się pole przesyłania.
- Wynik wygląda nieprawidłowo: należy poprosić o uwagi z identyfikatorami reguł i porównać je z fakturą. Uwagi są wynikiem działania oficjalnych reguł, a nie stwierdzeniem dotyczącym Państwa umowy lub sytuacji podatkowej.
Nadal brak rozwiązania? Prosimy o kontakt przez stronę kontaktową.
Prywatność i warunki
Jakie dane są przetwarzane, gdzie i przez jaki czas, opisano w polityce prywatności, w sekcji dotyczącej serwera MCP. Obowiązują warunki API. Jeśli faktura zostanie umieszczona w czacie, widzi ją również dostawca asystenta; w tym zakresie obowiązują jego warunki.
Uwaga: walidacje i wyniki są pomocą techniczną, a nie poradą prawną ani podatkową.
Teksty prawne są dostępne w języku niemieckim i angielskim: polityka prywatności, warunki API i nota prawna. Wiążąca prawnie jest wyłącznie wersja niemiecka.