Ir al contenido
Factusur

Guía de instalación · Claude Code

Convierte facturas a Factur-X desde Claude Code

Añade Factusur a Claude Code con un comando, conecta tu cuenta y convierte tus facturas PDF a Factur-X desde el terminal.

Instalar Factusur en Claude Code

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.

Qué pedirle a Claude Code

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.”
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.

  • “¿Cuántas conversiones me quedan este mes?”
Todas las herramientas del servidor MCP

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.

Acceso, datos y pago: seguridad del servidor MCP.

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.