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