solvapay

SolvaPay — ルーター

曖昧な SolvaPay の意図を明確にし、作業を担当するサーフェススキルに振り分けます。

このスキルの役割はルーティングのみです。 適切なサーフェスを特定し、引き継ぎテンプレートまたはManaged MCP の終了処理を出力したら、そこで対応を終えてください。以降は何もせず、対象スキルの SKILL.md も読まないでください。コード、手順、指示の実装は行わないでください。実装はユーザーまたは対象スキルが担当します。引き継ぎ後に実装の詳細を出力すると（「参考情報」としてであっても）、このルーターの目的に反し、サーフェススキルがより適切に行える作業と重複します。

SolvaPay でできること

SolvaPay は、アプリや AI ツールに従量課金、ペイウォール、ホスト型チェックアウトを追加します。「SolvaPay で何ができるか／どれが必要か」という質問には、次の比較を示してから、担当するサーフェススキルまたは Managed MCP の終了処理に振り分けます。

サーフェス	構築するもの	選ぶ場面	振り分け先
有料 MCP	Cloudflare Workers の MCP サーバーでの呼び出しごとまたはサブスクリプションによる課金	対象のプロダクトが AI エージェント向けの MCP ツールであり、コードを書く場合（新規開発、OpenAPI→MCP、既存の MCP サーバーへのペイウォール導入）	solvapay/create-mcp-app
Managed MCP	ホストする MCP サーバー向けに SolvaPay が管理する認証、ペイウォール、プロキシ	コードを使わずに MCP サーバーを収益化したい場合。サーバー URL を貼り付け、コンソールでプランを設定します	Managed MCP の終了処理
アプリ連携	独自のコードでのエンドポイントの制限、使用量の計測、Webhook の処理、課金 UI	アプリまたは API を所有しており、コード内で課金処理を行いたい場合（REST、Next.js、Express）	solvapay/app-integration
ホスト型チェックアウト	組み込み型の決済ページ＋顧客ポータル	本番環境のウェブサイトで、独自の課金コードなしにアクセスを販売したい場合	solvapay/website-checkout
Lovable チェックアウト	貼り付けて使える Vite＋Supabase Edge のチェックアウト	Lovable / Vite のプレビューで試作しており、貼り付けて使えるチェックアウトが必要な場合	solvapay/lovable-checkout

判断ツリー

次の順に確認し、最初に「はい」となった項目を選びます。

1. 収益化の対象は、AI エージェント向けの MCP サーバー／MCP ツールですか？
   • コードなし／コンソール／サーバー URL の貼り付け → Managed 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 をクライアントコードや公開環境変数に絶対に公開しないでください。
• ホスト型チェックアウトで要件を満たせる場合、カード情報を収集する独自の仕組みは絶対に構築しないでください。
• 場当たり的な生の HTTP 呼び出しより、公式の SolvaPay SDK ヘルパーを常に優先してください。
• ハードコードされたドキュメントのパスではなく、トピックベースのドキュメント探索（MCP または llms.txt）を常に優先してください。

注意点

• 単独でのインストールに対応しています。ファイルシステムのパスではなく、スキル ID（solvapay/<surface>）でルーティングします。
• MCP の文脈がなく、「API をペイウォール化したい」または「ウェブアプリをペイウォール化したい」と言われた場合は、solvapay/create-mcp-app ではなく solvapay/app-integration にルーティングします。
• 「MCP をスキャフォールドする」やグリーンフィールドの MCP ワーカーの場合は、solvapay/app-integration ではなく solvapay/create-mcp-app にルーティングします。
• Managed MCP はコンソールから操作します。担当するスキルはありません。偽のスキル ID を使わず、Managed MCP の案内を使用します。
• 「ノーコードで MCP サーバーを収益化したい」、「サーバー URL を貼り付けたい」、「コードを書かずにツールをゲートしたい」の場合は、solvapay/create-mcp-app ではなく Managed MCP の案内を使用します。
• 各サーフェスのスキル説明では固有のキーワードを扱います。このルーターでは、ファネル最上部の曖昧なプロンプトのみを扱います。
• MCP ホストアプリ内の「カスタマーポータル」や請求 UI の場合は、solvapay/website-checkout ではなく solvapay/create-mcp-app（references/mcp-apps-ui.md）にルーティングします。

ルーティング手順

1. 決定木に従って、ルーティング ID または Managed MCP の案内を決定します（または手順 5 に進み、ユーザーに確認します）。
2. インテントマトリックスのフレーズ検索と照合します。ユーザーの言い回しが別の行に当てはまる場合は、マトリックスを優先して整合性を取ります。
3. まだ曖昧な場合は、確認用の質問を 1 つ尋ねます。
4. 検証ループを実行します。
5. 引き継ぎテンプレートまたはManaged MCP の案内を提示して終了します。

ドキュメントの検索（すべてのサーフェススキルで共通）：SolvaPay Docs MCP → https://docs.solvapay.com/llms.txt → ページを直接取得します。

インテントマトリックス

曖昧なトリガー、つまりファネル最上部のトリガーのみを示します。スタック固有のキーワードは、各サーフェスのスキル説明で扱います。

ユーザーのインテント	トリガーの例	ルーティング先
あいまいなオンボーディング	"add solvapay", "where do I start", "what can solvapay do", "monetize something"	確認してからルーティング
新規の有料 MCP	"create mcp app", "scaffold mcp", "new mcp server", "openapi to mcp", "npm create solvapay", "paid mcp", "monetize mcp"	solvapay/create-mcp-app
既存の MCP サーバー（ペイウォールを追加／ファクトリーでラップ）	"add solvapay to my mcp", "paywall my mcp tools", "wrap with the factory"	solvapay/create-mcp-app
Managed MCP（ノーコード）	"no code", "managed mcp", "paste my mcp server url", "gate tools without code", "hosted no-code proxy"	Managed MCP の案内
既存アプリ／API のペイウォール	"integrate sdk", "protect api", "paywall", "usage events", "webhooks", "npx solvapay init"	solvapay/app-integration
ウェブサイトのホスト型チェックアウト	"add checkout to website", "hosted checkout", "sell access on my site"	solvapay/website-checkout
Lovable プレビューのチェックアウト	"lovable", "paste into lovable", "vite checkout", "supabase edge checkout", "@preview"	solvapay/lovable-checkout

誤ったルーティングの例

• 「古い請求データを移行したい」、「Stripe の一般的な設定だけをしたい」→ 確認を求め、自動でルーティングしないでください。
• OpenAPI／スクラッチから新規 MCP を作成する場合 → solvapay/app-integration ではなく、solvapay/create-mcp-app にルーティングします。
• MCP 以外のウェブ／API をペイウォール化する場合 → solvapay/create-mcp-app ではなく、solvapay/app-integration にルーティングします。
• ノーコード MCP／サーバー URL の貼り付け → solvapay/create-mcp-app ではなく、Managed MCP の案内を使用します。

確認用の質問

「どれをご希望ですか。（1）コードで有料 MCP サーバーを構築する（OpenAPI または手書きのツール）、（2）コンソールで Managed MCP を設定する（ノーコード。サーバー URL を貼り付けます）、（3）既存のアプリまたは API にペイウォール、使用量計測、ウェブフック、請求 UI を追加する、（4）本番ウェブアプリ向けにホスト型チェックアウトを設定する、または（5）Lovable のプレビューアプリにチェックアウトを貼り付ける、のいずれかですか。」

それでも曖昧な場合のデフォルト：新規の MCP をコードで構築する場合は solvapay/create-mcp-app、ノーコード MCP の場合は Managed MCP の案内、それ以外は solvapay/app-integration にルーティングします。

表層スキル

スキル ID	担当範囲
solvapay/create-mcp-app	コードで実装する有料 MCP — 新規ワーカー、OpenAPI→MCP、または既存 MCP サーバーへのペイウォール導入
solvapay/app-integration	既存のアプリまたは API のペイウォール、使用状況、ウェブフック、請求 UI
solvapay/website-checkout	本番ウェブアプリ向けのホスト型チェックアウト＋ポータル
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. 一致しない場合 → 再ルーティングするか、確認の質問を 1 つします。検証に合格するまで引き継がないでください。

引き継ぎテンプレート

## 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`.

この終了手順を出力したら、そこで終了してください。ワーカーのひな型を作成したり、ペイウォールのコードを書いたり、solvapay/create-mcp-app に引き継いだりしないでください。

タスクの進捗

• 主なインテントを特定する（MCP コード／Managed MCP／SDK／ウェブチェックアウト／Lovable／曖昧）
• 曖昧な場合 → 選択肢に Managed MCP と Lovable を含めて確認の質問をする
• インテントマトリックスのルーティング ID と照合するか、Managed MCP の終了手順を使用する
• 検証ループを実行する（紛らわしい不一致のケースではないことを確認）
• 対象スキルが不足している場合はインストールする（スキルがある場合のみ）
• 引き継ぎテンプレートまたは Managed MCP の終了手順を出力して終了する — その後にコードや実装手順を追加しない

開発モード（スキル作成者／内部テスト専用）

ユーザーが SolvaPay の開発用バックエンドに対するテストを明示的に行う場合は、CLI の呼び出し（npm create solvapay@latest、npx solvapay@latest init）に --dev を追加します。エンドユーザーには決して有効にしないでください。