MCP (asistentes de IA)

El MCP (Model Context Protocol) es un estándar para que un asistente de IA use herramientas externas. Con Comprobado podés pedirle a Claude, Cursor o VS Code: «Facturale $15.000 por la clase de hoy a Pérez», y el asistente arma el comprobante, te lo muestra y emite cuando confirmás.

La facturación masiva (lotes de muchos comprobantes) no está disponible por el MCP: se hace desde la consola o con la API.

Qué protege

El asistente solo puede emitir un comprobante que antes previsualizó (recibe un previewId válido 10 minutos) y no puede cambiarlo después.
Solo entra con una clave de tipo MCP: las claves de API no sirven acá (ni las MCP en la API). Emitir además exige que tu plan permita la emisión por MCP.
Respeta la suite, el estado de tu cuenta y tu cupo mensual, igual que la API.
Es idempotente: repetir el mismo previewId no factura dos veces.

Mientras pruebes, dejá la cuenta en homologación.

El asistente dentro de la consola

Si tu plan incluye el asistente, la consola trae el botón Asistente en la barra superior: un chat con IA, con las mismas herramientas y vistas del MCP, sin salir de Comprobado. No tenés que crear ninguna clave: al abrirlo la consola crea una clave MCP propia de tu sesión (dura 2 horas, tiene tus permisos o menos y no aparece en Claves) y la revoca al cerrar sesión. Emitir funciona igual que con cualquier asistente: primero una vista previa y vos confirmás con el botón. Lo que emite respeta tu ambiente, tu cupo y tus permisos.

Además de hacer cosas, el asistente te lleva por la app: si lo que preguntás se hace en una pantalla (cargar el certificado, invitar a una persona, crear una clave, subir un lote…), te explica en pocas palabras qué vas a encontrar y te pasa un enlace que abre esa pantalla sin cerrar el chat. Solo te lleva a pantallas de tu consola, y si tu plan no incluye lo que pedís, te lo dice en vez de mandarte a una pantalla bloqueada.

Conectarlo

En Integraciones → MCP creá una clave (de tipo MCP; no sirve una clave de API).
Copiá la configuración de tu cliente (la consola la arma con la dirección de tu servidor).

# Claude Code
claude mcp add --transport http comprobado https://TU-DOMINIO/mcp \
  --header "Authorization: Bearer ask_live_XXXXXXXX"

Para Claude Desktop se usa npx mcp-remote; para VS Code o Cursor, un mcp.json con la clave como entrada protegida. La consola te da el texto exacto de cada uno.

Herramientas

Herramienta	Qué hace
`estado_contribuyente`	Tus datos, condición IVA y ambiente
`consultar_contribuyente`	Busca el CUIT de un cliente en el padrón de ARCA: razón social, condición frente al IVA y avisos (inactiva, limitada…)
`estado_fce`	Estado de las Facturas de Crédito Electrónica emitidas o recibidas: aceptadas, rechazadas (con los motivos del comprador), pendientes. Solo lectura
`consultar_obligacion_fce`	Dice si un cliente está obligado a recibir Factura de Crédito Electrónica y desde qué importe
`catalogo_tributos`	Tipos de percepción y tributo de ARCA para el bloque `tributos` del comprobante
`previsualizar_comprobante`	Valida y calcula sin pedir CAE
`emitir_comprobante`	Emite lo previsualizado (irreversible). No marca cobros: si ya te pagaron, lo marcás en la consola o por la API
`consultar_comprobante`	Estado de un comprobante
`listar_comprobantes`	Comprobantes con filtros y paginado; incluye los emitidos fuera de Comprobado (`origen`) y el estado de cobro (`cobro=adeudada` o `parcial` = lo que te deben) y lo ya cobrado (`cobrado`). Por defecto muestra el ambiente actual de tu cuenta (`ambiente=todos` para mezclar) y se puede ordenar (`orden=-total`)
`ultimo_numero`	Último número autorizado por ARCA
`catalogo_exportacion`	Códigos de ARCA para una factura E (países, monedas, Incoterms…)
`cotizacion_exportacion`	Cotización oficial de ARCA para una moneda
`explicar_error`	Explica en lenguaje claro un código de error de Comprobado o de ARCA
`resumen_ventas`	Ventas del período (facturado, notas de crédito, neto, por tipo y origen), ya calculadas
`iva_debito`	IVA débito del mes por alícuota, con las notas de crédito restando
`control_monotributo`	Solo monotributistas: lo facturado en 12 meses contra el tope de tu categoría (porcentaje, margen, categoría que correspondería, cuota, cierre de la última recategorización, mes a mes), ya calculado. Una tabla de categorías futura se muestra aparte y no rige hasta su fecha
`posicion_iva`	Posición de IVA del mes ya calculada: débito por alícuota (no gravado y exento aparte), crédito de las compras importadas, retenciones y percepciones de IVA sufridas, saldo técnico anterior y saldo (a pagar / a favor). No es la declaración jurada
`libro_iva`	Libro IVA Ventas o Compras del mes (`libro` = ventas · compras), hasta 300 renglones; el completo se baja en CSV
`listar_retenciones`	Retenciones y percepciones sufridas (IVA, Ganancias, IIBB, SUSS) con totales por impuesto y tipo ya calculados; filtros desde, hasta, impuesto
`resumen_del_mes`	El resumen del mes de hoy: un texto corto y las cifras calculadas por el sistema (facturado neto, contra el mes anterior, deuda de más de 30 días, monotributo). Si todavía no hay uno de hoy se genera en el momento. Solo si tu plan incluye el resumen del mes
`resumenes_anteriores`	Los últimos 10 resúmenes guardados, del más nuevo al más viejo
`control_numeracion`	Huecos de numeración por punto de venta y tipo; con `arca=true`, cuántos números autorizó ARCA después del último guardado (emitidos fuera sin traer)
`preparar_nota_credito`	Arma la nota de crédito que anula un comprobante (no emite: te pide confirmación)
`listar_proveedores`	Tus proveedores con lo que les debés (saldo ya calculado), pendientes y vencidos
`listar_comprobantes_recibidos`	Lo que te facturaron, con su estado de pago y los vencidos
`leer_factura_proveedor`	Lee con IA la foto o el PDF de la factura de un proveedor (con sus líneas) para que la revises; abre una vista donde elegís el archivo. No guarda nada: cargarla es desde la consola
`ver_notas`	Las notas del equipo sobre un comprobante, un recibido o un proveedor
`puntos_de_venta`	Tus puntos de venta (el número de ARCA y el nombre que les pusiste), para que el asistente elija uno real al armar una factura
`secciones_de_la_app`	El enlace a la pantalla de la consola donde se hace lo que preguntás («cargar el certificado», «invitar a mi contador»), con una explicación de qué vas a encontrar

Ambiente: el MCP usa el ambiente de tu cuenta. Si volvés a homologación desde la consola para probar la integración, lo que emita el asistente es de pruebas (sin validez fiscal) y queda marcado. El asistente no puede cambiar de ambiente: eso solo se hace desde la consola.

Facturale a un cliente con solo su CUIT

Si le decís al asistente «facturale 50.000 a la empresa 30-71234567-8», usa consultar_contribuyente para traer del padrón de ARCA la razón social y la condición frente al IVA del cliente (por eso sabe si corresponde Factura A o B) y te las muestra en la vista previa. La condición se deduce de los impuestos que el cliente tiene inscriptos: si no es lo que esperabas, corregísela antes de confirmar.

Para que funcione, tu certificado tiene que estar autorizado en ARCA para el servicio «Consulta de Constancia de Inscripción» (ws_sr_constancia_inscripcion), que es aparte del de facturación: ver Conectar con ARCA. Si no lo está, el asistente te lo dice (error AS-1023) y te pide los datos del cliente a mano.

El asistente también te avisa si ARCA marca la CUIT del cliente como inactiva, limitada, cancelada, de un titular fallecido o no confiable (alertas): ARCA puede rechazar la factura, y la decisión de seguir es tuya. Si ARCA no informó su situación frente al IVA, te la pregunta.

Facturas a grandes empresas (FCE)

Si el cliente es una Gran Empresa y el importe es alto, el asistente usa consultar_obligacion_fce para saber si corresponde Factura de Crédito Electrónica y, si es así, arma el comprobante con el bloque fce (tu CBU sale de los datos fiscales; el asistente te pide la forma de transmisión y el vencimiento de pago). Una nota de anulación solo la acepta ARCA si el comprador ya rechazó la factura. Si tu certificado no está autorizado para esa consulta (AS-1026), seguís igual: ARCA te avisa al emitir una factura común.

Pedile cuentas y explicaciones

El asistente también puede leer y explicar, sin emitir nada: «¿cuánto facturé este mes?», «¿cuánto IVA débito llevo en octubre?», «¿qué significa el error 10016?», «anulá la factura de Pérez» (arma la nota de crédito y te la muestra antes de emitir).

Las cifras las calcula Comprobado, no el asistente. resumen_ventas e iva_debito devuelven totales ya sumados y redondeados; el asistente los cita tal cual. Son información de gestión, no una declaración fiscal: confirmalas con tu contador.

También sabe de compras y cobros: «¿qué facturas me deben todavía?» (incluye las que pagaron en parte y cuánto falta), «¿a qué proveedores les debo y qué venció?», «¿qué notas hay sobre Proveedor SA?». En producción el asistente solo ve lo real: lo que se cargó en homologación o simulado no aparece ni se suma. Solo lee: marcar algo como cobrado o pagado, importar comprobantes recibidos y escribir notas se hace en la consola. Si tu clave MCP es anterior a esta función, creá una nueva.

Tu cliente puede ofrecerte además tres atajos (prompts): facturar, anular y cierre del mes.

Vistas dentro de la conversación

En los clientes que soportan MCP Apps, las respuestas del asistente vienen con una vista en lugar de solo texto: la vista previa del comprobante, el comprobante emitido con su CAE, el libro de comprobantes (con lo cobrado y lo adeudado), el resumen de ventas y de IVA, la ficha del contribuyente, los datos de un CUIT en el padrón (con sus alertas), el estado de tus Facturas de Crédito Electrónica, tus proveedores y comprobantes recibidos con lo que debés, y la explicación de un error. Tienen el mismo estilo que la consola y se adaptan al modo claro u oscuro.

Desde la vista previa podés emitir con un botón. Te pide una segunda confirmación y emite exactamente lo que estás viendo, con tu clave MCP y las mismas reglas de siempre (cuota, estado de la cuenta, ambiente).
Si tu cliente no las muestra, no pasa nada: el asistente responde con texto como siempre.
Las vistas no se conectan a internet: solo hablan con el asistente.

Flujo recomendado

El asistente llama estado_contribuyente.
Arma el pedido y llama previsualizar_comprobante.
Te muestra el resumen y te pide confirmación.
Con tu «sí», llama emitir_comprobante.

Para anular, pedile una nota de crédito que referencie el comprobante.

Si algo falla

Los errores llegan al asistente con la explicación (humano) y el detalle de ARCA, así puede contártelos en lenguaje natural. Un 401 significa clave revocada; un 403 con AS-2022, que usaste una clave de API (hace falta una de MCP); un error de cupo, que agotaste el mes.