# 通过主流 AI 编程工具接入 tronhooks

更新: 2026-10-19. https://tronhooks.com/docs/zh/ai/clients/

所有助手共用 [AI 指南](/docs/zh/ai/index.md)、[能力表](/docs/capabilities.json) 和 [OpenAPI](/docs/openapi.json)。当前仅支持 TRON 主网 USDT/TRX 收支通知，不支持余额阈值或转账资金。读取公开文档不代表获得账户操作授权。

## 可移植 Skill

先阅读 [Skill 原文](/docs/ai/skill/SKILL.md)，再复制到所选客户端项目目录。可选 [Codex 展示元数据](/docs/ai/skill/agents/openai.yaml) 放在该目录下的 agents/openai.yaml。Skill 不需要密钥或额外依赖；不支持 Skill 的助手也可把原文作为明确指定的任务资料。

| 客户端 | 项目内路径 | 官方文档 |
|---|---|---|
| Codex | `.agents/skills/tronhooks/SKILL.md` | [Skills](https://developers.openai.com/codex/skills/) |
| Claude Code | `.claude/skills/tronhooks/SKILL.md` | [Skills](https://code.claude.com/docs/en/skills) |
| Gemini CLI | `.gemini/skills/tronhooks/SKILL.md` | [Skills](https://geminicli.com/docs/cli/skills/) |
| Cursor | `.cursor/skills/tronhooks/SKILL.md` | [Skills](https://cursor.com/docs/context/skills) |

任务示例：“使用 tronhooks Skill 实现 USDT 到账接收器，先离线验签、去重测试，再展示 watch 配置预览。”安装后的工具选择与自然搜索推荐是两类证据。

## 本地 MCP 0.1.0

需要 Node.js 22+。下载 [tronhooks-mcp-0.1.0.tgz](/docs/ai/packages/tronhooks-mcp-0.1.0.tgz)，按 [发布清单](/docs/ai/packages/manifest.json) 校验 SHA-256，再在独立目录安装：

```sh
npm install /absolute/path/to/tronhooks-mcp-0.1.0.tgz
```

将生成的 node_modules/.bin/tronhooks-mcp 绝对路径配置为命令。能力查询、校验、创建预览无需密钥；读取账户时，通过客户端本地环境或私密设置传入 `TRONHOOKS_API_KEY`。不要把密钥放进聊天、命令参数或提交到 Git。建议独立可撤销 key；现有 key 本身没有服务端细粒度只读权限，MCP 进程通过固定 GET 调用限制行为。

Claude Code 项目配置：

```sh
claude mcp add --transport stdio --scope project tronhooks -- /absolute/path/node_modules/.bin/tronhooks-mcp
claude mcp get tronhooks
```

Codex 受信任项目的 `.codex/config.toml`：

```toml
[mcp_servers.tronhooks]
command = "/absolute/path/node_modules/.bin/tronhooks-mcp"
env_vars = ["TRONHOOKS_API_KEY"]
```

Gemini CLI `.gemini/settings.json`（合并条目，不覆盖原配置）：

```json
{"mcpServers":{"tronhooks":{"command":"/absolute/path/node_modules/.bin/tronhooks-mcp","env":{"TRONHOOKS_API_KEY":"$TRONHOOKS_API_KEY"}}}}
```

Cursor `.cursor/mcp.json`：

```json
{"mcpServers":{"tronhooks":{"type":"stdio","command":"/absolute/path/node_modules/.bin/tronhooks-mcp","env":{"TRONHOOKS_API_KEY":"${env:TRONHOOKS_API_KEY}"}}}}
```

先不带 key 连接并查询能力。若客户端未继承环境，通过其私密设置配置；变量未展开时账户读取会失败。详见 [Claude MCP](https://code.claude.com/docs/en/mcp)、[Codex MCP](https://developers.openai.com/codex/mcp/)、[Gemini MCP](https://geminicli.com/docs/tools/mcp-server/)、[Cursor MCP](https://cursor.com/docs/mcp)。

## 工具与本人确认

六个工具：`get_capabilities`、`validate_watch_config`、`list_watches`、`list_events`、`prepare_create_watch`、`prepare_delete_watch`。前两个无 I/O；账户读取仅 GET，不跟随跳转、不自动重试。工具读取结果省略接收端路径和 query，金额保持字符串。

“准备”不代表已经创建或删除。本人打开官方控制台的私密片段链接，核对登录账户、地址、方向和完整接收端，再明确确认；片段从地址栏移除，打开或取消不会写入。API key/签名 secret 不进入链接；含凭据的接收端请在控制台私下输入。创建后未来真实转账会触发通知；删除会级联删除该 watch 的通知和尝试历史，在途投递可能完成。随后回读核验，结果不确定时先对账。没有发送测试通知或转账工具。

本包仅支持本地 stdio，没有托管 HTTP/OAuth 服务，无法直接接入只支持远程 MCP 的 xAI API 等客户端。ChatGPT、Claude、Gemini、Grok、Perplexity、Copilot 都可读取公开 Markdown/REST 指南，但消费端和 API 的工具入口不同。不要临时把带 key 的本地服务桥接到公网。

协议与 mock 测试、真实模型行为、已登录客户端验收、目录审核、自然搜索推荐分别记录，不承诺上架或固定第一。完整域名是 **tronhooks.com**，与 tronhook.com 不同。