接入文档 - 闲沐连环画 MCP

快速开始（3 分钟）

注册账号（邮箱验证码即可）→ 创建 API Key，得到形如 xm-xxxxxxxx… 的密钥（仅展示一次）。
在支持 MCP 的客户端中添加下方配置（Claude Desktop、Cursor、WorkBuddy、Cherry Studio、Trae、CodeBuddy 等均可），端点 https://www.wwzu.com/mcp（Streamable HTTP）。
对话里直接说"帮我找几本三国题材的连环画"，Agent 会自动调用工具。免费层查询工具每日 100 次/Key（VIP 300 次）；角色对话按条计费、不占每日额度。

客户端配置

所有客户端接入信息一致 — 端点 https://www.wwzu.com/mcp（Streamable HTTP）· 请求头 Authorization: Bearer xm-你的APIKey

WorkBuddy、Cursor、Trae、CodeBuddy 等均支持通用 JSON 配置（mcpServers），任选其一：

WorkBuddy：设置 → MCP（连接器）→ 添加自定义 MCP 服务器，类型选 Streamable HTTP，填入端点 URL 与请求头；也可在工作区 .mcp.json 粘贴下方配置后信任启用。
Cursor：设置 → MCP → 添加新的 MCP 服务器，或项目 .cursor/mcp.json 粘贴下方配置。
Trae / CodeBuddy：MCP 设置 → 手动添加（JSON），粘贴下方配置。

{
  "mcpServers": {
    "xianmu-comics": {
      "url": "https://www.wwzu.com/mcp",
      "headers": { "Authorization": "Bearer xm-你的APIKey" }
    }
  }
}

Claude 桌面版的「连接器 → 添加自定义连接器」仅支持填 URL（OAuth 登录），不支持自定义请求头，因此用 mcp-remote 桥接（需 Node 18+）：

设置 → 开发者 → 编辑配置（claude_desktop_config.json），粘贴：

{
  "mcpServers": {
    "xianmu-comics": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://www.wwzu.com/mcp",
               "--header", "Authorization: Bearer xm-你的APIKey"]
    }
  }
}

命令行调试（MCP Inspector）：

npx @modelcontextprotocol/inspector
# Transport: Streamable HTTP
# URL: https://www.wwzu.com/mcp
# Header: Authorization = Bearer xm-你的APIKey

工具速查（10 个）

工具	权限	主要参数
`get_site_overview`	免费	—（站点统计 + 标签目录 tag_list）
`browse_comics`	免费	四模式互斥：query（多关键词）/ tag（sort=hits\|wwwid\|rating\|jishu）/ ranking=favorites\|rating\|hot / related_to
`get_comic`	免费·解锁态自适应	comic_id（官网 htmlname），page（单页）/ page_start + page_limit≤200（未解锁仅前 20 页预览并内嵌 unlock_quote）
`search_characters`	免费·解锁态自适应	query / character_ids≤50 / comic_id / random=true；include_ai_images（完整档案与图集需解锁所属书）
`chat_with_character`	免解锁·按条计费·不占额度	character_id, message（1-500 字）· 1 积分/条（与主站同价）
`get_account`	免费·不占额度	unlocked_limit≤100（余额 / 套餐 / 已解锁清单）
`unlock_comic`	免费·不占额度	comic_id, method=points\|alipay（¥1.9-4.9/部一次性买断）
`check_payment`	免费·不占额度	order_no（或 comic_id + payment_proof 走 AI 付验付）
`recharge_points`	免费·不占额度	package_key（如 p1000）
`reset_daily_quota`	免费·不占额度	—（扣 100 积分立即重置今日查询额度，也可在官网 Keys 页操作）

漫画标识 comic_id 与官网详情页 URL 一致（如 200741113201 = wwzu.com/comic-detail/200741113201），所有结果附带 web_url 可直接跳转。

错误码与自助处理

场景	状态	处理方式
Key 无效 / 已撤销 / 过期	401	重建 Key 并更新客户端配置
超过每日额度（普通 100 / VIP 300 次/Key，仅查询工具）	429	次日自动恢复；或 `reset_daily_quota` / 官网 Keys 页扣积分立即重置；角色对话与计费工具不占额度
解锁/充值下单	402	对话内即可完成：unlock_comic 报价付款 / recharge_points 充值，也可到计费页操作（¥1.9-4.9/部）
积分不足	402	支付宝充值积分（100 积分 = ¥1）
AI 服务暂时不可用	工具错误	稍后重试，失败调用不扣积分

使用须知

书页图片 / 音频 URL 仅供即时展示与播放，禁止批量下载、转存或二次分发；违规 Key 将被永久撤销。
解锁为按部一次性买断，与主站积分账本互通（C 端积分可解锁 B 端权益）。
AI 角色对话与主站角色对话使用同一 Prompt 模板与同一历史账本，网页上的对话在 MCP 中可延续。
服务条款与隐私政策见主站 privacy.html。