Qué puede hacer un agente
Alcance de las herramientas#
De las 117 herramientas, 63 sólo leen y 54 modifican estado. 20 de esas 54 están marcadas como sensibles.
Las marcadas como sensibles, agrupadas por tema. La lista sale del catálogo: son todas las herramientas con nivel de acceso sensible. Enviar mensajes (enlaces, comprobantes o avisos por WhatsApp o correo) cuenta como escritura, no como operación sensible.
Mueven dinero: reembolsos y capturas, cobros a tarjetas guardadas, transferencias bancarias, su confirmación y el doble control
- tilopay_modify_transaction: Capturar, reembolsar o reversar
- tilopay_charge_saved_card: Cobrar a una tarjeta guardada de un cliente
- tilopay_saved_cards_create_payments: Cobrar a tarjetas almacenadas
- baas_send_transfer: Enviar transferencia BaaS
- baas_confirm_transfer: Autorizar la transferencia pendiente
- banca_decide_approval: Aprobar o rechazar una operación pendiente
Borran o desactivan: enlaces, productos, planes, cupones, contactos, tarjetas guardadas, recordatorios, tiendas, dominios y pedidos
- tilopay_delete_payment_link: Eliminar enlace de pago
- tilopay_catalog_delete_item: Borrar un producto del catálogo
- tilopay_delete_contact: Eliminar contacto
- tilopay_store_delete: Desactivar una microtienda
- tilopay_store_domain_remove: Quitar un dominio propio
- tilopay_orders_disable: Apagar la gestión de pedidos
- tilopay_cancel_reminder: Cancelar recordatorio
- tilopay_recurring_delete_plan: Eliminar plan de suscripción
- tilopay_recurring_delete_coupon: Eliminar un cupón
- tilopay_remove_saved_card: Eliminar una tarjeta guardada de un cliente
Cambian el estado de un suscriptor y sus cobros futuros
- tilopay_recurring_manage_subscriber: Pausar, reactivar o eliminar un suscriptor
- tilopay_recurring_edit_subscriber: Editar suscriptor de un plan
Cortan el acceso: desvincular la cuenta y quitar a un empleado
- tilopay_unlink_account: Desvincular mi cuenta
- tilopay_remove_employee: Quitar acceso a un empleado
Herencia de permisos#
El servidor usa las credenciales de API del comercio, así que hereda exactamente sus permisos: no impone barreras adicionales por herramienta. Un usuario activo puede reembolsar y hacer cobros masivos; esas operaciones exigen el código de confirmación que llega al correo (ver Confirmaciones que exige Tilopay).
Controles que existen#
- Un interruptor de activación por usuario, que corta el acceso sin borrar la cuenta.
- Un rol de administrador separado, que sólo sirve para gestionar usuarios y credenciales.
- Un límite de tasa de 60 llamadas por minuto por usuario.
Confirmaciones que exige Tilopay#
Tilopay exige confirmaciones en el servidor para las operaciones que se detallan a continuación. Para las demás herramientas de escritura, la confirmación humana corresponde al cliente MCP.
Código de 6 dígitos por correo (segundo factor). Lo exigen tilopay_modify_transaction,
tilopay_charge_saved_card, tilopay_saved_cards_create_payments, tilopay_remove_saved_card,
tilopay_delete_payment_link y tilopay_recurring_manage_subscriber. El ciclo es:
- Se llama la herramienta sin
confirmation_code. - La respuesta trae
structuredContentcon{requires_confirmation: true, channel: "email", expires_in_seconds: 600, summary, details[], risk_level, second_channel}y Tilopay envía el código al correo del comercio. - Se repite la MISMA llamada con los mismos parámetros más
confirmation_code.
El código vence a los 10 minutos, admite 5 intentos, se pueden pedir 3 códigos cada 10 minutos y cada código nuevo invalida el anterior. Con riesgo elevado el mismo código llega también por SMS si hay número configurado.
Extensión de depósitos. tilopay_deposit_extend exige un código de 6 dígitos por correo y es sólo para el dueño. Su esquema no declara confirmation_code, por lo que el flujo de dos llamadas se completa desde el Asistente de WhatsApp.
confirm: true obligatorio. tilopay_unlink_account, tilopay_remove_employee y
baas_get_account_number sólo se ejecutan con confirm: true.
Huella de lote. tilopay_recurring_settle_batch devuelve un resumen con fingerprint y sólo
ejecuta con confirm: true y la misma huella (máximo 20 enlaces).
Transferencias bancarias. El código lo envía el portal Banca Cliente al correo y se pasa como
code a baas_confirm_transfer (o a banca_decide_approval cuando hay doble control).
Confirmación humana en el cliente MCP#
Para el resto de herramientas de escritura, el cliente MCP debe pedir confirmación humana antes de ejecutarlas.
tilopay_charge_saved_card y tilopay_saved_cards_create_payments no deduplican: repetir la
operación con un código nuevo cobra otra vez. Antes de reintentar, verificá el resultado con
tilopay_sales_summary o tilopay_saved_cards_list_collections.
tilopay_catalog_delete_item no exige código por correo: el Asistente de WhatsApp pide confirmación en el chat y los clientes MCP deben pedir confirmación humana. tilopay_recurring_edit_subscriber tampoco exige código por correo; para pausar, reactivar o eliminar con segundo factor existe tilopay_recurring_manage_subscriber.
Última verificación: 2026-10-20