跳到主要内容

连接 AI 助手

Heth MCP 为助理提供对您自己帐户的有限访问权限，包括可用的业务功能。它无法授予平台管理访问权限。打开连接屏幕不会授予任何权限。

连接助手​

  1. 在钱包已打开的 Heth 应用程序中，转到 设置 → AI 连接 并选择 创建连接代码。一次性代码属于该帐户，并在五分钟后过期。
  2. 在 AI 客户端的连接设置中，添加 https://mcp.heth.me/mcp 并选择 OAuth。开始连接。
  3. 在连接窗口中，仅输入 Heth 的代码。您未在此浏览器中登录您的钱包。该代码向创建它的确切帐户发送请求；它不授予任何访问权限。
  4. 如果 Heth 打开，应用程序顶部会出现 AI 连接请求 通知。选择 查看连接请求，或打开推送。您还可以在设置 → AI 连接 → 连接请求下找到该请求。将请求验证码与连接窗口中的验证码进行对比，查看账户、客户端标识和服务地址。仅凭应用程序名称并不能验证身份。
  5. 在 Heth 中，取消选中您不想共享的权限，然后选择 批准选定的 AI 访问，或选择 拒绝 AI 访问。单独打开推送并不能批准任何事情。
  6. 返回AI客户端。当你在Heth做出决定后，它的连接窗口会自动结束。您的钱包会话和签名密钥保留在 Heth 中。

已使用或过期的连接代码无法重复使用。在Heth中创建一个新的代码；创建一个替换以前未使用的代码。如果整个连接请求过期，则从AI客户端重新启动。

在 ChatGPT 中​

打开插件 → 添加 → 添加自定义 MCP 服务器，输入名称（例如 Heth.me）和上面的服务器地址，并保持选中 OAuth。 ChatGPT 自动发现连接设置；不需要钱包 API 密钥、客户端密钥或恢复短语。创建个人插件，选择 Connect Heth.me，然后按照上面的代码和推送步骤操作。您可以在高级 OAuth 设置下选择默认权限；最终帐户权限选择在 Heth 应用程序中确认。

连接后，在聊天中选择 Heth.me 并尝试“使用 Heth 显示我的钱包余额”。可用的工具取决于您批准的权限。

Claude Code​

在终端中，添加 Heth 并开始连接：

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

Claude Code 自动注册连接并打开浏览器窗口。在那里输入 Heth 的一次性代码，然后使用上述步骤在 Heth 应用程序中审核并批准权限。保持终端打开，直到连接完成。您不需要客户端标识符、客户端密钥或钱包 API 密钥。

连接后，询问 Claude：“使用 Heth 显示我的钱包余额”。它只能使用您批准的权限。您可以在 Heth 的 设置 → AI 连接 中管理或撤销此连接。

钱包余额​

询问：“使用 Heth 显示我的钱包余额”。钱包名称与应用程序匹配：USDT ERC20、USDT TRC20、USDT Base、cNGN Base。每笔金额均包含其代币单位； RUB_T、UZS_T 和 ZOLT 仍然是不同的代币名称。不显示钱包数据库标识符。

助手会收到以代币为单位的精确余额和格式指导。例如，1.000001 USDT 不得显示为 1 USDT，并且小的非零金额不得变为零。小数点和分组分隔符遵循您的语言。如果无法精确显示，助手会显示破折号并解释原因，而不是发明一个数字。不同的货币和网络不会加在一起。仅存储在您设备上的钱包不包括在内。

权限和工具​

仅可以批准客户请求且当前可用于您的帐户的权限。工具仅在获得所需权限后才可见。工具涵盖账户数据、转账、普通业务变更、订阅请求和OBS。

许可工具和目的
heth:wallets:readget_wallet_balances：自己的钱包余额
heth:transactions:readlist_transactions、get_transaction：自己的历史记录和原始交易状态
heth:business:readlist_products、list_business_payment_links、list_business_subscriptions：自有产品、托管链接和商家订阅； get_business_subscription、list_business_subscription_requests 读取协议或传出请求
heth:payments:prepareprepare_transfer、get_transfer_request：准备在 Heth 进行转账审批并阅读原始结果
heth:business:managecreate_business_product、update_business_product、delete_business_product； create_business_payment_link、update_business_payment_link、delete_business_payment_link：在 AI 客户端中确认的普通更改
heth:business:managerequest_business_subscription：请求Heth客户的批准； prepare_business_subscription_change：在 Heth 审核暂停、恢复或取消
heth:obs:readget_obs_widget、list_obs_events：设置和传入事件
heth:obs:configureprepare_obs_connection、update_obs_widget：Heth 审核链接或外观字段仅在 AI 客户端中确认

prepare_obs_connection 不创建访问权限，也不返回 OBS 令牌。货币/网络、接收帐户、密钥和访问权限无法通过外观工具更改。请参阅OBS设置和定制指南，包括开源项目和编码助手说明。

访问持续多长时间​

您的连接权限将持续直到您撤销它。技术凭证单独过期：MCP 访问令牌有效期为 15 分钟；刷新令牌在 30 天后轮换并过期，无需续订。即使同意记录仍然有效，过期的技术凭证也可能要求您重新连接。

每个请求都会检查当前连接和帐户权限。 Heth 使用单独的受限 API 凭证，其有效期最多为 60 秒，以服务 MCP 请求；完整的钱包会话不与 MCP 共享。撤销同意或撤回帐户权限会阻止后续请求，包括使用未过期令牌的请求。已返回给客户端的数据无法撤回。

撤销或重新连接​

在Heth中，打开设置→AI连接，检查客户端标识符、服务地址、权限和状态。选择 Revoke AI access 并在 Heth 中确认。撤销不会取消已完成的付款或订阅借记授权；在订阅设置中单独管理它们。

如果要求重新连接，请在 AI 客户端中启动新的授权。撤销、过期的凭据、撤回的权限或检测到刷新令牌的重复使用都可能会终止访问。请勿将恢复短语、钱包密钥或浏览器会话凭据粘贴到助手中以修复连接。服务不可用是一个错误，而不是空帐户或成功批准。

付款和其他变更​

Heth 要求 每次货币操作都需要在 Heth 中单独确认。连接权限并不授权自动支出。

普通产品和付款链接编辑需要在 AI 客户端中确认。访问权限、付款接收者或未来借记授权的更改需要 Heth 确认。 OBS 的出现遵循客户端确认策略。仅凭工具注释并不能证明客户获得了认可。

您还可以使用Heth应用程序或支持的API集成。

与助手一起转移​

  1. 告诉助理转账类型、收款人、币种、网络和金额。内部到内部 (hot_hot)、内部到区块链 (hot_cold)、区块链到您的内部帐户 (cold_hot) 和区块链到区块链 (cold_cold) 是不同的操作。使用self作为cold_hot的接收者；它记入您自己的 Heth 帐户。
  2. prepare_transfer 保存条款并返回 Heth 审核链接。它不会产生任何付款。金额和 max_debit 使用代币最小货币单位中的精确整数字符串。 max_debit 限制代币借记（包括平台费用）。对于区块链源，max_network_fee 以 wei (ETH/Base) 或 sun (TRON) 为单位限制交易的网络 Gas 费用。基地可能会额外收取 L1 数据费。
  3. 打开Heth并检查账户，询问客户、收件人、来源、金额、网络和费用限制。仅当所有条款均正确时才选择 确认并发送到 Heth。打开链接并不批准或发送任何内容。请求在 15 分钟后过期。
  4. Heth 对显示的指令进行签名并使用其正常传输流程。区块链交易在您的设备或连接的签名设备上签名。打开Heth，可以对源账户进行签名；私钥永远不会交给助手。
  5. 助手读取get_transfer_request查看原始交易。批准或处理与付费不同。超时后，读取原始结果；如果必须重试准备，请重复使用相同的 request_id 和相同的术语。不要创建第二次传输来解决不确定的结果。

撤销会阻止新的传输开始。已接受执行的交易仍可以完成；撤销 AI 连接不会取消已接受的区块链传输。

产品、链接和订阅​

助手会显示普通产品或托管链路更改，以在 AI 客户端中进行确认。价格和链接金额是最小货币单位的整数字符串；产品数量为正整数。稳定的 request_id 使重试具有幂等性。这些操作无法编辑付款路线、付款收件人、密钥或访问权限。删除链接或产品不会撤销之前的付款。

request_business_subscription 创建请求供付款人在 Heth 进行审核。它不授予未来借记许可，并且本身不产生任何费用。付款人在登录 Heth 之前查看金额、频率和首次收费。使用 list_business_subscription_requests 检查请求，使用 get_business_subscription 或 list_business_subscriptions 检查现有协议。

要暂停、恢复或取消协议，prepare_business_subscription_change 返回 Heth 查看屏幕。在所有者确认之前不会发生任何变化。恢复允许在现有付款许可下按计划收费。取消将停止未来的费用，并且不会退还已完成的付款。更改商定的计费条款需要新的付款人批准。

您设置的付款限额适用于 AI 准备的内部转账（hot_hot）。Heth 在执行前检查当前限额和参考汇率。链上转账与网络费用不在这些限额范围内。AI 权限或有效确认码均不能绕过最高限额；请在 Heth 中修改设置。显示金额时应注明资产和网络，换算等值金额必须标为近似值。不得直接比较不同资产的原始最最小货币单位数值。

最后于 更新