Defijo en su agente de IA

Qué es

Defijo es un programa para emitir facturas electrónicas ante Hacienda en Costa Rica. El conector le permite pedirle a Claude o a ChatGPT que prepare facturas, notas y cobros de su negocio y que consulte sus ventas. Usted revisa cada cosa y la emite con un toque.

Esta guía dice «Claude» en la mayoría de los ejemplos; con ChatGPT funciona igual.

Antes de empezar

• Una cuenta de Defijo. Si todavía no tiene su negocio en Defijo, Claude lo crea con usted a partir de su cédula; la llave de Hacienda y su PIN se suben después en la página de Defijo.
• Una cuenta de Claude o de ChatGPT. Los dos conectan Defijo también en el plan gratis.
• Su rol en el negocio decide lo que Claude puede hacer, y Defijo lo revisa en cada llamada. Con un rol que solo puede ver, Claude consulta, pero no prepara facturas.

Cómo conectarlo en Claude

Defijo está en el directorio de conectores de Claude, en todos sus planes, también en el gratis. Los nombres de los menús son los de Claude, tal como los da su documentación en inglés. La interfaz de Claude puede mostrarlos en otro idioma.

1. Abra la página de Defijo en Claude, o en Claude abra Customize, Connectors, Discover y busque Defijo.
2. Toque Connect to Claude. Claude lo lleva a Defijo. Si no tiene la sesión abierta, Defijo le pide entrar primero.
3. Defijo muestra la pantalla «Conectar un agente»: el nombre del agente que pide acceso, la cuenta con la que se conecta, la dirección a la que vuelve el navegador y los permisos que pide. Si usted pertenece a más de un negocio, elija el negocio. Toque Conectar, o No conectar si no lo pidió usted.
4. De vuelta en Claude, el conector queda conectado.

A mano, con la dirección del conector

Si Claude no le ofrece Defijo, agréguelo como conector personalizado (el plan gratis permite uno). La dirección es:

https://defijo.app/api/mcp

1. En Claude abra Customize, luego Connectors, y toque Add custom connector.
2. Escriba la dirección del conector y un nombre, por ejemplo Defijo.
3. Toque Add, y luego Connect. Defijo le pide entrar y le muestra la misma pantalla de arriba.

Cómo conectarlo en ChatGPT

Defijo está en el directorio de complementos de ChatGPT, también para el plan gratis.

1. Abra la página de Defijo en ChatGPT, o busque Defijo en Complementos.
2. Toque Instalar complemento. ChatGPT lo lleva a Defijo: entre, revise los permisos y toque Conectar.
3. En una conversación escriba @Defijo y pida lo que necesita.

A mano, con la dirección del conector

Si su ChatGPT no le ofrece instalarlo (en un ChatGPT de empresa puede que quien lo administra tenga que permitirlo primero):

1. En ChatGPT abra Complementos, toque Agregar y luego Agregar servidor MCP personalizado. Si no ve esa opción, active el modo de desarrollador en la configuración de ChatGPT.
2. Póngale de nombre Defijo, pegue la dirección del conector en URL del servidor y deje la autenticación en OAuth.
3. Marque Entiendo y quiero continuar y toque Crear como complemento.
4. Toque Conectar Defijo. ChatGPT lo lleva a Defijo: entre, revise los permisos y toque Conectar.

Otras formas de conectar Claude

En un plan Team o Enterprise

Quien es Owner de la organización en Claude lo agrega para todos: en la página de Defijo en Claude toca Connect for your team, o lo busca en Organization settings, Connectors. Después cada persona toca Connect to Claude y entra con su propio usuario de Defijo. Si usted no es Owner, Claude le muestra Request para pedírselo a quien administra.

En Claude Code

claude mcp add --transport http defijo https://defijo.app/api/mcp

Luego escriba /mcp dentro de Claude Code y siga el inicio de sesión en el navegador. Si el agente vuelve a un programa de su propio computador, como Claude Code, Defijo se lo advierte en la pantalla de conexión.

Usarlo en una conversación de Claude

En el cuadro de mensaje toque +, luego Connectors, y deje encendido el interruptor del conector. En Customize, Connectors, al elegir el conector puede fijar el permiso de cada herramienta, por ejemplo Blocked para una que no quiere que Claude use.

Qué puede hacer Claude con Defijo

Estos son ejemplos de lo que usted puede escribirle a Claude. No son frases fijas: Claude entiende el pedido con sus palabras.

• Preparar facturas. Una factura suelta, varias a la vez, un tiquete, una factura de compra a un proveedor del extranjero o a un productor agropecuario, o la corrección de una que Hacienda rechazó. También puede abrir y cambiar borradores de factura. Por ejemplo: «Prepare una factura de ₡125.000 a Diamond por consultoría.»
• Anular o ajustar un documento ya emitido. Claude prepara la nota de crédito (anula) o la nota de débito (cobra de más). Por ejemplo: «Anule la factura de Diamond de setiembre.»
• Cobrar. Ver qué le deben, preparar el registro de un pago recibido, preparar recordatorios de cobro y preparar el reenvío de una factura por correo. Por ejemplo: «¿Quién me debe y desde cuándo?», «Juan me pagó la de octubre.», «Recuérdele a los atrasados.»
• Consultar ventas y documentos. Las ventas de un periodo, por cliente si lo pide, buscar un documento emitido, el cierre del mes con el IVA por tarifa y el tipo de cambio. Por ejemplo: «¿Cuánto vendí en setiembre, por cliente?»
• Clientes y servicios. Buscar y crear clientes (con la cédula consulta a Hacienda), guardar un servicio con su código CABYS y pedir el cambio del correo de un cliente o del precio de un servicio. Por ejemplo: «Cree el cliente con la cédula 3-101-123456.»
• Compras y facturas recibidas. Ver las facturas que sus proveedores le emitieron y registrar una desde su XML. Por ejemplo: «Muéstreme las facturas recibidas este mes.»
• Ver lo que Defijo hace por usted. Las facturas mensuales que Defijo prepara cada mes y lo que vigila. Por ejemplo: «¿Qué facturas repite cada mes?»

Lo que Claude nunca hace

• No emite facturas. Claude deja la factura preparada; usted la revisa y toca «Emitir» en la tarjeta de Defijo, en la conversación, o en el enlace a Defijo que Claude le da. Hasta ese toque no sale nada a Hacienda.
• No anula, no envía correos y no marca nada como pagado. Prepara la nota de crédito, el recordatorio, el reenvío o la marca de pago. El toque final lo hace usted, en la tarjeta o en el enlace.
• No cambia la configuración de su negocio. Y no cambia la ficha de un cliente ni de un servicio ya guardado por su cuenta: el cambio que pide queda pendiente y usted lo guarda o lo descarta.
• No tiene su llave criptográfica (.p12), su PIN, el usuario de Tico Factura ni su contraseña de Defijo. Ninguna herramienta los lee, y la contraseña usted la escribe en Defijo, no en Claude.

Lo que sí queda hecho al instante, sin un toque suyo: crear un cliente, crear un servicio, registrar una factura recibida desde su XML, abrir y cambiar un borrador de factura, y descartar un borrador o una factura sin emitir, igual que usted en Defijo. Revise esas cosas en Defijo si no las pidió.

Cómo se revisa y se emite una factura preparada

En Claude y en ChatGPT, la factura preparada aparece en la conversación como una tarjeta de Defijo, con los montos, los impuestos, el cliente y el botón «Emitir». Toque «Emitir» ahí y la tarjeta le muestra la respuesta de Hacienda.

Si no ve la tarjeta, Claude también le da un enlace, y es el mismo paso:

1. Abra el enlace. Si no tiene la sesión abierta, Defijo le pide entrar.
2. Defijo muestra la factura completa, con montos, impuestos y datos del cliente, y lo que falte si falta algo.
3. Si usted toca «Emitir», Defijo la firma y la envía a Hacienda, y le muestra la respuesta de Hacienda.

Los montos, los impuestos y los totales los calcula Defijo, no Claude. Después de que usted revisó una factura, Claude puede consultar cómo terminó (esperando, emitida, rechazada, fallida, descartada o reemplazada). Esa consulta se queda en Defijo y no consulta a Hacienda.

Un cambio en la ficha de un cliente o de un servicio

Cuando usted le pide a Claude cambiar un dato habitual de un cliente (el correo, las copias, la condición de venta con sus días de crédito, el medio de pago o la moneda habitual) o el precio o la descripción de un servicio, el cambio no se guarda. Queda pendiente en la ficha del cliente o en el servicio, y Claude le da el enlace. Ahí Defijo muestra quién lo pidió y cuándo, lo que dice hoy y lo que diría, con dos botones: «Guardar en la ficha» (o «Guardar en el servicio») y «Descartar». Nada cambia hasta que usted guarda. El nombre, la cédula y la dirección de un cliente, y el código CABYS, la tarifa de IVA, la unidad, la moneda y la clave de un servicio no se cambian por esta vía.

Cada ficha tiene un solo cambio pendiente. Si su propio asistente pide otro cambio en la misma ficha, reemplaza al anterior. Si el pendiente lo pidió el asistente de otra persona del negocio hace menos de siete días, no se reemplaza y Claude le dice: «Ya hay un cambio pendiente ahí, pedido por otra persona del negocio. Una persona lo acepta o lo descarta en la ficha antes de que se pida otro.» Un cambio pendiente que nadie contestó en más de siete días deja de impedir que se pida otro.

Qué datos salen de Defijo cuando Claude usa una herramienta

Claude conectado puede leer todo lo de su negocio; cada respuesta trae lo que la pregunta necesita. Por ejemplo: el nombre, la identificación y el correo de un cliente, las líneas y los montos de un documento, su estado y el enlace para revisarlo. Defijo no entrega su llave criptográfica, su PIN ni sus credenciales de Tico Factura.

Esos datos llegan a Claude, un servicio de Anthropic que usted eligió con su propia cuenta. Lo que Claude haga con ellos se rige por los términos y el aviso de privacidad de Anthropic, no por los de Defijo. Lo que hizo Claude con su negocio queda enConexiones, para que usted lo revise.

De la conexión, Defijo guarda el nombre del agente, el negocio, los permisos que usted autorizó y la fecha del último uso. Las llaves de acceso se guardan solo como huellas (hash), no en claro. Más detalle en el aviso de privacidad.

Ver y revocar una conexión

1. Entre a Defijo y abra Conexiones: https://defijo.app/conexiones.
2. Verá cada agente conectado, el negocio, los permisos y el último uso.
3. Toque «Revocar». El acceso se corta de inmediato.

Si cambia su contraseña de Defijo, Defijo desconecta todos sus agentes, y la pantalla Conexiones se lo dice: «Al cambiar su contraseña desconectamos a sus agentes. Para usarlos de nuevo, conéctelos otra vez desde cada agente.» Una conexión que no se usa durante 60 días se cierra sola. También puede quitar el conector desde Claude, en Customize, Connectors, con Remove; revocar en Defijo es lo que corta el acceso del lado de Defijo.

Si algo falla

• «Esta solicitud de conexión ya no es válida.» La pantalla de conexión espera hasta 15 minutos. Empiece otra vez desde Claude con Connect, o desde ChatGPT con Conectar.
• «Demasiados intentos seguidos. Espere un momento y vuelva a intentar.» o «Demasiadas solicitudes seguidas. Espere un momento.» Espere un minuto y repita.
• «Esta factura cambió. Revise la versión nueva antes de modificarla.» La factura cambió mientras Claude trabajaba en ella. Pídale a Claude que la consulte de nuevo.
• Claude dice que perdió el acceso: conecte de nuevo desde Claude e inicie sesión en Defijo. Pasa si usted revocó la conexión, cambió su contraseña o pasaron 60 días sin usarla.
• Si falta algo para preparar una factura, por ejemplo un dato del negocio, Claude le dice qué falta y le da el enlace de la pantalla de Defijo donde se resuelve.

Contacto

Dudas sobre el conector o sobre sus datos: soporte@defijo.app.

Desde el chat también puede escribirnos: diga que quiere escribirle al equipo de Defijo. Defijo le muestra su mensaje en una tarjeta y no sale nada hasta que usted toca «Enviar a Defijo». Le respondemos al correo de su cuenta.

Defijo lo opera BELUMIS SOCIEDAD DE RESPONSABILIDAD LIMITADA, de Trybotix Labs, en Costa Rica.

Aviso de privacidad · Términos de uso