# 安装 x402 Universal Payer

- 类型: MCP 工具
- 说明: 自动发现并支付开放网络上的 x402 接口，支持消费上限控制与安全调用。
- 仓库: https://github.com/nirholas/three.ws
- ⚠ 安全: 该 MCP 工具来自官方 Registry 且开源、近期有更新，整体未见明显恶意红旗；但其核心能力是使用区块链私钥进行自动支付，并可能连接发现到的 x402 端点与链上 RPC，需严格配置额度与允许名单。

## 方式一 · 一键代装（复制提示词让 AI 代劳）

### Claude Code
```
请帮我安装 askskill 上的 "x402 Universal Payer" MCP 服务：
执行：claude mcp add io-github-nirholas-x402-bridge -- npx -y @three-ws/mcp-bridge
```

### Codex
```
请帮我安装 askskill 上的 "x402 Universal Payer" MCP 服务：
在 ~/.codex/config.toml 中添加：
[mcp_servers.io-github-nirholas-x402-bridge]
command = "npx"
args = ["-y","@three-ws/mcp-bridge"]
然后重启 Codex 生效
```

### Cursor
```
请帮我安装 askskill 上的 "x402 Universal Payer" MCP 服务：
在 .cursor/mcp.json 的 "mcpServers" 中添加：
"io-github-nirholas-x402-bridge": { "command": "npx", "args": ["-y","@three-ws/mcp-bridge"] }
然后在 Cursor 设置 > MCP 中启用
```

## 方式二 · 命令行安装（原生命令与配置）

### Claude Code
```bash
claude mcp add --env MCP_BRIDGE_EVM_PRIVATE_KEY=YOUR_VALUE --env MCP_BRIDGE_SVM_PRIVATE_KEY=YOUR_VALUE --env MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC=YOUR_VALUE --env MCP_BRIDGE_MAX_TOTAL_ATOMIC=YOUR_VALUE --env MCP_BRIDGE_ALLOWED_PAYTO=YOUR_VALUE --env MCP_BRIDGE_ALLOWED_HOSTS=YOUR_VALUE --env MCP_BRIDGE_ALLOW_HTTP=YOUR_VALUE --env MCP_BRIDGE_DISCOVER_LIMIT=YOUR_VALUE --env MCP_BRIDGE_BAZAAR_URL=YOUR_VALUE --env MCP_BRIDGE_BATCH_DEPOSIT_MULTIPLIER=YOUR_VALUE --env MCP_BRIDGE_MAX_DEPOSIT_ATOMIC=YOUR_VALUE --env X402_MCP_BRIDGE_CHANNELS_DIR=YOUR_VALUE --env RPC_URL_8453=YOUR_VALUE --transport stdio io-github-nirholas-x402-bridge -- npx -y @three-ws/mcp-bridge
```
需要环境变量：MCP_BRIDGE_EVM_PRIVATE_KEY, MCP_BRIDGE_SVM_PRIVATE_KEY, MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC, MCP_BRIDGE_MAX_TOTAL_ATOMIC, MCP_BRIDGE_ALLOWED_PAYTO, MCP_BRIDGE_ALLOWED_HOSTS, MCP_BRIDGE_ALLOW_HTTP, MCP_BRIDGE_DISCOVER_LIMIT, MCP_BRIDGE_BAZAAR_URL, MCP_BRIDGE_BATCH_DEPOSIT_MULTIPLIER, MCP_BRIDGE_MAX_DEPOSIT_ATOMIC, X402_MCP_BRIDGE_CHANNELS_DIR, RPC_URL_8453

### Codex
```bash
codex mcp add --env MCP_BRIDGE_EVM_PRIVATE_KEY=YOUR_VALUE --env MCP_BRIDGE_SVM_PRIVATE_KEY=YOUR_VALUE --env MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC=YOUR_VALUE --env MCP_BRIDGE_MAX_TOTAL_ATOMIC=YOUR_VALUE --env MCP_BRIDGE_ALLOWED_PAYTO=YOUR_VALUE --env MCP_BRIDGE_ALLOWED_HOSTS=YOUR_VALUE --env MCP_BRIDGE_ALLOW_HTTP=YOUR_VALUE --env MCP_BRIDGE_DISCOVER_LIMIT=YOUR_VALUE --env MCP_BRIDGE_BAZAAR_URL=YOUR_VALUE --env MCP_BRIDGE_BATCH_DEPOSIT_MULTIPLIER=YOUR_VALUE --env MCP_BRIDGE_MAX_DEPOSIT_ATOMIC=YOUR_VALUE --env X402_MCP_BRIDGE_CHANNELS_DIR=YOUR_VALUE --env RPC_URL_8453=YOUR_VALUE io-github-nirholas-x402-bridge -- npx -y @three-ws/mcp-bridge
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.io-github-nirholas-x402-bridge]
command = "npx"
args = ["-y","@three-ws/mcp-bridge"]

[mcp_servers.io-github-nirholas-x402-bridge.env]
MCP_BRIDGE_EVM_PRIVATE_KEY = "YOUR_VALUE"
MCP_BRIDGE_SVM_PRIVATE_KEY = "YOUR_VALUE"
MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC = "YOUR_VALUE"
MCP_BRIDGE_MAX_TOTAL_ATOMIC = "YOUR_VALUE"
MCP_BRIDGE_ALLOWED_PAYTO = "YOUR_VALUE"
MCP_BRIDGE_ALLOWED_HOSTS = "YOUR_VALUE"
MCP_BRIDGE_ALLOW_HTTP = "YOUR_VALUE"
MCP_BRIDGE_DISCOVER_LIMIT = "YOUR_VALUE"
MCP_BRIDGE_BAZAAR_URL = "YOUR_VALUE"
MCP_BRIDGE_BATCH_DEPOSIT_MULTIPLIER = "YOUR_VALUE"
MCP_BRIDGE_MAX_DEPOSIT_ATOMIC = "YOUR_VALUE"
X402_MCP_BRIDGE_CHANNELS_DIR = "YOUR_VALUE"
RPC_URL_8453 = "YOUR_VALUE"
```
需要环境变量：MCP_BRIDGE_EVM_PRIVATE_KEY, MCP_BRIDGE_SVM_PRIVATE_KEY, MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC, MCP_BRIDGE_MAX_TOTAL_ATOMIC, MCP_BRIDGE_ALLOWED_PAYTO, MCP_BRIDGE_ALLOWED_HOSTS, MCP_BRIDGE_ALLOW_HTTP, MCP_BRIDGE_DISCOVER_LIMIT, MCP_BRIDGE_BAZAAR_URL, MCP_BRIDGE_BATCH_DEPOSIT_MULTIPLIER, MCP_BRIDGE_MAX_DEPOSIT_ATOMIC, X402_MCP_BRIDGE_CHANNELS_DIR, RPC_URL_8453

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "io-github-nirholas-x402-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/mcp-bridge"
      ],
      "env": {
        "MCP_BRIDGE_EVM_PRIVATE_KEY": "YOUR_VALUE",
        "MCP_BRIDGE_SVM_PRIVATE_KEY": "YOUR_VALUE",
        "MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC": "YOUR_VALUE",
        "MCP_BRIDGE_MAX_TOTAL_ATOMIC": "YOUR_VALUE",
        "MCP_BRIDGE_ALLOWED_PAYTO": "YOUR_VALUE",
        "MCP_BRIDGE_ALLOWED_HOSTS": "YOUR_VALUE",
        "MCP_BRIDGE_ALLOW_HTTP": "YOUR_VALUE",
        "MCP_BRIDGE_DISCOVER_LIMIT": "YOUR_VALUE",
        "MCP_BRIDGE_BAZAAR_URL": "YOUR_VALUE",
        "MCP_BRIDGE_BATCH_DEPOSIT_MULTIPLIER": "YOUR_VALUE",
        "MCP_BRIDGE_MAX_DEPOSIT_ATOMIC": "YOUR_VALUE",
        "X402_MCP_BRIDGE_CHANNELS_DIR": "YOUR_VALUE",
        "RPC_URL_8453": "YOUR_VALUE"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=io-github-nirholas-x402-bridge&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkB0aHJlZS13cy9tY3AtYnJpZGdlIl0sImVudiI6eyJNQ1BfQlJJREdFX0VWTV9QUklWQVRFX0tFWSI6IllPVVJfVkFMVUUiLCJNQ1BfQlJJREdFX1NWTV9QUklWQVRFX0tFWSI6IllPVVJfVkFMVUUiLCJNQ1BfQlJJREdFX01BWF9QUklDRV9QRVJfQ0FMTF9BVE9NSUMiOiJZT1VSX1ZBTFVFIiwiTUNQX0JSSURHRV9NQVhfVE9UQUxfQVRPTUlDIjoiWU9VUl9WQUxVRSIsIk1DUF9CUklER0VfQUxMT1dFRF9QQVlUTyI6IllPVVJfVkFMVUUiLCJNQ1BfQlJJREdFX0FMTE9XRURfSE9TVFMiOiJZT1VSX1ZBTFVFIiwiTUNQX0JSSURHRV9BTExPV19IVFRQIjoiWU9VUl9WQUxVRSIsIk1DUF9CUklER0VfRElTQ09WRVJfTElNSVQiOiJZT1VSX1ZBTFVFIiwiTUNQX0JSSURHRV9CQVpBQVJfVVJMIjoiWU9VUl9WQUxVRSIsIk1DUF9CUklER0VfQkFUQ0hfREVQT1NJVF9NVUxUSVBMSUVSIjoiWU9VUl9WQUxVRSIsIk1DUF9CUklER0VfTUFYX0RFUE9TSVRfQVRPTUlDIjoiWU9VUl9WQUxVRSIsIlg0MDJfTUNQX0JSSURHRV9DSEFOTkVMU19ESVIiOiJZT1VSX1ZBTFVFIiwiUlBDX1VSTF84NDUzIjoiWU9VUl9WQUxVRSJ9fQ
需要环境变量：MCP_BRIDGE_EVM_PRIVATE_KEY, MCP_BRIDGE_SVM_PRIVATE_KEY, MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC, MCP_BRIDGE_MAX_TOTAL_ATOMIC, MCP_BRIDGE_ALLOWED_PAYTO, MCP_BRIDGE_ALLOWED_HOSTS, MCP_BRIDGE_ALLOW_HTTP, MCP_BRIDGE_DISCOVER_LIMIT, MCP_BRIDGE_BAZAAR_URL, MCP_BRIDGE_BATCH_DEPOSIT_MULTIPLIER, MCP_BRIDGE_MAX_DEPOSIT_ATOMIC, X402_MCP_BRIDGE_CHANNELS_DIR, RPC_URL_8453