用途
stacktree-mcp 是 stacktr.ee 的 MCP 服务器，让 AI 智能体（如 Claude Code、Codex、Cursor、Claude.ai）将生成的 HTML 内容以私有方式发布到网络。发布的页面通过不可猜测的 URL 访问，可设置密码或邮箱域名门控，并支持过期、阅后即焚和原地更新。
主要能力
- 发布 HTML：从任意 MCP 客户端发布 HTML 制品。
- 私有访问：每个站点获得不可猜测的 https://stacktr.ee/p/{token}/ 地址；可通过 public_slug 使用 https://{slug}.stacktr.ee/。
- 原地更新：使用 update_site 以相同 URL 更新页面内容。
- 访问控制：支持设置访问密码（所有计划可用），以及邮箱门控和查看者数量（付费计划）。
- 过期与阅后即焚：可设置过期时间，expires_in_hours 支持 "never"（受计划限制时返回 409 expiry_clamped）。
- 反馈功能：通过 set_client_feedback 开启评论，收件人可选中文字、点击图片、视频或区块留下评论；list_feedback 获取评论（未解决优先），resolve_feedback 标记已解决。
- 安全默认：pii_check 默认 block，上传内容匹配常见密钥和 PII 模式（邮箱、SSN、信用卡、OpenAI/GitHub/Stripe API 密钥前缀）会被拒绝；可设为 warn 或 off。
- 钱包链接：如智能体使用自己钱包支付发布，可通过 link_wallet 将钱包链接到 Stacktree 账户，从而拥有其发布的页面。
使用方式
- 在 https://app.stacktr.ee 生成 API key。
- 将 MCP 服务器添加到 MCP 客户端配置中。
- 如客户端支持 streamable HTTP，可直接连接托管服务器 https://api.stacktr.ee/mcp，该服务器提供相同的 42 个工具。
- 认证：stk_live_ 密钥可直接作为 MCP 端点凭证；也接受 OAuth 2.1 动态客户端注册；不接受会话 cookie。
- 无密钥且无人可问时，可 POST https://api.stacktr.ee/provision 通过 x402 购买；有人但无浏览器时，可 POST https://api.stacktr.ee/api-keys/device-code 并轮询获取密钥（RFC 8628）。
适用场景
- 需要将 AI 生成的 HTML 以私有链接分享给特定人员。
- 需要收集指定收件人对页面内容的反馈。
- 需要页面自动过期或阅后即焚的场景。
- 通过 MCP 客户端（如 Claude Desktop、Claude Code、Cursor、Continue）自动化发布流程。
限制
- 免费计划：总共可发布 3 个页面，每个页面 7 天后过期；计数为终身，删除或过期不会返还名额。
- expires_in_hours 为 "never" 在有限制的计划上会被拒绝（409 expiry_clamped），不会静默缩短；超出上限的数值会被缩短，响应中带 expiry_clamped: true。
- 邮箱门控和查看者数量需要付费计划。
- 达到上限返回 HTTP 402 及 plan_* 错误码。
- 数据存储：发布文件存于 Cloudflare R2，页面元数据（URL、可见性、过期、密码哈希、查看计数）存于 Cloudflare D1。页面过期或删除后内容保留 30 天以便恢复，之后销毁；服务日志保留 30 天，IP 地址哈希化。
- 隐私政策：https://stacktr.ee/privacy，联系 privacy@stacktr.ee。
- 定价：https://stacktr.ee/pricing.md。
- 获取当前调用密钥的限制，可用 GET /me 或 get_me 工具，不要硬编码上限。
