Rechnungslotse
Faturamento eletrônico alemão via MCP: crie XRechnung e ZUGFeRD, valide conforme EN 16931 e as regras KoSIT, com cada violação retornada como um ID de regra mais uma correção em linguagem simples, e leia uma fatura em dados estruturados. Também cobre as especificidades alemãs que um validador genérico não cobre: dígitos de verificação da Leitweg-ID, os campos obrigatórios da seção 14 UStG, o mandato escalonado de 2027/2028 e os limites para pequenas empresas. 18 ferramentas, 7 delas não exigem conta ou chave. HTTP Streamable hospedado em https://rechnungslotse.de/api/mcp; arquivos enviados nunca são armazenados.
Documentação
Servidor MCP Rechnungslotse
Um servidor hospedado de Model Context Protocol para faturamento eletrônico alemão: crie, valide e leia arquivos XRechnung e ZUGFeRD conforme a norma EN 16931.
Sete das dezoito ferramentas funcionam sem conta ou chave de API. Aponte seu cliente para a URL abaixo e comece.
https://rechnungslotse.de/api/mcp
Transporte: Streamable HTTP. Autenticação: OAuth 2.1 (necessária apenas para as ferramentas de conta).
Por que outro servidor de faturamento eletrônico
A maioria dos servidores MCP de faturamento eletrônico valida. Este também cria — e conhece as especificidades alemãs que um validador genérico EN 16931 não conhece: dígitos verificadores de Leitweg-ID, os campos obrigatórios do § 14 UStG, o limite de pequena empresa do § 19 UStG e o mandato alemão em fases (2025 receber, 2027/2028 emitir).
A validação é executada com base no conjunto completo de regras KoSIT. Cada violação retorna com seu ID de regra e uma explicação em linguagem simples, além de um link para uma página que explica essa regra.
Os arquivos nunca são armazenados. Eles existem apenas durante a chamada.
Configuração
Claude Code
claude mcp add --transport http rechnungslotse https://rechnungslotse.de/api/mcp
Claude Desktop, Cursor, VS Code, Zed
Adicione à sua configuração MCP:
{
"mcpServers": {
"rechnungslotse": {
"type": "http",
"url": "https://rechnungslotse.de/api/mcp"
}
}
}
ChatGPT
Adicione https://rechnungslotse.de/api/mcp como um servidor MCP remoto nas configurações do conector.
Listado em
| Diretório | Entrada |
|---|---|
| Registro Oficial MCP | de.rechnungslotse/e-rechnung |
| mcpservers.org | Finanças |
| TensorBlock | Finanças |
| Conectores Glama | de.rechnungslotse/e-rechnung, classificação A |
Ferramentas
Sem conta
Sem chave, sem cadastro, sem dados armazenados.
| Ferramenta | O que faz |
|---|---|
rechnung_pruefen | Valida um PDF XRechnung ou ZUGFeRD conforme EN 16931 e as regras KoSIT. Retorna cada violação com ID de regra e texto simples. |
rechnung_lesen | Lê uma fatura em dados estruturados: remetente, destinatário, itens de linha, totais, data de vencimento, dados bancários. |
fehler_erklaeren | Explica um ID de regra de uma mensagem de rejeição (BR-08, BR-CO-15, PEPPOL-EN16931-R053): o que a regra exige, causas comuns, como corrigir. |
pflicht_pruefen | Responde quando uma empresa alemã específica deve emitir faturas eletrônicas, com data e estatuto (§ 27 Abs. 38 UStG, § 34a UStDV). |
pflichtangaben_pruefen | Verifica uma fatura quanto aos campos obrigatórios do § 14 UStG — também funciona para uma fatura em Word ou PDF sem conjunto de dados. Trata faturas de pequeno valor (§ 33 UStDV), pequenas empresas e reverse charge. |
leitweg_pruefen | Divide um Leitweg-ID em suas partes, recalcula o dígito verificador MOD 97-10 e encontra dígitos transpostos. |
kleinunternehmer_pruefen | Verifica ambos os limites de faturamento da regra de pequena empresa conforme vigente desde 2025: €25.000 no ano anterior, €100.000 no ano atual. |
Com conta conectada
Plano gratuito: três faturas por mês. Essas ferramentas atuam dentro de uma empresa e exigem OAuth.
| Ferramenta | O que faz |
|---|---|
rechnung_erstellen | Cria uma fatura eletrônica validada (XRechnung, PDF, ZUGFeRD). Idempotente por número de pedido. |
rechnung_datei | Busca uma fatura gerada em um formato específico. |
rechnungen_suchen | Lista faturas por estado, período ou termo de busca, com valor em aberto e flag de atraso. |
kunden_suchen | Consulta o endereço completo de um cliente no catálogo de endereços. |
betrieb_lesen | Lê os dados mestre da empresa. |
leistung_erfassen | Registra trabalho realizado para um cliente — horas, material, taxas fixas, viagens. |
leistungen_offen | Mostra o que está registrado mas ainda não foi faturado. |
leistungen_abrechnen | Transforma os itens em aberto de um cliente em uma fatura eletrônica validada. |
zahlung_erfassen | Registra um pagamento recebido contra uma fatura. |
offene_posten | Lista faturas vencidas com dias de atraso e o nível de cobrança devido. |
umsatzsteuer_aufstellung | Totais líquidos e de impostos por alíquota para uma declaração de IVA, com números de campo ELSTER. |
Exemplos
Pergunte ao seu assistente:
"Este XRechnung foi rejeitado com BR-DE-15. O que isso significa e como corrijo?"
"Leia este PDF ZUGFeRD e me diga o que contém."
"Meu faturamento foi de €22.000 no ano passado e €41.000 até agora este ano. Ainda sou pequena empresa?"
"A partir de 2028, preciso emitir faturas eletrônicas? Vendo para empresas, faturamento abaixo de €800.000."
Autenticação
As sete ferramentas acima não precisam de nada. tools/list funciona sem autenticação, para que um cliente veja todas as ferramentas antes de conectar.
Chamar uma ferramenta de conta sem token retorna 401 com um cabeçalho WWW-Authenticate apontando para os metadados do recurso. Clientes MCP transformam isso em um prompt de conexão. OAuth 2.1 com PKCE, registro dinâmico de clientes e documentos de metadados de ID de cliente são todos suportados:
https://rechnungslotse.de/.well-known/oauth-protected-resourcehttps://rechnungslotse.de/.well-known/oauth-authorization-server
Limites e transparência
- Lei de faturamento alemã. Os estatutos referenciados são alemães. A validação EN 16931 em si é europeia e se aplica mais amplamente, mas a lógica de mandato, Leitweg-ID e verificações do § 14 UStG são específicas da Alemanha.
- Não é aconselhamento fiscal. As ferramentas relatam o que as regras dizem. Casos de borda pertencem a um consultor fiscal.
- Limites de taxa se aplicam às ferramentas gratuitas para mantê-las disponíveis.
- Sem armazenamento de arquivos. Faturas enviadas são mantidas em memória durante a chamada e descartadas.
Links
- Servidor e configuração: https://rechnungslotse.de/mcp
- Banco de dados de regras, uma página por regra de validação: https://rechnungslotse.de/fehler
- Ferramentas gratuitas de navegador (validador, visualizador, verificadores): https://rechnungslotse.de/tools
- API REST para desenvolvedores: https://rechnungslotse.de/entwickler
Deutsch
MCP-Server für die deutsche E-Rechnung. XRechnung und ZUGFeRD erstellen, gegen EN 16931 und die KoSIT-Regeln prüfen und im Klartext lesen — direkt aus Claude, ChatGPT oder einem anderen MCP-Client.
Sieben der achtzehn Werkzeuge laufen ohne Konto und ohne Schlüssel: prüfen, lesen, Prüfregeln erklären, E-Rechnungspflicht klären, Pflichtangaben nach § 14 UStG, Leitweg-ID und die Kleinunternehmergrenze nach § 19 UStG. Dateien werden dabei nicht gespeichert.
Adresse eintragen und loslegen:
https://rechnungslotse.de/api/mcp
Die übrigen elf Werkzeuge arbeiten im verbundenen Betrieb: Rechnung erstellen, Leistungen erfassen und abrechnen, Zahlungen verbuchen, offene Posten, Umsatzsteuer-Aufstellung mit ELSTER-Kennziffern. Drei Rechnungen im Monat sind dauerhaft kostenlos.
Ausführlich: https://rechnungslotse.de/mcp
Operado por AOS Digital, Alemanha. Este repositório documenta o servidor hospedado; não é o código-fonte do produto.