Ctrlk
WebsiteDeveloperGitHub
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Safeheron Remote MCP

本教程手把手演示如何连接、授权并使用 Safeheron Remote MCP，实现 AI Agent 与您在 Safeheron 的团队进行自然语言交互，帮助您管理 MPC 钱包。

1. 产品简介

Safeheron Remote MCP 让 AI Agent（如 Claude、Cursor）能够直接连接并操作你的 Safeheron 团队。你不再需要在复杂界面中逐步点击，只需用自然语言告诉 AI 你想做什么。

核心价值：

  • 自然语言交互：用日常语言替代复杂界面操作，极大降低学习成本

  • 零安装开箱即用：只需粘贴一个 URL，通过浏览器完成授权即可使用

  • 托管服务免维护：Safeheron 负责基础设施运维，服务始终保持最新可用

可以做什么：

  • 查询所有钱包账户及余额

  • 获取最近的交易记录

  • 查看跨钱包的资产汇总

  • 查询审批策略和审批节点

  • 搜索白名单地址

2. 前置条件

在开始之前，请确认以下准备工作已完成：

项目
说明

Safeheron 工作空间

已开通并配置好的 Safeheron 账户

Remote MCP 功能

默认未开启，您可以在“ Web 控制台 > 应用 > 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

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 聊天框中输入：

如果一切正常，Claude 将调用 Safeheron MCP 工具并返回你的资产信息。

3.2 Cursor

Step 1：复制 JSON 配置

Step 2：配置 Cursor MCP Server

打开 Cursor → Cursor Settings → Tools & MCP，点击 Add Custom MCP Server，粘贴上述 JSON 配置。

Step 3：连接并授权

点击 MCP Server 旁的 Connect 按钮，完成浏览器授权。

Step 4：开始对话

在 Cursor 的 AI 聊天中输入：

4. 核心功能实战演示

以下是 Safeheron Remote MCP 提供的 12 个核心工具的实战用法，分为 6 个场景进行演示。

4.1 资产总览查询

场景：快速了解工作空间的整体资产状况。

示例提问：

涉及工具：getWorkspaceAssets

预期结果：AI 将返回工作空间的总资产 USD 估值。

进阶提问：

涉及工具：queryMultiAccountBalanceStat

预期结果：AI 返回 BTC、ETH 跨钱包的合计余额。

4.2 钱包管理

场景：查看钱包列表、查询特定钱包详情及链上地址。

示例提问 1：列出前 10 个钱包

涉及工具：listWallets

预期结果：返回钱包 ID、钱包名称、USD 总余额列表。

示例提问 2：按名称搜索钱包

涉及工具：listWallets（使用 namePrefix 参数）

示例提问 3：查看钱包币种详情

涉及工具：listWallets → getWalletCoins

预期结果：AI 先找到 Treasury 钱包的 ID，再查询该钱包下所有币种的余额和对应的区块链地址。

4.3 交易查询与追踪

场景：搜索历史交易记录、追踪特定交易状态。

示例提问 1：最近交易

涉及工具：searchTransactions

预期结果：返回交易 ID、币种、金额、状态、来源/目的地等信息。

示例提问 2：按条件过滤

涉及工具：searchTransactions（使用时间和金额过滤）

示例提问 3：追踪单笔交易

涉及工具：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：查看审批策略

涉及工具：queryActivePolicy

预期结果：AI 将解读并用自然语言描述当前生效的审批策略，包括发起人限制、源钱包限制、目标地址限制、资产类型限制、单笔/累计金额审批阈值等。

示例提问 2：查看审批节点

涉及工具：listAuditNodes

预期结果：返回每个审批节点的名称、状态、审批人列表、关联规则。

4.5 白名单管理

场景：查询已审批的白名单地址。

示例提问：

涉及工具：searchWhitelist

预期结果：返回匹配的白名单 ID、名称、地址和所属网络。

涉及工具：searchWhitelist（不带搜索参数）

5. 最佳实践

5.1 提问技巧

用具体、明确的自然语言描述你的需求：

一般提问
更好提问

查看资产

查看工作空间的总资产，以 USD 计价

最近的交易

查看过去 7 天内金额大于 500 USD 的所有已完成交易

5.2 多步骤任务编排

你可以让 AI 完成复杂的多步任务：

AI 会自动编排多个工具调用，汇总输出一份完整报告。

5.3 审批策略审查

定期用 AI 审查审批策略配置：

5.4 交易监控

利用 AI 进行日常交易监控：

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 控制台 > 应用 > Safeheron Lab”中开启此功能。

Q2：支持哪些 AI 客户端？

目前支持 Claude Desktop、Claude Web（Pro/Max 用户）和 Cursor。理论上支持任何兼容 MCP 协议的 AI 客户端。

Q3：AI 能直接转走我的资产吗？

不能。默认为只读模式。即使开启交易权限，也必须经过你的对话确认 + Safeheron 审批策略双重保障。

Q4：授权后如何断开连接？

在 AI 客户端的 Settings → Connectors 中删除对应的 Connector 即可。

Q5：支持哪些区块链和币种？

可以通过提问 AI 来获取最新的支持列表：

Q6：连接时遇到授权失败怎么办？

请确认：(1) Remote MCP 功能已开通；(2) 你的 Safeheron 账户状态正常；(3) 浏览器未拦截 OAuth 弹窗。如仍有问题，请联系 Safeheron Support 团队（support@safeheron.com）。

Previous支持筛查币种
NextSafeheron Skill

Last updated