Servidor MCP de Factura Electrónica

Servidor MCP para facturas electrónicas en la región DACH: cree, valide y extraiga datos de XRechnung. Directamente desde Claude, Cursor o cualquier cliente MCP.

¿Qué es esto?

E-Invoice MCP es un servidor del Model Context Protocol para la creación y validación de facturas electrónicas según el estándar alemán XRechnung. A partir de 2027, todas las empresas en Alemania deberán poder enviar facturas electrónicas; con esta herramienta estarás preparado.

Simplemente dile a Claude: "Crea una factura para Beispiel GmbH por 10 horas de consultoría" y obtendrás una XRechnung válida como XML UBL 2.1.

Características

• Crear XRechnung — XML UBL 2.1 válido a partir de datos estructurados (EN 16931 + XRechnung 3.0.2)

• Validar factura electrónica — Comprobar sintaxis, campos obligatorios y reglas de negocio alemanas (BR-DE)

• Extraer datos — Leer datos estructurados de XML UBL o CII

• Información de formato — Referencia para campos obligatorios, categorías de impuestos, códigos de unidades y plazos

• Cálculo automático — Los importes netos, brutos y de impuestos se calculan automáticamente

• Compatible con plugins — Puede ejecutarse de forma independiente O integrarse en el servidor MCP de BuchPilot

• Sin servicios externos — Todo se ejecuta localmente, no se necesitan claves API

• Sin dependencias nativas — Se ejecuta en cualquier sistema con Node.js

Plazos legales

Las facturas electrónicas incorrectas pueden provocar la pérdida de la deducción del IVA soportado (+ 6% de intereses).

Instalación

Requisitos previos

• Node.js >= 18

npm (global)

npm install -g einvoice-mcp

Desde el código fuente

git clone https://github.com/makririch/einvoice-mcp.git
cd einvoice-mcp
npm install
npm run build

Configuración

Este servidor MCP no requiere configuración. No se necesitan claves API ni servicios externos; todo se ejecuta localmente.

Uso

Iniciar el servidor (independiente)

# Nach npm install -g:
einvoice-mcp

# Oder von Source:
npm start

# Entwicklung mit Auto-Reload:
npm run dev

El servidor se ejecuta a través de stdio y espera mensajes MCP.

Uso en Claude Desktop

Consulta la Guía de configuración de Claude Desktop para obtener instrucciones detalladas.

Versión corta: añade esto a claude_desktop_config.json:

{
  "mcpServers": {
    "einvoice": {
      "command": "npx",
      "args": ["-y", "einvoice-mcp"]
    }
  }
}

Ejemplos (lenguaje natural en Claude)

Después de configurar el servidor, puedes preguntarle a Claude, por ejemplo:

• "Crea una XRechnung para Beispiel GmbH por 10 horas de consultoría a 150 EUR"

• "¿Es este archivo XML una XRechnung válida?"

• "Extrae los datos de la factura de este XML"

• "¿Qué campos obligatorios necesito para una XRechnung?"

• "¿Qué categorías de impuestos existen y qué significan?"

• "¿Hasta cuándo debe mi empresa poder enviar facturas electrónicas?"

Inicio rápido

Encontrarás una guía paso a paso "Crea tu primera XRechnung en 5 minutos" en docs/quickstart.md.

Referencia de herramientas

Encontrarás una referencia completa de las 4 herramientas con parámetros, entradas de ejemplo y salidas de ejemplo en docs/tool-reference.md.

Resumen rápido

Integración con BuchPilot

E-Invoice MCP puede integrarse como plugin en el servidor MCP de BuchPilot:

import { registerEInvoiceTools } from "einvoice-mcp";
registerEInvoiceTools(server);

Combinación: BuchPilot crea una factura en Lexoffice -> extraer datos -> generar XRechnung -> factura electrónica lista.

Estándares compatibles

FAQ / Solución de problemas

"No se pudo analizar el XML"

• ¿El XML está bien formado? (¿Están todas las etiquetas cerradas correctamente?)

• ¿Es realmente una factura UBL o CII? (El elemento raíz debe ser <Invoice> o <CrossIndustryInvoice>)

• ¿La codificación es UTF-8?

La validación muestra el error "BR-DE-13: Buyer Reference es obligatorio"

La referencia del comprador (BT-10) es obligatoria en XRechnung. En facturas a organismos públicos, este es el Leitweg-ID. En facturas B2B, puede ser cualquier referencia (por ejemplo, número de pedido).

{
  "buyerReference": "04011000-12345-67"
}

La validación muestra la advertencia "BR-DE-21: Se recomienda el número de teléfono"

Esto es solo una advertencia, no un error. La factura sigue siendo válida. Para una mejor compatibilidad, deberías indicar un número de teléfono del vendedor.

¿Qué categorías de impuestos existen?

¿Qué códigos de unidades existen?

El servidor se inicia, pero Claude no reconoce las herramientas

• Comprueba si el archivo claude_desktop_config.json es correcto

• Reinicia Claude Desktop después de realizar cambios en la configuración

• Comprueba los registros: ~/Library/Logs/Claude/mcp.log (macOS)

Licencia

MIT — Uso libre, también comercial.

Autor

MaKri — GitHub