Ir al contenido
Factusur

Servidor MCP · Claude · Cursor · VS Code · Codex

Convierte tus facturas a Factur-X desde tu asistente de IA

Añade Factusur a Claude, Cursor, VS Code o Codex. Pídele que “convierta esta factura”: el agente genera un Factur-X comprobado, te muestra el informe y te da el enlace de descarga.

  • 5 conversiones gratis al mes, con una cuenta
  • Un informe de verificación EN 16931 con cada Factur-X
  • El agente nunca paga: tú tienes el control

URL del servidor: https://factusur.com/mcp

La conversión es para facturas emitidas por empresas registradas en Francia (el vendedor necesita un número SIREN, el identificador de empresa francés). La comprobación de un Factur-X funciona con cualquier archivo.

Asistente de IA · servidor factusur

tú › Convierte facture-042.pdf a Factur-X con Factusur.

factusur · convert_to_facturx

lectura · generación · comprobaciones EN 16931…

Factur-X listo · comprobaciones PASS

1 conversión contabilizada · te quedan 2 este mes

facture-F2026-042-facturx.pdf · enlace válido 15 min

Ejemplo: el usuario pide a su asistente que convierta una factura; el asistente llama a la herramienta convert_to_facturx de Factusur y obtiene un Factur-X conforme, con un enlace de descarga.

Instalación · 2 minutos

Añade Factusur a tu herramienta

Comandos y configuraciones comprobados con la documentación de cada herramienta. Después inicias sesión en tu cuenta de Factusur en el navegador: no hay ninguna clave que copiar.

Un comando en el terminal y después inicias sesión en tu cuenta desde el navegador.

  1. Paso 1: En un terminal, añade el servidor con el comando de abajo (--scope user lo deja disponible en todos tus proyectos).
  2. Paso 2: Abre Claude Code, escribe /mcp, elige factusur y después “Authenticate”: tu navegador se abre en Factusur.
  3. Paso 3: Inicia sesión, revisa lo que Claude podrá hacer y haz clic en “Autorizar”.
  4. Paso 4: Después pide, por ejemplo: “Convierte invoice-042.pdf a Factur-X con Factusur”.
Terminal
claude mcp add --transport http --scope user factusur https://factusur.com/mcp

.mcp.json (proyecto compartido)
{
  "mcpServers": {
    "factusur": {
      "type": "http",
      "url": "https://factusur.com/mcp"
    }
  }
}

En la raíz de un repositorio, para todo el equipo. Cada persona inicia sesión con su propia cuenta.

Usar una clave de acceso en lugar de OAuth

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.

Con una clave de acceso
claude mcp add --transport http --scope user factusur https://factusur.com/mcp \
  --header "Authorization: Bearer fsk_live_TU_CLAVE"

Inicio de sesión: OAuth (inicio de sesión en el navegador) o una clave de acceso en una cabecera. Fuente: Documentación de Claude Code (MCP) (se abre en una pestaña nueva), comprobada el 26 de octubre de 2026.

Guía completa para Claude Code

Herramientas

Lo que puede hacer tu agente

Convertir, corregir, comprobar, vigilar tu cuota: algunos ejemplos de peticiones.

convert_to_facturxConvertircuenta una conversión

Convertir una factura

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.”
batch_convertConvertircuenta una conversión

Convertir un lote

Hasta 20 facturas a la vez, con un archivo ZIP. El desbloqueo es todo o nada: si la cuota no alcanza, no se contabiliza nada.

  • “Convierte a Factur-X todas las facturas PDF de la carpeta ./octubre.”
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.”
Las 9 herramientas del servidor MCP de Factusur

Límites y cuotas

La misma cuota que en la web

Cada Factur-X conforme desbloqueado por el agente cuenta una conversión de tu plan, exactamente igual que en la web. Comprobar un Factur-X no cuenta nada. Los precios incluyen el IVA francés (20 %).

Ver precios
Conversiones al mes y precio con IVA incluido de cada plan
PlanConversiones al mesPrecio IVA incluido
Gratis50 €
Starter103,90 €/mes
Essentiel306,90 €/mes
Pro10013,90 €/mes
Business50026,90 €/mes
Formatos
PDF, JPG, PNG (Excel y CSV cuando la importación está activada)
Tamaño
3 MB en la petición, 10 MB y 10 páginas por subida
Lote
20 facturas como máximo
Límites por defecto
30 llamadas por minuto, 50 conversiones por día y por conexión (ajustables)
Enlaces de descarga
15 minutos, un solo uso
Conservación
archivos eliminados en las 2 horas siguientes a la descarga, 25 horas como máximo

Seguridad

Tú tienes el control

Tú autorizas cada aplicación

El inicio de sesión pasa por una pantalla de Factusur que muestra la aplicación, su dirección de retorno y los permisos que solicita. Puedes rechazarla y desconectarla de tu cuenta en cualquier momento.

El agente nunca paga

Ninguna herramienta puede pagar, cambiar tu plan ni eliminar tus datos. Cuando se alcanza la cuota, el agente te muestra un enlace: pagas tú, en tu navegador.

Acceso limitado y revocable

Tokens de corta duración, claves de acceso con fecha de caducidad y los permisos que elijas, límites de llamadas ajustables: un agente atrapado en un bucle no puede agotar tu cuota.

Tus facturas no se quedan

Las mismas reglas que en la web: archivos eliminados en las 2 horas siguientes a la descarga, 25 horas como máximo. El registro de actividad no contiene el contenido de las facturas.

La seguridad del servidor MCP en detalle

Preguntas frecuentes

¿Qué es un servidor MCP?

El Model Context Protocol (MCP) es un estándar abierto que permite a un asistente de IA (Claude, Cursor, VS Code, Codex…) usar herramientas externas. El servidor MCP de Factusur le da acceso a la conversión y la comprobación de facturas Factur-X.

¿Necesito una cuenta de Factusur?

Sí: basta con una cuenta gratuita (5 conversiones al mes). Inicias sesión una vez, desde tu navegador; también puedes crear una clave de acceso en tu cuenta.

¿Cuánto cuesta una conversión a través del agente?

Exactamente lo mismo que en la web: cada Factur-X conforme desbloqueado cuenta una conversión de tu plan. Comprobar un Factur-X no cuenta nada.

¿Puede el agente pagar o cambiar mi plan?

No. Cuando se alcanza tu cuota, el agente recibe un mensaje con un enlace a la página de pago: solo tú puedes abrirlo, iniciar sesión y confirmar.

¿Factusur envía mis facturas?

No. Factusur no es una plataforma autorizada (plateforme agréée, PA) y no transmite tus facturas: crea un archivo Factur-X a partir de los datos de la factura, que descargas tú o tu agente.

¿Qué pasa con mis archivos?

Se aplican las mismas reglas que en la web: el original se elimina en cuanto se genera el Factur-X, y el Factur-X como mucho 2 horas después de la primera descarga y 25 horas después de la subida.

¿OAuth o clave de acceso?

OAuth cuando tu herramienta lo admite (Claude, Cursor, VS Code, Codex): no hay nada que copiar, autorizas en el navegador. Una clave de acceso es adecuada para scripts, CI o herramientas sin OAuth; se muestra una sola vez y se puede revocar con un clic.

¿Es oficial el servidor MCP?

El servidor lo publica Factusur y sigue la especificación abierta de MCP. No es un producto de Anthropic, OpenAI, Cursor ni Microsoft.

Solución de problemas

“401” o “authentication required”

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.

Eres el único responsable del contenido de tus facturas y de que cumplan las normas de facturación.

MCP (Model Context Protocol) es una especificación abierta. Factusur no está afiliado a Anthropic, OpenAI, Cursor ni Microsoft; los nombres citados pertenecen a sus propietarios.