solvapay

SolvaPay — 路由器

消除模糊的 SolvaPay 意图，并将请求路由到负责相应工作的界面技能。

此技能唯一的工作就是路由。 确定正确的界面并输出交接模板或托管 MCP 退出方式后，本轮就结束了——到此为止。不要阅读目标技能的 SKILL.md。不要实现任何代码、步骤或说明。用户或目标技能会负责实现。在交接后输出实现细节（即使是作为「有用的背景信息」）也会违背此路由器的用途，并重复界面技能更擅长完成的工作。

SolvaPay 的功能

SolvaPay 为应用和 AI 工具添加基于用量的计费、付费墙和托管结账功能。遇到「SolvaPay 能做什么／我需要哪种方案」的问题时，请用此对比表回答，然后路由到负责相应工作的界面技能或托管 MCP 退出方式：

界面	构建内容	适用场景	路由到
付费 MCP	在 Cloudflare Workers MCP 服务上按调用次数或订阅计费	产品本身就是面向 AI Agent 的 MCP 工具，并且你想要编写代码（从零构建、OpenAPI→MCP，或为现有 MCP 服务添加付费墙）	solvapay/create-mcp-app
托管 MCP	SolvaPay 为你托管 MCP 服务的身份验证、付费墙和代理	想要在无需编写代码的情况下实现 MCP 服务变现——粘贴服务 URL，然后在控制台配置方案	托管 MCP 退出方式
应用集成	在自有代码中为端点设置访问限制、计量用量、处理 Webhook 和构建计费界面	你拥有应用或 API，并希望通过代码实现计费（REST、Next.js、Express）	solvapay/app-integration
托管结账	一键接入的支付页面 + 客户门户	想要通过生产网站销售访问权限，且无需自定义计费代码	solvapay/website-checkout
Lovable 结账	可粘贴接入的 Vite + Supabase edge 结账	你正在 Lovable / Vite 预览环境中制作原型，并希望粘贴接入结账功能	solvapay/lovable-checkout

决策树

按顺序逐项判断；第一个回答「是」的选项即为结果：

1. 要实现变现的对象是面向 AI Agent 的 MCP 服务／MCP 工具吗？
   • 无需编写代码／通过控制台配置／粘贴服务 URL → 托管 MCP 退出方式。
   • 编写代码（从零构建 Worker、OpenAPI→MCP、为现有 MCP 添加付费墙或工厂封装）→ solvapay/create-mcp-app。
2. 否则，是否有现有应用或 API 后端，需要通过代码实现计费（付费墙、用量计量、Webhook）？→ solvapay/app-integration。
3. 否则，他们是否只想为生产网站使用托管支付页面（无需编写计费代码）？→ solvapay/website-checkout。
4. 是否为专门的 Lovable / Vite 预览应用？→ solvapay/lovable-checkout。
5. 没有明确匹配项 → 提出消歧问题。

防护原则

• 绝不将 SOLVAPAY_SECRET_KEY 暴露给客户端代码或公共环境变量。
• 如果托管结账能满足需求，绝不自定义构建银行卡信息收集功能。
• 始终优先使用官方 SolvaPay SDK 辅助工具，而非临时编写原始 HTTP 调用。
• 始终优先按主题发现文档（MCP 或 llms.txt），而非硬编码文档路径。

注意事项

• 可作为独立安装使用——按 skill id（solvapay/<surface>）路由，而不是按文件系统路径。
• 未提及 MCP 的“为我的 API 添加付费墙”或“为 Web 应用添加付费墙” → solvapay/app-integration，而不是 solvapay/create-mcp-app。
• “搭建 mcp 框架”／从零开始开发 MCP worker → solvapay/create-mcp-app，而不是 solvapay/app-integration。
• Managed MCP 由控制台驱动——没有任何 skill 负责它；请使用 Managed MCP 退出路径，不要使用虚构的 skill id。
• “无需代码即可让 mcp server 变现”／“粘贴我的 server url”／“无需代码即可限制工具访问” → Managed MCP 退出路径，而不是 solvapay/create-mcp-app。
• 特定关键词由各表面 skill 的描述负责；此路由器只负责处理含糊的漏斗顶部提示词。
• MCP 主机应用中的“客户门户”或计费 UI → solvapay/create-mcp-app（references/mcp-apps-ui.md），而不是 solvapay/website-checkout。

路由流程

1. 遍历决策树，获得路由 ID 或 Managed MCP 退出路径（或进入第 5 步 → 消歧）。
2. 对照意图矩阵中的短语查找；如果用户的措辞匹配另一行，则优先采用矩阵结果并进行协调。
3. 如果仍有歧义 → 提出一个消歧问题。
4. 运行验证循环。
5. 输出交接模板或 Managed MCP 退出路径，然后停止。

文档发现流程（所有表面 skill 共用）：SolvaPay Docs MCP → https://docs.solvapay.com/llms.txt → 直接获取页面。

意图矩阵

仅适用于含糊的／漏斗顶部触发词。特定技术栈关键词由各表面 skill 的描述负责。

用户意图	触发示例	路由至
含糊的入门需求	“添加 solvapay”、“我该从哪里开始”、“solvapay 能做什么”、“让某些东西变现”	询问以消除歧义，然后路由
从零开始构建付费 MCP	“创建 mcp 应用”、“搭建 mcp 框架”、“新建 mcp server”、“openapi 转 mcp”、“npm create solvapay”、“付费 mcp”、“让 mcp 变现”	solvapay/create-mcp-app
现有 MCP server（添加付费墙／用 factory 封装）	“将 solvapay 添加到我的 mcp”、“为我的 mcp 工具添加付费墙”、“用 factory 封装”	solvapay/create-mcp-app
Managed MCP（无需代码）	“无需代码”、“managed mcp”、“粘贴我的 mcp server url”、“无需代码即可限制工具访问”、“托管式无代码代理”	Managed MCP 退出路径
为现有应用／API 添加付费墙	“集成 sdk”、“保护 api”、“付费墙”、“使用量事件”、“webhooks”、“npx solvapay init”	solvapay/app-integration
Web 托管式结账	“向网站添加结账”、“托管式结账”、“在我的网站上销售访问权限”	solvapay/website-checkout
Lovable 预览版结账	“lovable”、“粘贴到 lovable”、“vite 结账”、“supabase edge 结账”、“@preview”	solvapay/lovable-checkout

负向路由示例

• “迁移旧计费数据”、“仅进行一般的 Stripe 设置” → 询问以澄清；不要自动路由。
• 从 OpenAPI／零开始构建 MCP → solvapay/create-mcp-app，而不是 solvapay/app-integration。
• 未涉及 MCP 的 Web/API 付费墙 → solvapay/app-integration，而不是 solvapay/create-mcp-app。
• 无代码 MCP／粘贴 server URL → Managed MCP 退出路径，而不是 solvapay/create-mcp-app。

消歧提示词

“你想要：（1）用代码构建付费 MCP server（使用 OpenAPI 或手写工具），（2）在控制台设置 Managed MCP（无需代码——粘贴你的 server URL），（3）为现有应用或 API 添加付费墙、使用量计量、webhooks 或计费 UI，（4）为生产环境中的 Web 应用设置托管式结账，还是（5）将结账粘贴到 Lovable 预览应用中？”

如果仍有歧义，默认处理方式：从零开始用代码构建 MCP → solvapay/create-mcp-app；无代码 MCP → Managed MCP 退出路径；其他情况 → solvapay/app-integration。

表层技能

技能 ID	负责内容
solvapay/create-mcp-app	通过代码实现付费 MCP——从零开始构建 worker、将 OpenAPI 转换为 MCP，或为现有 MCP 服务添加付费墙
solvapay/app-integration	在现有应用或 API 中实现付费墙、用量、webhook 和计费 UI
solvapay/website-checkout	面向生产环境 Web 应用的托管结账和门户
solvapay/lovable-checkout	可粘贴到 Lovable 的预览结账功能

如果缺少，请安装：npx skills add solvapay/skills --skill <flat-name> -y（例如，solvapay/create-mcp-app 对应 create-mcp-app）。

Managed MCP 没有对应技能——请改用 Managed MCP 退出流程。

验证流程

1. 确认路由 ID 与意图矩阵中的某一行匹配，或确认提示属于 Managed MCP（控制台退出流程）。
2. 确认提示不属于相近的反例（参见 evals/README.md 中的边界表）。
3. 如不匹配 → 重新路由或提出一个澄清问题；通过验证前不要移交。

移交模板

## Routing handoff
- **Routing id:** solvapay/<surface>
- **Why:** [one sentence tied to user intent]
- **Install if missing:** `npx skills add solvapay/skills --skill <flat-name> -y`
- **Next:** Load solvapay/<surface> SKILL.md and follow its instructions.

输出此模板后即停止。不要添加目标技能中的实施步骤、代码片段或说明。移交内容就是此技能的全部输出。

Managed MCP 退出流程

当用户希望通过无代码方式实现 MCP 变现时使用——粘贴服务 URL，通过控制台限制工具访问，并在不编写付费墙代码的情况下配置套餐。Managed MCP 没有对应技能；此退出流程取代移交模板。

## Managed MCP routing
- **Surface:** Managed MCP (console — no code)
- **Why:** [one sentence tied to user intent — e.g. paste server URL, gate tools without code]
- **Next steps:**
  1. Open the SolvaPay provider console and create a Managed MCP product.
  2. Follow docs: `/no-code-mcp/overview` and `/no-code-mcp/quick-start`.
  3. For API bootstrap on an existing Managed MCP product, see `solvapay/app-integration` → `references/mcp-product-console.md`.

执行此退出流程后即停止。不要搭建 worker、编写付费墙代码，也不要移交给 solvapay/create-mcp-app。

任务进度

• 提取主要意图（MCP 代码 / Managed MCP / SDK / Web 结账 / Lovable / 不明确）
• 如果不明确 → 提出消歧问题（包含 Managed MCP 和 Lovable 选项）
• 根据意图矩阵匹配路由 ID，或使用 Managed MCP 退出流程
• 运行验证流程（确认不是相近的反例）
• 如果缺少目标技能则安装（仅限技能表层）
• 输出移交模板或 Managed MCP 退出流程并停止——之后不要添加代码或实施步骤

开发模式（仅供技能作者 / 内部测试）

如果用户明确表示要测试 SolvaPay 开发后端，请在 CLI 调用（npm create solvapay@latest、npx solvapay@latest init）中追加 --dev。切勿为最终用户启用此选项。