Shieldz

@shieldz/mcp

**适用于 Shieldz 的模型上下文协议（MCP）服务。**让 AI Agent（Claude 等）接受非托管加密货币付款并销售数字产品。

资金始终会结算到你提供的钱包地址。Shieldz 绝不会持有你的密钥。

免密工具（无需账户或 API 密钥）

提供目标钱包地址，一次调用即可开始接受加密货币付款：

• create_payment_link — 创建一次性付款链接（可分享的 URL + 可嵌入按钮 + 二维码）。参数：address、amount_usd，以及可选的 chain（默认值为 base）、asset（默认值为 USDC）、memo、email。
• create_tip_jar — 创建可重复使用的“随心付”页面；付款方自行选择金额。参数：address，以及可选的 chain、asset、title、suggested_amounts_usd、slug、email。
• create_unlock — 销售数字产品：创建付费解锁页面，用于交付文件链接、许可证密钥或秘密文本（最多 100k 个字符）。买家付款后，系统会在其付款确认时自动显示内容。参数：address、price_usd、payload、aup_accepted，以及可选的 title、description、chain、asset、email。（如需交付最大为 10 MB 的上传文件，请向 /api/v1/unlocks 发送 multipart 请求。）
• get_account_status — 通过 manage_token 查询结算详情、打赏罐、总额和发票。

这些工具无需任何配置即可使用。传入可选的 email，所有者日后即可通过 magic link 认领完整的仪表板。

远程（无需安装） — 将任意 MCP 客户端指向托管的服务：

{ "mcpServers": { "shieldz": { "url": "https://shieldz.cash/mcp" } } }

本地（stdio） — 通过 npx 运行：

{
  "mcpServers": {
    "shieldz": {
      "command": "npx",
      "args": ["-y", "@shieldz/mcp"]
    }
  }
}

API 密钥工具（完整商户账户）

设置 SHIELDZ_API_KEY，即可额外启用更丰富的发票管理功能：create_invoice、get_invoice、list_invoices。

{
  "mcpServers": {
    "shieldz": {
      "command": "npx",
      "args": ["-y", "@shieldz/mcp"],
      "env": { "SHIELDZ_API_KEY": "sk_live_…" }
    }
  }
}

从商户仪表板 → Developers 获取 API 密钥。

环境变量

• SHIELDZ_API_KEY（可选）— 启用发票工具。不设置则使用免密模式。
• SHIELDZ_BASE_URL（可选）— 默认值为 https://shieldz.cash。

许可证

MIT © Deniz Yanbollu / Shieldz