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.
- sk_test emite en un ambiente de pruebas, sin valor tributario, y sk_live emite de verdad. Cada respuesta te dice en cuál quedó, en ambiente y livemode.
- 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 no incluye el canal de IA (tampoco los planes Básico y Folios, que ya no se venden).
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 prefijo de la llave separa un documento de prueba de uno real, y cada respuesta te confirma en qué ambiente quedó (campos ambiente y livemode):
sk_test_…
Pruebas. 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 Personalización → Conectores → Agregar → Agregar conector personalizado, escribe un nombre y pega esta dirección:
https://mcp.facturador.pulsandotech.cl/mcpPresiona Continuar: Claude revisa el servidor y te muestra cómo conectarse. Deja lo que detecta («Iniciar sesión ahora» y «Registrar automáticamente») y presiona Agregar y Conectar. Se abre 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.
- Si en ese paso eliges «Encabezados de solicitud», agrega
Authorizationcon el valorBearer sk_.... También sirvenX-Api-Keyoapi-keycon la llave sola. - Para cambiar la llave, elimina el conector y agrégalo de nuevo: «Desconectar» y «Conectar» vuelven a usar la anterior.
- Claude no deja agregar dos veces la misma dirección: si administras dos empresas, usa una llave de organización, o Claude Code con un servidor por empresa.
- Los conectores no se agregan desde la app del celular, y en un plan Team sólo los propietarios pueden agregarlos.
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) |
| libro_de_guias | El libro de guías de despacho de un mes: guías vigentes y anuladas, la factura de cada una y si el libro firmado está al día |
| 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 |
| enviar_copia_dte | Manda una copia con el PDF de un documento ya emitido a otros correos (pagos, contabilidad de tu cliente), hasta 10. No emite nada ni gasta folio; antes te confirma los correos, porque les escribe a terceros |
| 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 |
| propuesta_f29_sii | La propuesta de F29 que te arma el SII para un mes (remanente del mes anterior, honorarios, PPM y total a pagar). Si el SII no permite consultarla con tu certificado, te lo dice y la revisas en sii.cl |
| sii_credenciales_estado | Te dice si tu empresa conectó su clave tributaria del SII y en qué estado. Nunca muestra la clave. Para conectarla o cambiarla se usa el portal (Contable → Clave tributaria del SII); no se manda por el chat |
| 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 |
| que_me_falta | Qué le falta a tu empresa para que hagamos tus trámites ante el SII (plan pagado, certificado, autorización y datos), con el enlace de cada cosa. Por ahora, sólo en el servidor remoto |
| 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 la llave vaya en Authorization: Bearer sk_... (también sirven X-Api-Key o api-key) |
| 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 Personalización → Conectores → Agregar → Agregar conector personalizado, escribe un nombre y pega la dirección https://mcp.facturador.pulsandotech.cl/mcp. Presiona Continuar, deja lo que Claude detecta y presiona Agregar y Conectar: se abre 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í. Una llave sk_test emite en un ambiente de pruebas y los documentos no tienen validez tributaria; una llave sk_live emite documentos reales ante el SII. Cuál ambiente de pruebas (la certificación del SII o uno simulado) depende de tu empresa, y cada respuesta te lo dice en ambiente y livemode. 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.