> For the complete documentation index, see [llms.txt](https://support.safeheron.com/help-center/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.safeheron.com/help-center/jian-ti-zhong-wen/chan-pin/shen-ru-safeheron/safeheron-remote-mcp.md).
# Safeheron Remote MCP
### 1. 产品简介
Safeheron Remote MCP 让 AI Agent（如 Claude、Cursor）能够直接连接并操作你的 Safeheron 团队。你不再需要在复杂界面中逐步点击，只需用自然语言告诉 AI 你想做什么。
**核心价值：**
* **自然语言交互**：用日常语言替代复杂界面操作，极大降低学习成本
* **零安装开箱即用**：只需粘贴一个 URL，通过浏览器完成授权即可使用
* **托管服务免维护**：Safeheron 负责基础设施运维，服务始终保持最新可用
**可以做什么：**
* 查询所有钱包账户及余额
* 获取最近的交易记录
* 查看跨钱包的资产汇总
* 查询审批策略和审批节点
* 搜索白名单地址
***
### 2. 前置条件
在开始之前，请确认以下准备工作已完成：
| 项目 | 说明 |
| -------------- | --------------------------------------------------------------------------------- |
| Safeheron 工作空间 | 已开通并配置好的 Safeheron 账户 |
| Remote MCP 功能 | 默认未开启，您可以在“ [Web 控制台](https://console.safeheron.com/) > 应用 > Safeheron Lab”开启此功能 |
| AI 客户端 | Claude Desktop / Claude Web（Pro/Max）或 Cursor |
| 浏览器 | 用于完成 OAuth 授权流程 |
> **注意**：Remote MCP 功能一旦开启，团队中的每个用户都可以连接 AI Agent。请与团队确认安全策略后再开启。
***
### 3. 连接与授权流程
#### 3.1 Claude Desktop / Web
**Step 1：复制 MCP Server URL**
```plaintext
https://mcp.safeheron.vip/mcp
```
**Step 2：配置 Claude Connector**
打开 Claude Desktop 或 Web 版，进入 **Settings → Connectors → Go to customize**，点击 **Add custom Connector**，填入名称（如 `Safeheron`）和上面的 URL。
**Step 3：连接并授权**
点击新添加的 MCP Server 旁的 **Connect** 按钮，浏览器将弹出 Safeheron 的 OAuth 授权页面。确认授权后，连接建立完成。
**Step 4：开始对话**
在 Claude 聊天框中输入：
```plaintext
帮我查看 Safeheron 上有多少资产
```
如果一切正常，Claude 将调用 Safeheron MCP 工具并返回你的资产信息。
***
#### 3.2 Cursor
**Step 1：复制 JSON 配置**
```json
{
"mcpServers": {
"safeheron": {
"url": "https://mcp.safeheron.vip/mcp"
}
}
}
```
**Step 2：配置 Cursor MCP Server**
打开 **Cursor → Cursor Settings → Tools & MCP**，点击 **Add Custom MCP Server**，粘贴上述 JSON 配置。
**Step 3：连接并授权**
点击 MCP Server 旁的 **Connect** 按钮，完成浏览器授权。
**Step 4：开始对话**
在 Cursor 的 AI 聊天中输入：
```plaintext
帮我查看 Safeheron 上有多少资产
```
***
### 4. 核心功能实战演示
以下是 Safeheron Remote MCP 提供的 12 个核心工具的实战用法，分为 6 个场景进行演示。
#### 4.1 资产总览查询
**场景**：快速了解工作空间的整体资产状况。
**示例提问：**
```plaintext
我的 Safeheron 工作空间总资产（USD 计价）是多少？
```
**涉及工具**：`getWorkspaceAssets`
**预期结果**：AI 将返回工作空间的总资产 USD 估值。
***
**进阶提问：**
```plaintext
帮我统计一下所有钱包中 BTC 和 ETH 的汇总余额
```
**涉及工具**：`queryMultiAccountBalanceStat`
**预期结果**：AI 返回 BTC、ETH 跨钱包的合计余额。
***
#### 4.2 钱包管理
**场景**：查看钱包列表、查询特定钱包详情及链上地址。
**示例提问 1：列出前 10 个钱包**
```plaintext
列出我前10个钱包账户和余额
```
**涉及工具**：`listWallets`
**预期结果**：返回钱包 ID、钱包名称、USD 总余额列表。
***
**示例提问 2：按名称搜索钱包**
```plaintext
帮我找名字包含 "Wallet 1 changed" 的钱包
```
**涉及工具**：`listWallets`（使用 `namePrefix` 参数）
***
**示例提问 3：查看钱包币种详情**
```plaintext
查看 "Wallet 1 changed" 钱包里有哪些币种，分别的余额和区块链地址是什么？
```
**涉及工具**：`listWallets` → `getWalletCoins`
**预期结果**：AI 先找到 Treasury 钱包的 ID，再查询该钱包下所有币种的余额和对应的区块链地址。
***
#### 4.3 交易查询与追踪
**场景**：搜索历史交易记录、追踪特定交易状态。
**示例提问 1：最近交易**
```plaintext
查看今天的最近 10 笔交易
```
**涉及工具**：`searchTransactions`
**预期结果**：返回交易 ID、币种、金额、状态、来源/目的地等信息。
***
**示例提问 2：按条件过滤**
```plaintext
帮我查一下过去 7 天内的所有已完成交易
```
**涉及工具**：`searchTransactions`（使用时间和金额过滤）
***
**示例提问 3：追踪单笔交易**
```plaintext
交易 ID 为 xxx 的交易现在是什么状态？
```
**涉及工具**：`getTransaction`
**预期结果**：返回该交易的详细信息，包括状态（SUBMITTED / SIGNING / BROADCASTING / CONFIRMING / COMPLETED / FAILED / REJECTED / CANCELLED）、交易哈希、来源和目的地等。
***
**交易状态速查表**
| 状态码 | 状态名 | 说明 |
| --- | ------------ | -------- |
| 0 | SUBMITTED | 已提交，等待审批 |
| 1 | CANCELLED | 已取消 |
| 2 | BROADCASTING | 正在广播上链 |
| 3 | CONFIRMING | 等待区块确认 |
| 4 | COMPLETED | 交易完成 |
| 5 | FAILED | 交易失败 |
| 7 | REJECTED | 审批拒绝 |
| 10 | SIGNING | 正在签名 |
***
#### 4.4 审批策略查询
**场景**：了解工作空间当前的交易审批规则和审批节点配置。
**示例提问 1：查看审批策略**
```plaintext
当前团队的交易审批策略是什么？
```
**涉及工具**：`queryActivePolicy`
**预期结果**：AI 将解读并用自然语言描述当前生效的审批策略，包括发起人限制、源钱包限制、目标地址限制、资产类型限制、单笔/累计金额审批阈值等。
***
**示例提问 2：查看审批节点**
```plaintext
列出所有审批节点及其审批人
```
**涉及工具**：`listAuditNodes`
**预期结果**：返回每个审批节点的名称、状态、审批人列表、关联规则。
***
#### 4.5 白名单管理
**场景**：查询已审批的白名单地址。
**示例提问：**
```plaintext
搜索白名单名称中包含 "test" 的地址
```
**涉及工具**：`searchWhitelist`
**预期结果**：返回匹配的白名单 ID、名称、地址和所属网络。
***
```plaintext
列出前 10 个白名单的地址
```
**涉及工具**：`searchWhitelist`（不带搜索参数）
***
### 5. 最佳实践
#### 5.1 提问技巧
**用具体、明确的自然语言描述你的需求：**
| 一般提问 | 更好提问 |
| ----- | ------------------------------ |
| 查看资产 | 查看工作空间的总资产，以 USD 计价 |
| 最近的交易 | 查看过去 7 天内金额大于 500 USD 的所有已完成交易 |
#### 5.2 多步骤任务编排
你可以让 AI 完成复杂的多步任务：
```plaintext
帮我做一份资产报告：
1. 查看工作空间总资产
2. 列出所有钱包及各自余额
3. 统计 BTC 和 ETH 的跨钱包汇总
4. 查看今天的交易记录
```
AI 会自动编排多个工具调用，汇总输出一份完整报告。
#### 5.3 审批策略审查
定期用 AI 审查审批策略配置：
```plaintext
帮我审查当前的审批策略，列出每条规则的关键配置：
- 谁可以发起交易
- 允许的源钱包和目标地址
- 金额阈值和对应的审批要求
- 是否有禁止规则
```
#### 5.4 交易监控
利用 AI 进行日常交易监控：
```plaintext
帮我检查是否有长时间未完成的交易（状态为 SUBMITTED 或 SIGNING 超过 24 小时的）
```
***
### 6. 安全须知
1. **默认只读**：Remote MCP 默认为只读操作，AI Agent 无法发起或签署交易，除非额外开启写入权限。
2. **AI 输出须审核**：AI 模型可能产生非预期结果，务必仔细核对 AI 返回的数据和建议操作，尤其是涉及金额和地址的信息。
3. **授权范围**：连接 AI Agent 时需通过 OAuth 授权，授权后 AI 可以代替你查询数据。请仅连接你信任的 AI 客户端。
4. **全员可用**：功能开启后，工作空间中所有用户都可连接 AI Agent，请确保团队成员了解相关安全规范。
***
### 7. 常见问题 FAQ
**Q1：Remote MCP 功能如何开通？**
默认未开启，您可以在“ [Web 控制台](https://console.safeheron.com/) > 应用 > Safeheron Lab”中开启此功能。
**Q2：支持哪些 AI 客户端？**
目前支持 Claude Desktop、Claude Web（Pro/Max 用户）和 Cursor。理论上支持任何兼容 MCP 协议的 AI 客户端。
**Q3：AI 能直接转走我的资产吗？**
不能。默认为只读模式。即使开启交易权限，也必须经过你的对话确认 + Safeheron 审批策略双重保障。
**Q4：授权后如何断开连接？**
在 AI 客户端的 Settings → Connectors 中删除对应的 Connector 即可。
**Q5：支持哪些区块链和币种？**
可以通过提问 AI 来获取最新的支持列表：
```plaintext
列出 Safeheron 支持的所有币种
```
**Q6：连接时遇到授权失败怎么办？**
请确认：(1) Remote MCP 功能已开通；(2) 你的 Safeheron 账户状态正常；(3) 浏览器未拦截 OAuth 弹窗。如仍有问题，请联系 Safeheron Support 团队（）。