Las herramientas de transacciones devuelven una página HTTPS de confirmación de un solo uso. El backend prepara y valida la solicitud; tú la revisas y firmas desde tu cartera.
El flujo de confirmación
- El agente solicita la acción compatible exacta.
- La herramienta devuelve una
confirmationUrle información de la operación. - Abre esa URL en el navegador, revisa la acción y conecta la cartera prevista si es necesario.
- Elige Confirmar en la cartera y aprueba o rechaza en la interfaz habitual de la cartera.
- Consulta el resultado de la operación y el recurso afectado.
El agente debe mostrar la URL devuelta sin modificarla. Su secreto va en el fragmento y no debe copiarse en registros ni reconstruirse en otra URL. Las intenciones normalmente caducan a los cinco minutos.
Qué demuestra cada etapa
| Etapa | Evidencia |
|---|---|
| Preparada | El backend creó una solicitud; no se ha firmado nada |
| Esperando aprobación | El usuario todavía debe aprobar o rechazar |
| Enviada | Se observó un envío desde la cartera; el estado final puede seguir pendiente |
| Resultado verificado | El lector de la operación o recurso correspondiente observa el estado esperado |
Resultados caducados o inciertos
Si una intención caduca antes del envío, consulta el estado actual antes de preparar otra. Si el envío es ambiguo, no repitas automáticamente la transacción. Una aprobación anterior aún podría completarse.
Renovar o revocar el acceso MCP puede invalidar una confirmación preparada. Vuelve a comprobar la acción y el recurso previstos antes de pedir una nueva URL.
Vuelve a leer el recurso correcto
Usa domains.records para una raíz propia y subdomains.get_item para un hijo propio. Para sitios, usa sites.list_releases y sites.list_domains. Para Storage, conserva el identificador de operación del proveedor devuelto por ese flujo; no es intercambiable con un ID de operación MCP genérico.
Transferencias de NFT
| Activo | Herramienta |
|---|---|
Raíz .ton o .t.me | dns.send_transfer_tx con domain y newOwner |
| NFT hijo | subdomains.transfer_item_tx con itemAddress y newOwner |
Después de una transferencia, las herramientas exclusivas del propietario pueden dejar de devolver el NFT. Para una raíz .ton, usa dns.lookup para comprobar el nuevo propietario. Para un nombre de usuario o hijo, verifícalo con la cartera receptora o un lector de cadena adecuado.