用途
setup-polar 是一个交互式引导向导，目标是把 Polar 支付在项目中跑通，从环境准备一路做到本地端到端测试。它适合需要首次接入 Polar、或在新项目中重新搭建支付链路的开发者。
主要流程与能力
第一步：检查 MCP 可用性。 先尝试用 MCP 工具列出产品或组织。若 MCP 可用，直接跳到创建产品阶段；不可用则进入安装环节。
第二步：安装 Polar MCP。 若已安装 Polar 插件，插件本身已配置好 Polar 服务器（polar，及可用的 polar-sandbox），只需让用户登录，优先使用沙箱：Claude Code 中用 /mcp，Codex 中用 codex mcp login <server>，ChatGPT 在提示时连接。未安装时按环境给出命令，例如 Claude Code：
claude mcp add --transport http polar https://mcp.polar.sh/mcp/polar-mcp
claude mcp add --transport http polar-sandbox https://mcp.polar.sh/mcp/polar-sandbox
Cursor 则在 .cursor/mcp.json 中配置 polar-sandbox 的 URL。安装后需重启编辑器或 CLI，并在提示时完成鉴权（跳转 polar.sh），再用列出组织的方式验证。
第三步：收集项目上下文。 询问框架（Next.js App Router、Next.js Pages Router、Express.js、FastAPI 或其它）、环境（沙箱推荐、或生产）、售卖类型（订阅、一次性或两者）。
第四步：处理组织。 用 MCP 检查是否已有组织，没有则引导到沙箱 https://sandbox.polar.sh/start 或生产 https://polar.sh/start 创建。
第五步：创建首个产品。 用 MCP 创建测试产品，例如名为 Pro Plan、月付 29 美元的订阅产品，并保存返回的产品 ID 供后续结账集成使用。
第六步：生成集成代码。 交给 polar-integration 技能，按所选框架生成 Checkout、客户门户与 Webhook 端点。调用前需准备好环境变量：
POLAR_ACCESS_TOKEN= # 来自 polar.sh/settings（或沙箱）
POLAR_WEBHOOK_SECRET= # 在第七步创建
POLAR_SERVER=sandbox # 上线时省略或设为 production
并把第五步的产品 ID 传入，便于测试结账链接。
第七步：设置 Webhook。 使用 Polar CLI 把 Webhook 转发到本地开发服务器，无需隧道或仪表盘端点。安装 CLI（npm install -g @polar-sh/cli）后运行 polar auth login --sandbox 打开浏览器登录。保存本地签名密钥且不打印，然后重启开发服务器：
secret=$(polar webhook listen --print-secret) && echo "POLAR_WEBHOOK_SECRET=$secret" >> .env
在后台启动 polar webhook listen <port>/<webhook-path>，路径取第六步生成的路由；随后运行 polar webhook trigger order.paid，它会打印处理器响应，失败时退出码为 1，需修复处理器直到退出码为 0。部署时，用 MCP 或仪表盘（Settings → Webhooks）为公网 URL 创建端点，选择 order.paid、subscription.created 和 subscription.canceled，并将该端点的密钥作为部署环境的 POLAR_WEBHOOK_SECRET。
第八步：测试集成。 启动开发服务器，用产品 ID 访问结账 URL，使用测试卡 4242 4242 4242 4242 完成结账，确认 polar webhook listen 显示处理器对 order.paid 返回 2xx，并检查成功页显示正常。
第九步：后续建议。 基础跑通后可添加客户门户（让用户管理订阅，即 polar-integration 的 Recipe 2）、在结账时传 externalCustomerId 与自有鉴权关联、添加权益（许可证密钥、文件下载、Discord 角色），以及把 POLAR_SERVER 从 sandbox 切到 production 上线。
适用场景
适合为 Web 后端或全栈项目首次配置 Polar 支付、建立本地 Webhook 调试链路、在沙箱中验证订阅或一次性购买结账流程。
限制
资料未说明该技能的收费、价格、支持框架之外的平台或其它额外效果；具体集成代码由 polar-integration 技能生成，本地测试依赖 Polar CLI 与 MCP 的可用性。