Agentes MCP

Hay cuatro servidores en mcp.facturalo.pe. Cada petición lleva tu token en Authorization: el servidor no guarda ningún token. Todos validan con las reglas oficiales de SUNAT antes de emitir y están incluidos en todos los planes.

Para qué

• Emitir facturas y boletas en lenguaje natural: buscar al cliente por RUC o DNI, ver la vista previa y confirmar.
• Dejar que tu agente de IA (ventas, atención) facture solo, dentro de los límites que fijas.
• Integrar la API sin inventar campos: payloads oficiales, código con el SDK y handler del webhook.
• Saber por qué SUNAT rechazó un comprobante, qué campo corregir y qué pasó con cada petición.

Conectar

Copia la config de tu cliente y pon tu token (console.facturalo.pe → Empresa → API keys). sk_test_… emite en demo, sin afectar SUNAT; sk_live_… emite comprobantes reales.

Cursor

Copiar config

VS Code

Copiar config

Claude Code

Copiar cmd

Windsurf

Copiar config

CursorVS CodeClaude CodeWindsurf

Instala los agentes que necesites con un clic y luego edita mcp.json para poner tu token.

• Añadir Integration a Cursor
• Añadir Troubleshooter a Cursor
• Añadir Billing a Cursor

~/.cursor/mcp.jsonjson

{
  "mcpServers": {
    "facturalo-integration": {
      "url": "https://mcp.facturalo.pe/integration",
      "headers": {
        "Authorization": "Bearer sk_test_…"
      }
    },
    "facturalo-troubleshooter": {
      "url": "https://mcp.facturalo.pe/troubleshooter",
      "headers": {
        "Authorization": "Bearer sk_test_…"
      }
    }
  }
}

Billing: factura conversando

Busca al cliente, arma el comprobante (RUC → factura, DNI o sin documento → boleta), lo valida con las reglas de SUNAT y te muestra la vista previa con totales. Solo emite cuando confirmas; el modelo no puede saltarse ese paso. Cada emisión lleva una clave de idempotencia: un reintento nunca crea otro comprobante.

Billing automático: para agentes de IA

Para un agente que vende o atiende y factura sin intervención. Agrega emit_document (emite en un paso, con idempotency_key obligatoria). El operador fija los límites en los headers de la conexión; el modo lo fija el servidor y un header no puede cambiarlo. Producción queda apagada hasta que la habilitas.

{
  "mcpServers": {
    "facturalo-auto": {
      "url": "https://mcp.facturalo.pe/billing-auto",
      "headers": {
        "Authorization": "Bearer sk_live_…",
        "X-Facturalo-Permitir-Live": "true",
        "X-Facturalo-Max-Total": "2000",
        "X-Facturalo-Max-Por-Dia": "200",
        "X-Facturalo-Series": "F001,B001"
      }
    }
  }
}

Tools — Integration

Tools — Troubleshooter

Solo observa: no emite, no anula ni reenvía. Pega una serie-número (F001-120) o un request id (req_…).

Búsqueda en la documentación

search_docs entiende preguntas en lenguaje natural y también términos exactos (sunatTransaccion, 3103, documento.sunat.respuesta). Combina significado y palabras clave sobre esta documentación, que se reindexa sola cada 15 minutos. Si la búsqueda semántica no responde, el agente busca por palabras sin que lo notes.

Siguiente

• Guía rápida — tu primera factura con la API
• Autenticación — sk_test_… y sk_live_…
• Request ID — la traza que usa el Troubleshooter
• Validar (sin emitir) — las reglas de SUNAT que aplican los agentes
• SDKs — Node, PHP y Python en tu backend