whollycrypto.
简体中文

AI 连接 · MCP

连接你的 AI 助手。

通过你自己的 Wholly Crypto 查找付款、检查余额和创建账单。

你的服务器，一个 MCP URL。

包含在商户版 5.0.0+中。无需额外守护进程、Node.js 运行环境或托管中继。使用安装中配置的 API 域名，例如 https://api.example.com/mcp.

  1. 打开 设置 → API 访问。创建专用凭据，并分配助手需要的项目。先从只读开始。
  2. 在 AI 连接 · MCP中启用 MCP。选择凭据，再选择 只读 并保存。
  3. 将显示的 URL 添加到助手的远程 HTTP/MCP 设置。
  4. 使用 OAuth 时，登录商户控制台。检查客户端名称、返回地址和凭据权限，然后批准。现有 Basic Auth 和 TOTP 仍然适用。
{
  "mcpServers": {
    "whollycrypto": {
      "url": "https://api.example.com/mcp"
    }
  }
}

替换示例域名。配置格式因客户端而异；请选择 Streamable HTTP，不要选择本地命令或旧版 SSE URL。

询问你的付款情况。

  • “显示我商店最新的未付款账单。”
  • “这个商店可以接受哪些资产？”
  • “检查钱包余额和发送失败的 Webhook。”
  • “为订单 1042 创建 25 EUR 的账单。” 需要创建账单权限。

八个读取工具覆盖项目、商店、支付方式、钱包、账单、发送历史和缓存换算。可选的第九个工具按现有 API 规则创建账单。

结果包含项目和商店 ID。金额保持为十进制字符串。缓存汇率和余额保留时效信息；换算不是有保证的账单报价。

选择助手可访问的内容。

MCP 默认关闭，升级后也一样。现有 API 密钥不会自动获得访问权。助手只能看到已批准的项目；IP 限制和凭据的 REST 速率限制也适用于 MCP。

要创建账单，请选择读写凭据和 读取 + 创建账单。OAuth 客户端必须请求 mcp:invoice:create，并且你必须勾选 同时允许创建账单 ，在批准时操作。

重复使用同一个 idempotency_key 以及账单请求体，在超时后重试时保持一致。新密钥会创建新账单。正常的加价、容差、付款和额度规则仍然适用。

不提供密钥导出或资金发送工具。 MCP 无法显示助记词、发送资金、归集、退款、重发回调，或更改账户、域名和计费。

OAuth、Bearer 密钥与撤销

OAuth 访问令牌有效期为 15 分钟。刷新令牌会轮换，连接最长持续 30 天。重放旧刷新令牌会撤销连接。仅接受已注册的 HTTPS 或环回返回 URL。

使用 已连接客户端 → 撤销 可移除访问权限。关闭 MCP 会撤销 OAuth 连接。凭据轮换、MCP 策略或规范 API 域名变更都需要重新连接。

支持自定义请求头的客户端可以在以下位置使用已启用 MCP 的 API 密钥： Authorization: Bearer …。该密钥保留独立的 REST 权限，因此仅需 MCP 访问时优先使用 OAuth。绝不要将机密粘贴到聊天、URL 或源码中。

只批准你认识的客户端。客户端名称未经验证。AI 服务商会收到你授权读取的信息，包括账单工具返回的客户数据。

连接失败时。

  • 404: 启用 MCP，并使用 API 主机，不要使用控制台或结账主机。
  • 401: 通过 OAuth 重新连接，或检查 Bearer 凭据是否有效。
  • 403: 检查凭据权限、已批准项目、源站和来源 IP 限制。
  • GET 返回 405： 这是预期行为。此无状态端点使用 POST 和有结束的 JSON 响应，不提供独立 SSE 流。
  • 429: 等待 Retry-After。MCP 与 REST 共用凭据配额。
  • 无法创建账单： 检查全部写入权限、项目/商店状态、支付就绪情况及额度账户验证。

为以下路径关闭 Cloudflare 缓存和交互式验证： /mcp, /mcp/oauth/* 以及 OAuth 发现路径。IP 白名单必须包含助手服务文档中公布的出口地址。

支持的协议版本： 2025-11-25, 2025-06-18 和 2025-03-26。客户端必须支持其中之一。请参阅 API 参考 ，查看所有工具、端点和错误格式。

为每张账单选择支付方式。

使用 invoice.payment_methods 搭配 chain_slug: "ethereum" 和 asset_tickers: ["USDC", "USDT"]。可在商店的支付方式中或通过以下方法查找 slug 和代码： list_payment_methods.

商户版 5.4.0+ 会忽略未启用或未接受的选项。没有匹配项时使用商店默认设置。仅指定链会包含所有已启用且接受的资产。同名代码需要准确的 asset_ids。就绪状态和汇率检查仍然适用，并返回各链对应的错误。Lightning 是独立选项；空选择数组无效。 请求格式 →