Conectar agentes por MCP

El servidor MCP conecta agentes a las mismas operaciones fiscales de la API. La conexión OAuth identifica a la persona; la autorización en Bigu determina el negocio y los permisos. No compartas claves API en una conversación.

Conexión

El endpoint de producción es https://bigu.ai/mcp. El endpoint de desarrollo es https://dev.bigu.ai/mcp; sus credenciales y datos están separados. Comprobá la dirección que ofrece Facturación y elegí el entorno donde está preparado tu emisor.

Agregá el endpoint como conector MCP remoto en tu cliente. Ingresá con tu cuenta de Bigu. En la autorización, comprobá el nombre de la aplicación y su dirección de regreso, elegí el negocio del que sos propietario y los permisos concretos. Podés autorizar consultas, preparación, emisión, entrega, cobros y reglas por separado. Rechazar vuelve al cliente sin crear una autorización fiscal nueva.

Si una conexión existente responde connection_required, su enlace a Agentes conectados permite revisar el negocio y autorizar nuevamente ese identificador. Las reglas existentes siguen perteneciendo al negocio: pausarlas es una acción distinta de desconectar el agente.

La disponibilidad del alta de conectores y las confirmaciones de escritura las determina cada cliente. Consultá las instrucciones actuales de ChatGPT y Claude.

Autorizar el negocio en la conexión

La pantalla Conectar identifica la aplicación y la cuenta con la que ingresaste. Revisá Identificador de la aplicación y Ver dirección completa de regreso si necesitás comprobar quién solicita acceso.

1. En Negocio, elegí el negocio del que sos propietario. Si no aparece ninguno, esa cuenta no puede otorgar la autorización.
2. Marcá los permisos fiscales que necesita el agente. Consulta no implica permiso para emitir, registrar cobros ni activar reglas.
3. Revisá también el acceso a tu identidad informado por Clerk.
4. Elegí Autorizar conexión para guardar la autorización del negocio y volver al cliente. Rechazar vuelve sin crear una autorización fiscal nueva.

Si la solicitud pide permisos de identidad no admitidos o Bigu no puede verificar la aplicación y su regreso, el formulario no permite autorizarla. Volvé al cliente e iniciá una conexión válida. Cada operación posterior comprueba que conserves acceso al negocio.

Recuperar una autorización pendiente

Si el cliente informa connection_required, abrí su enlace a Agentes conectados. Comprobá el Negocio, el Cliente OAuth y los permisos de la conexión antes de elegir Autorizar estos permisos.

Esperá Conexión autorizada. Volvé al agente para continuar. y regresá al cliente para retomar la operación. El identificador viene en el enlace de conexión: abrir esta página sin esa solicitud permite consultar las conexiones existentes, pero no inventa una conexión nueva.

Operaciones

Herramienta	Resultado
fiscal_capabilities	Negocio, permisos y operaciones disponibles
fiscal_emitter	Habilitación actual y requisitos pendientes
fiscal_documents	Búsqueda de pedidos con paginación
fiscal_document	Estado fiscal actual por identificador
fiscal_issue	Emisión con identidad estable y reintentos sin duplicados
fiscal_file	PDF o XML firmado como recurso embebido
fiscal_drafts	Borradores recuperables con cursor
fiscal_delivery_send / fiscal_delivery_get	Envío y seguimiento de PDF/XML
fiscal_payment_record / fiscal_document_balance	Cobros parciales y saldo por comprobante
fiscal_summary_export	Resumen paginado por moneda e impuesto
fiscal_rule_create / fiscal_rule_status	Autorización, pausa y reanudación de recurrencias
fiscal_rules / fiscal_occurrences	Programación y progreso de cada ocurrencia

La emisión requiere autorización explícita y acceso vigente de propietario. Los pedidos pendientes, observados o en duda no se deben presentar como aceptados. Consultá la guía API para importes, monedas, referencias, estados y recuperación.

Revocar y reconectar

Desde Facturación → Agentes conectados, localizá el cliente por su identificador, permisos y estado Activa. Elegí Revocar conexión y comprobá Conexión revocada. Bigu rechaza sus siguientes operaciones, incluso si el token OAuth aún no venció. Para reconectar al mismo negocio, volvé a autorizar el cliente; se conserva el registro de la autorización revocada. Un cliente ya vinculado no puede cambiar silenciosamente a otro negocio. Revocar la conexión no pausa las reglas automáticas que ya autorizaste; pausalas por separado si deben detenerse. El propietario puede retirar este acceso aunque el negocio ya no pueda operar nuevas emisiones.

Preparar antes de emitir

También están disponibles fiscal_draft_get, fiscal_draft_save, fiscal_draft_validate y fiscal_draft_issue. Conservá un UUID estable desde el primer guardado. Usá revisión 0 para crear y la revisión devuelta para editar. Cada edición invalida la validación previa.

La validación devuelve bases, IVA y total en centésimos con el motor fiscal de Bigu. La emisión requiere esa revisión validada y congela el contenido. Ante una respuesta perdida, consultá fiscal_document con external_id: draft_UUID y recuperá el mismo envío. Nunca cambies la identidad para resolver un estado incierto.

Los pasos y formatos completos están en Borradores y revisión fiscal.

Clientes y conceptos

Usá fiscal_customers_search y fiscal_concepts_search antes de preparar un borrador. fiscal_customer_save y fiscal_concept_save guardan con un UUID estable y requieren fiscal:prepare. La guía del catálogo explica recuperación, precios y límites.