Conecta un asistente AI

Heth MCP le brinda a un asistente acceso limitado a su propia cuenta, incluidas las funciones comerciales disponibles. No puede otorgar acceso de administración de la plataforma. Abrir una pantalla de conexión no otorga ningún permiso.

Conectar un asistente

1. En la aplicación Heth donde su billetera ya está abierta, vaya a Configuración → Conexiones AI y elija Crear código de conexión. El código único pertenece a esa cuenta y caduca después de cinco minutos.
2. En la configuración de conexión de su cliente AI, agregue https://mcp.heth.me/mcp y elija OAuth. Comience a conectarse.
3. En la ventana de conexión, ingrese solo el código de Heth. No inicia sesión en su billetera en este navegador. El código envía una solicitud a la cuenta exacta que lo creó; no concede ningún acceso.
4. Si Heth está abierto, aparece un aviso de solicitud de conexión AI en la parte superior de la aplicación. Elija Revisar solicitud de conexión o abra el push. También puede encontrar la solicitud en Configuración → Conexiones AI → Solicitudes de conexión. Compare el código de verificación de solicitud con el de la ventana de conexión y verifique la cuenta, el identificador del cliente y la dirección del servicio. El nombre de la aplicación por sí solo no verifica la identidad.
5. En Heth, desmarque los permisos que no desea compartir y elija Aprobar el acceso al AI seleccionado, o elija Denegar el acceso al AI. Abrir el push por sí solo no aprueba nada.
6. Regrese al cliente AI. Su ventana de conexión finaliza automáticamente después de su decisión en Heth. Su sesión de billetera y sus claves de firma permanecen en Heth.

Un código de conexión usado o caducado no se puede reutilizar. Crea un nuevo código en Heth; crear uno reemplaza el código anterior no utilizado. Si toda la solicitud de conexión caduca, reinicie desde el cliente AI.

En ChatGPT

Abra Complementos → Agregar → Agregar servidor MCP personalizado, ingrese un nombre como Heth.me y la dirección del servidor anterior, y mantenga OAuth seleccionado. ChatGPT descubre la configuración de conexión automáticamente; no se necesita clave de billetera API, secreto de cliente ni frase de recuperación. Cree el complemento personal, elija Connect Heth.me y luego siga los pasos anteriores para codificar y enviar. Puede seleccionar permisos predeterminados en Configuración avanzada de OAuth; La elección final del permiso de la cuenta se confirma en la aplicación Heth.

Después de la conexión, seleccione Heth.me en el chat e intente "Mostrar los saldos de mi billetera usando Heth". Las herramientas disponibles dependen de los permisos que haya aprobado.

En Código Claude

En una terminal, agrega Heth y comienza a conectar:

claude mcp add --transport http heth https://mcp.heth.me/mcp
claude mcp login heth

Claude Code registra la conexión automáticamente y abre una ventana del navegador. Ingrese el código de un solo uso de Heth allí, luego revise y apruebe los permisos en la aplicación Heth siguiendo los pasos anteriores. Mantenga el terminal abierto hasta que finalice la conexión. No necesita un identificador de cliente, un secreto de cliente ni una clave API de billetera.

Después de la conexión, pregúntele a Claude: "Mostrar los saldos de mi billetera usando Heth". Solo puede usar los permisos que usted aprobó. Puede administrar o revocar esta conexión en Configuración → Conexiones AI en Heth.

Saldos de billetera

Preguntar: "Mostrar los saldos de mi billetera usando Heth". Los nombres de las billeteras coinciden con la aplicación: USDT ERC20, USDT TRC20, USDT Base, cNGN Base. Cada monto incluye su unidad simbólica; RUB_T, UZS_T y ZOLT siguen siendo nombres de tokens distintos. Los identificadores de la base de datos de Wallet no se muestran.

El asistente recibe un saldo exacto en unidades de token, conservando todos los decimales y orientación sobre el formato. Por ejemplo, 1.000001 USDT no debe mostrarse como 1 USDT y una pequeña cantidad distinta de cero no debe convertirse en cero. Los separadores decimales y de agrupación siguen su idioma. Si no hay precisión disponible, el asistente muestra un guión y explica por qué en lugar de inventar una cantidad. Las diferentes monedas y redes no se suman. Las billeteras almacenadas únicamente en su dispositivo no están incluidas.

Permisos y herramientas

Solo se pueden aprobar los permisos solicitados por el cliente y actualmente disponibles en su cuenta. Una herramienta es visible sólo con el permiso requerido. Las herramientas cubren datos de cuentas, transferencias, cambios comerciales ordinarios, solicitudes de suscripción y OBS.

Permiso	Herramientas y finalidad
heth:wallets:read	get_wallet_balances: saldos de billetera propia
heth:transactions:read	list_transactions, get_transaction: historial propio y estado de transacción original
heth:business:read	list_products, list_business_payment_links, list_business_subscriptions: productos propios, enlaces gestionados y suscripciones comerciales; get_business_subscription, list_business_subscription_requests leen un acuerdo o solicitudes salientes
heth:payments:prepare	prepare_transfer, get_transfer_request: prepare una transferencia para su aprobación en Heth y lea el resultado original
heth:business:manage	create_business_product, update_business_product, delete_business_product; create_business_payment_link, update_business_payment_link, delete_business_payment_link: cambios ordinarios confirmados en el cliente AI
heth:business:manage	request_business_subscription: solicitar la aprobación de un cliente en Heth; prepare_business_subscription_change: pausa, reanudación o cancelación de revisión en Heth
heth:obs:read	get_obs_widget, list_obs_events: configuraciones y eventos entrantes
heth:obs:configure	prepare_obs_connection, update_obs_widget: Enlace de revisión de Heth o campos de apariencia solo con confirmación en el cliente AI

prepare_obs_connection no crea acceso y no devuelve ningún token OBS. La moneda/red, las cuentas receptoras, las claves y los permisos de acceso no se pueden cambiar mediante una herramienta de apariencia. Consulte la guía de configuración y personalización OBS, que incluye el proyecto de código abierto y las instrucciones para los asistentes de codificación.

Cuanto dura el acceso

Tu permiso de conexión dura hasta que lo revocas. Las credenciales técnicas caducan por separado: los tokens de acceso MCP duran minutos 15; Los tokens de actualización rotan y caducan después de días 30 sin renovación. Una credencial técnica vencida puede requerir que usted se conecte nuevamente incluso si el registro de consentimiento permanece activo.

Cada solicitud verifica la conexión actual y los permisos de la cuenta. Heth utiliza una credencial API restringida separada válida durante como máximo segundos 60 para atender solicitudes MCP; la sesión completa de la billetera no se comparte con MCP. Revocar el consentimiento o retirar los permisos de la cuenta bloquea las solicitudes posteriores, incluidas las solicitudes con tokens no vencidos. Los datos ya devueltos al cliente no se pueden recuperar.

Revocar o volver a conectar

En Heth, abra Configuración → Conexiones AI, verifique el identificador del cliente, la dirección del servicio, los permisos y el estado. Elija Revocar acceso a AI y confirme en Heth. La revocación no cancela los pagos efectuados ni los mandatos de débito de suscripción; adminístrelos por separado en configuración de suscripción.

Si se le solicita volver a conectarse, inicie una nueva autorización en su cliente AI. La revocación, las credenciales caducadas, los permisos retirados o la reutilización detectada de un token de actualización pueden finalizar el acceso. No pegue frases de recuperación, claves de billetera o credenciales de sesión del navegador en un asistente para reparar la conexión. Un servicio no disponible es un error, no una cuenta vacía o una aprobación exitosa.

Pagos y otros cambios

Heth requiere confirmación separada en Heth para cada operación monetaria. Un permiso de conexión no autoriza el gasto automático.

Las ediciones ordinarias de productos y enlaces de pago requieren confirmación en el cliente AI. Los cambios en los derechos de acceso, los destinatarios de los pagos o la autorización de débitos futuros requieren la confirmación de Heth. La apariencia de OBS sigue la política de confirmación del cliente. Una anotación de herramienta por sí sola no prueba que un cliente haya obtenido la aprobación.

También puede utilizar la aplicación Heth o la integración compatible API](../business/quick-start.md).

Traslado con asistente

1. Indíquele al asistente el tipo de transferencia, destinatario, moneda, red y monto. Interno a interno (hot_hot), interno a blockchain (hot_cold), blockchain a su cuenta interna (cold_hot) y blockchain a blockchain (cold_cold) son operaciones distintas. Utilice self como destinatario de cold_hot; acredita su propia cuenta Heth.
2. prepare_transfer guarda los términos y devuelve un enlace de revisión de Heth. No genera ningún pago. Las cantidades y max_debit utilizan cadenas enteras exactas en las unidades menores del token. max_debit limita el débito del token, incluidas las tarifas de la plataforma. Para una fuente de blockchain, max_network_fee limita el cargo de gas de la red de la transacción en wei (ETH/Base) o sun (TRON). Base puede cobrar adicionalmente una tarifa de datos L1.
3. Abra Heth y verifique la cuenta, solicitando límites de cliente, destinatario, fuente, monto, red y tarifas. Elija Confirmar y enviar Heth solo cuando todos los términos sean correctos. Abrir el enlace no aprueba ni envía nada. Las solicitudes caducan después de los minutos 15.
4. Heth firma la instrucción mostrada y utiliza su flujo de transferencia normal. Las transacciones de Blockchain se firman en su dispositivo o en un dispositivo de firma conectado. Abra Heth donde se puede firmar la cuenta de origen; Las claves privadas nunca van al asistente.
5. El asistente lee get_transfer_request para verificar la transacción original. Aprobado o tramitado no es lo mismo que pagado. Después de un tiempo de espera, lea el resultado original; reutilice el mismo request_id y términos idénticos si se debe volver a intentar una preparación. No cree una segunda transferencia para resolver un resultado incierto.

La revocación bloquea el inicio de una nueva transferencia. Una transacción ya aceptada para su ejecución aún puede completarse; Revocar una conexión AI no cancela una transferencia blockchain aceptada.

Productos, enlaces y suscripciones

El asistente muestra cambios ordinarios de productos o enlaces administrados para su confirmación en el cliente AI. Los importes del precio y del enlace son cadenas de números enteros en unidades menores; las cantidades de productos son números enteros positivos. Un request_id estable hace que los reintentos sean idempotentes. Estas operaciones no pueden editar la ruta de pago, los destinatarios de los pagos, las claves ni los derechos de acceso. Eliminar un enlace o producto no revierte un pago anterior.

request_business_subscription crea una solicitud para que el pagador la revise en Heth. No otorga permiso para débitos futuros y no genera ningún cargo por sí solo. El pagador revisa el monto, la frecuencia y el primer cargo antes de registrarse en Heth. Utilice list_business_subscription_requests para comprobar solicitudes y get_business_subscription o list_business_subscriptions para acuerdos existentes.

Para pausar, reanudar o cancelar un acuerdo, prepare_business_subscription_change muestra una pantalla de revisión de Heth. Nada cambia hasta que el propietario lo confirme allí. La reanudación permite los cargos programados según el permiso de pago existente. La cancelación detiene los cargos futuros y no reembolsa los pagos completados. Cambiar los términos de facturación acordados requiere la aprobación de un nuevo pagador.

Tus límites de pago se aplican a las transferencias internas preparadas por IA (hot_hot). Heth comprueba límites y tipos de referencia antes de ejecutar. Las transferencias en blockchain y las comisiones de red quedan fuera. Un permiso de IA o un código válido no anulan el máximo; modifica los ajustes en Heth. Muestra el activo y la red junto al importe y marca las equivalencias como aproximadas. No compares directamente unidades menores de activos diferentes.