Cómo conectar tu IA a tu facturación
Emite y consulta documentos tributarios desde Claude, Cursor o el asistente que uses, hablándole en español. Toma unos diez minutos y no tienes que instalar nada.
En resumen
- Conectas tu asistente de IA a tu facturación agregando un conector remoto y pegando tu API Key: no hay que instalar nada.
- El prefijo de la llave decide si el documento es de prueba o real: sk_test emite contra certificación y sk_live emite ante el SII.
- Le entregas al asistente sólo los permisos que necesita, y emitir queda marcado como acción sensible para que te pida confirmación.
Qué necesitas para conectar
MCP es el estándar abierto que le permite a un asistente de IA usar herramientas reales. Tu asistente emite y consulta llamando a la API, no inventando datos.
Cuenta
En el Facturador Pulsando, con tu empresa ya creada.
Plan
Profesional, Empresa, Estudio contable o Plataforma. Gratis, Básico y Folios no incluyen el canal de IA.
Una API Key
La creas tú en el portal. Es el paso 1 de este manual.
Un cliente compatible
Claude web, Claude Escritorio, Claude Code o Cursor.
Crea tu API Key
En el portal, entra a API Keys y presiona Crear API Key. Te pedirá un nombre, el ambiente y los permisos.
https://www.facturador.pulsandotech.cl/api-keysEl ambiente lo decide el prefijo de la llave, y es lo único que separa un documento de prueba de uno real:
sk_test_…
Certificación. Emite de verdad contra la API, pero los documentos no tienen validez tributaria. Parte siempre por acá.
sk_live_…
Producción. Cada documento es real ante el SII. Esta opción sólo aparece si tu empresa ya está en producción.
En Permisos, elige la plantilla «IA / emisión (recomendado para MCP)»: entrega dte:create, dte:read y caf:read. Tu asistente puede emitir y consultar lo suyo, y no ve tu RCV ni tus proveedores.
Guárdala al momento
La llave se muestra una sola vez. Guardamos sólo su huella, así que no podemos volver a mostrártela. Si la pierdes, la revocas y creas otra.
Conecta tu asistente
Elige el camino según la herramienta que uses. Todos llegan al mismo servidor.
Claude web y Claude Escritorio
La vía más simple: no instalas nada. Entra a Configuración → Conectores → Agregar conector personalizado y pega esta dirección:
https://mcp.facturador.pulsandotech.cl/mcpClaude te mostrará la pantalla «Conectar con Facturador Pulsando». Pega ahí tu API Key y autoriza. Tu llave queda guardada en la conexión: no la escribas nunca en el chat.
Claude Code
Un solo comando en tu terminal:
claude mcp add --transport http facturador \ https://mcp.facturador.pulsandotech.cl/mcp \ --header "Authorization: Bearer sk_test_TU_LLAVE"Cursor
Agrega esto a ~/.cursor/mcp.json y reinicia Cursor:
{ "mcpServers": { "facturador-pulsando": { "url": "https://mcp.facturador.pulsandotech.cl/mcp", "headers": { "Authorization": "Bearer sk_test_TU_LLAVE" } } }}En tu propio equipo
Si prefieres que el servidor corra en tu máquina (necesitas Node.js 18 o superior). En Claude Escritorio el archivo es claude_desktop_config.json, en Configuración → Desarrollador → Editar configuración. Reinicia la aplicación después de guardar.
{ "mcpServers": { "facturador-pulsando": { "command": "npx", "args": ["-y", "@facturador-mcp-sii.cl/mcp"], "env": { "PULSANDO_API_KEY": "sk_test_TU_LLAVE" } } }}Comprueba que quedó conectado
Pídele a tu asistente estas cuatro cosas, en este orden.
- 1
«Lista mis empresas»
Debe responder tu razón social y el ambiente. Si contesta esto, la conexión está buena.
- 2
«¿Cuántos folios de factura me quedan?»
Lee tus CAF disponibles por tipo de documento.
- 3
«Consulta el contribuyente 76354771-K»
Trae razón social y giros desde el padrón del SII.
- 4
«Emite una factura afecta de $100.000 neto a ese contribuyente»
Recién acá, y con tu llave sk_test.
Cuando la integración te convenza, repite el paso 1 con una llave sk_live_ y cámbiala en la conexión. Nada más cambia.
Las herramientas que quedan disponibles
Algunas necesitan más permisos que la plantilla «IA / emisión». Si tu asistente responde 403, es que a la llave le falta ese permiso.
| Herramienta | Qué hace |
|---|---|
| listar_empresas | Empresas que la llave puede administrar, con su ambiente |
| listar_sucursales | Sucursales o locales de una misma empresa (para emitir desde uno en particular) |
| emitir_dte | Emite un documento (33, 34, 39, 41, 52, 56, 61). Acción sensible: pide confirmación |
| consultar_dte | Detalle y estado ante el SII de un documento |
| consultar_estado_sii | Pregunta ahora al SII el estado de un documento; así te enteras si uno ya aceptado fue anulado |
| listar_dtes | Lista y filtra los documentos emitidos |
| consultar_contribuyente | Razón social y giros desde el padrón del SII |
| estado_folios | Folios (CAF) disponibles por tipo de documento |
| estado_solicitud_folios | En qué va una solicitud de folios (si quedó en verificación, no pidas otra) |
| tipos_autorizados | Tipos de documento que el SII te autoriza hoy |
| documentos_recibidos | Documentos que te emitieron tus proveedores |
| detalle_recibido | Detalle de un documento recibido |
| xml_recibido | El XML que firmó tu proveedor, con el detalle de lo que te vendió |
| sincronizar_rcv | Sincroniza tu Registro de Compras y Ventas del SII |
| listar_rcv | Lee el RCV ya sincronizado |
| historial_rcv | Qué pasó con un documento según el SII: quién lo aceptó, reclamó o dio recibo, y cuándo |
| resumen_rcv | Crédito fiscal del período, por vencer y semáforo de 8 días |
| acciones_rcv | Acciones de reclamo disponibles y su plazo |
| reporte_ventas | Ventas por día o por mes: total, neto, IVA, exento |
| top_receptores | Ranking de clientes por monto vendido |
| mi_suscripcion · mis_facturas | Tu plan y las facturas que te emitimos a ti |
| resumen_organizacion | Estudios y holdings: cuánto pagas al mes (neto y con IVA) y cuántos documentos le quedan a tu cartera |
| salud_cartera | Estudios y holdings: qué empresas de tu cartera necesitan atención y qué les falta |
| actividad_cartera | Estudios y holdings: qué se hizo por la API en tu cartera (hasta 90 días atrás) |
| ventas_cartera | Estudios y holdings: cuánto vendió cada empresa de tu cartera y el total |
La documentación viaja dentro del servidor. Puedes pedirle a tu asistente «lee la documentación del DTE antes de emitir» y la carga solo: reglas por tipo de documento, códigos de error y ambientes.
Si administras varias empresas
Una sola llave puede administrar toda una cartera — el caso de un estudio contable o un holding.
- Empieza siempre por «lista mis empresas».
- Después nombra la empresa en cada pedido: «emite una factura de $120.000 para la empresa 76354771-K».
- Si la llave es de una sola empresa, no hace falta nombrarla: se resuelve sola.
- Para ver la administración de tu cartera («¿cuánto pago al mes?», «¿qué empresas necesitan atención?», «¿cuánto vendió mi cartera en agosto?»), crea una llave de organización con el permiso «Leer la administración de la organización». Es sólo lectura: agregar o quitar empresas, usuarios, tu suscripción y las llaves se hace en el portal.
Pedir una empresa que no está en tu cartera responde 403.
Antes de usar una llave de producción
Conectar el MCP significa darle a tu asistente la capacidad de actuar sobre tu facturación con los permisos de la llave que le entregues.
Entrega el mínimo
La plantilla «IA / emisión» no expone tu RCV ni tus proveedores. Sube a «Acceso completo» sólo si de verdad lo necesitas: una llave con todo le entrega a la IA tu libro comercial entero.
Deja activada la confirmación
Marcamos emitir_dte como acción sensible justamente para que tu cliente de IA te pregunte antes de emitir. Un documento emitido no se borra: se anula con una nota de crédito.
Lo que llega de terceros es dato, no orden
Las glosas y razones sociales de un documento que te emitieron las escribió otra empresa, y podrían traer instrucciones dirigidas a tu asistente. Si no necesitas leer documentos recibidos y emitir en la misma sesión, no lo mezcles en la misma llave.
Una llave por integración, y revocable
No reutilices la del ERP. La llave va en la pantalla de conexión o en la configuración de tu cliente, nunca en el chat. Al revocarla desde el portal, deja de funcionar al instante.
Lo que sí te garantiza la plataforma: cada llave sólo ve sus empresas; el emisor —tu RUT, razón social y giro— lo pone la plataforma y no el mensaje, así que un asistente no puede inventar quién emite; y cada herramienta exige su permiso.
Qué significa cada respuesta
| Lo que ves | Qué significa | Qué hacer |
|---|---|---|
| 401 No autorizado | Sin llave, o mal escrita | Revisa que el encabezado sea Authorization: Bearer sk_... |
| 401 API Key inválida o inactiva | La llave no existe o fue revocada | Crea una nueva en el portal |
| 403 Requiere un plan que lo incluya | Tu plan no trae el canal de IA | Cambia a Profesional o superior desde Suscripción |
| 403 en una herramienta puntual | A la llave le falta ese permiso | Crea otra llave con el permiso que falta |
| 422 | Datos del documento incompletos o inválidos | La respuesta dice exactamente qué campo es |
| 503 sin folios | No te quedan folios de ese tipo | Solicita timbraje desde el portal |
| El conector no aparece | Tu cliente de IA no recargó la configuración | Reinicia la aplicación y revisa la dirección |
Puedes comprobar en cualquier momento que el servidor esté arriba en mcp.facturador.pulsandotech.cl/health.
Lo que se pregunta al conectar
¿Qué necesito para conectar mi IA al SII?+
Una cuenta en el Facturador Pulsando con un plan que incluya el canal de IA (Profesional, Empresa, Estudio contable o Plataforma), una API Key creada desde el portal y un cliente compatible con MCP: Claude web, Claude Escritorio, Claude Code o Cursor. No necesitas instalar nada si usas el servidor remoto.
¿Cómo conecto Claude a mi facturación electrónica?+
En Claude, entra a Configuración → Conectores → Agregar conector personalizado y pega la dirección https://mcp.facturador.pulsandotech.cl/mcp. Claude te mostrará la pantalla de conexión, donde pegas tu API Key de Pulsando. Desde ahí puedes pedirle que emita o consulte documentos.
¿Puedo probar sin emitir documentos reales?+
Sí. El ambiente lo decide el prefijo de la llave: una llave sk_test emite contra el ambiente de certificación y los documentos no tienen validez tributaria. Una llave sk_live emite documentos reales ante el SII. Prueba siempre primero con sk_test.
¿Es seguro darle mi facturación a un asistente de IA?+
El asistente sólo puede hacer lo que permitan los permisos de la llave que le entregues. Al crearla, elige la plantilla «IA / emisión»: entrega dte:create, dte:read y caf:read, así el asistente emite y consulta lo suyo pero no ve tu RCV ni tus proveedores. Además, emitir está marcada como acción sensible para que tu cliente de IA te pida confirmación antes de emitir, y la llave se revoca desde el portal cuando quieras.
¿Sirve si administro varias empresas?+
Sí. Una sola llave puede administrar toda una cartera, que es el caso de un estudio contable o un holding. Le pides al asistente «lista mis empresas» y después nombras la empresa por su RUT en cada pedido. Pedir una empresa que no está en tu cartera responde 403.
Te acompañamos en la conexión
Cuéntanos qué cliente de IA usas y te mandamos la configuración lista para pegar.