Ir al contenido
Factusur

Guía de instalación · VS Code (Copilot)

Convierte facturas a Factur-X desde VS Code

Instala el servidor MCP de Factusur en VS Code con un clic o mediante .vscode/mcp.json y convierte tus facturas con Copilot en modo Agent.

Instalar Factusur en VS Code (Copilot)

Un clic en “Install in VS Code”, un comando o un archivo de configuración.

Instalar en VS CodeAbre VS Code (Copilot) con la configuración ya rellenada.
  1. Paso 1: Haz clic en “Install in VS Code” o ejecuta el comando code --add-mcp de abajo.
  2. Paso 2: Inicia el servidor factusur (vista MCP o archivo de configuración): VS Code te propone iniciar sesión y se abre la página de Factusur.
  3. Paso 3: En el chat de Copilot, en modo Agent, pide: “Convierte invoice.pdf a Factur-X con Factusur”.
Terminal
code --add-mcp '{"name":"factusur","type":"http","url":"https://factusur.com/mcp"}'

.vscode/mcp.json
{
  "servers": {
    "factusur": {
      "type": "http",
      "url": "https://factusur.com/mcp"
    }
  }
}

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.

.vscode/mcp.json con una clave de acceso
{
  "inputs": [
    {
      "type": "promptString",
      "id": "factusur-key",
      "description": "Clave de acceso de Factusur",
      "password": true
    }
  ],
  "servers": {
    "factusur": {
      "type": "http",
      "url": "https://factusur.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:factusur-key}"
      }
    }
  }
}

VS Code pide la clave en el primer inicio y la guarda en su almacén de secretos: no se escribe en el archivo.

Inicio de sesión: OAuth (registro automático del cliente) o una clave de acceso introducida en VS Code. Fuente: Documentación de VS Code (configuración MCP) (se abre en una pestaña nueva), comprobada el 26 de octubre de 2026.

Qué pedirle a VS Code (Copilot)

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.