Añade el servidor MCP de Factusur a Cursor con un clic o mediante mcp.json, y convierte y comprueba tus facturas Factur-X desde el agente.
Instalar Factusur en Cursor
Un clic en “Add to Cursor” o unas pocas líneas en mcp.json.
Añadir a CursorAbre Cursor con la configuración ya rellenada.
1Paso 1: Haz clic en “Add to Cursor” (Cursor debe estar instalado) o pega la configuración en ~/.cursor/mcp.json (todos los proyectos) o .cursor/mcp.json (este proyecto).
2Paso 2: En Cursor › Settings › MCP, haz clic en “Connect” junto a factusur: se abre la página de Factusur para autorizar.
3Paso 3: En el chat (modo Agent), pide: “Convierte esta factura a Factur-X con Factusur”.
Para un script, una integración continua o una herramienta sin inicio de sesión OAuth. Crea una clave en Cuenta › Conexiones MCP: solo se muestra una vez. No la pegues nunca en un archivo bajo control de versiones.
PDF, foto o datos estructurados → Factur-X EN 16931, con un informe de verificación y un enlace de descarga. Si falta un dato obligatorio, el agente te lo pide.
“Convierte invoice-042.pdf a Factur-X con Factusur.”
“Crea un Factur-X para esta factura: 3 días de consultoría a 450 € sin IVA, cliente Exemple SAS.”
validate_facturxValidarno cuenta nada
Comprobar un Factur-X
Comprueba PDF/A-3, XML, XSD, el schematron EN 16931 y las menciones obligatorias francesas de un Factur-X recibido. No cuenta ninguna conversión.
“Comprueba el Factur-X que me ha enviado mi proveedor y dime qué falla.”
get_usageLeerno cuenta nada
Cuota y plan
Conversiones usadas y restantes, fecha de renovación, límites de seguridad.
Vuelve a iniciar sesión desde tu herramienta (/mcp en Claude Code, “Connect” en Cursor, codex mcp login). Una clave revocada o caducada debe sustituirse.
“quota_exceeded”
Has agotado tu cuota mensual: abre el enlace que muestra el agente para cambiar de plan o añadir un pack y pide al agente que reanude la conversión (no se vuelve a leer nada).
“needs_input”: faltan datos
A la factura le faltan algunos datos obligatorios (SIREN del cliente, fecha…). Dáselos al agente: los corrige con update_conversion y vuelve a lanzar la conversión.
“rate_limited”
Se ha alcanzado un límite de seguridad (llamadas por minuto, conversiones por día). Espera un momento o ajusta tus límites en Cuenta › Conexiones MCP.
Archivo demasiado grande
Por encima de 3 MB, el agente debe usar create_upload_url (subida directa, 10 MB como máximo). Un PDF de más de 10 páginas se rechaza: sube solo la factura.
Mi herramienta no encuentra el servidor
Comprueba la URL exacta https://factusur.com/mcp y el transporte “http” (Streamable HTTP). Los clientes antiguos limitados al transporte SSE no son compatibles.
Factusur no es una plataforma autorizada (plateforme agréée, PA) y no transmite tus facturas. Creamos un archivo en formato Factur-X a partir de los datos que tú confirmas.