stablevoy-mcp

stablevoy-mcp

Stablevoy のための MCP サーバーです。Stablevoy は、ノンカストディアル型の USDT および USDC 決済ゲートウェイです。すべてのストアを対象に、AI アシスタントに請求書の発行や、請求書の支払い状況の確認、週ごとの集計を依頼できます。

• 「Acme に 10 月の作業分として 250 ドル請求して」と頼むと、支払いリンクが発行されます。
• 「Acme は支払いましたか？」と尋ねると、状況と取引が表示されます。
• 「Main ストアの今週の入金額は？」と尋ねると、一覧が表示されます。

Claude Desktop、Claude Code、Cursor、および Model Context Protocol に対応するすべてのクライアントで動作します。お使いのコンピューター上で実行され、Stablevoy API とのみ通信します。

できること、できないこと

このサーバーが保持するのは、ストアの API キーだけです。これらのキーを使って、入金を受け取るための請求書を作成したり、未払いの請求書をキャンセルしたり、ストアや請求書を読み取ったりできます。資金の移動、出金先アドレス、Webhook、上限、キー、ストアの変更はできません。これらの操作には、Stablevoy ダッシュボードでウォレットによる署名が必要です。Stablevoy が資金を預かることはないため、出金するものはありません。

そのため、悪意のあるウェブページやドキュメントにだまされたアシスタントであっても、できるのは、自分に入金される請求書の作成、未払いの請求書のキャンセル（購入者には支払わないよう通知され、ショップには invoice.cancelled Webhook が送信されます）、および請求書の読み取りだけです。実際のリスクは読み取りです。請求金額と参照情報が漏れる可能性があります。信頼できないコンテンツも読み取るアシスタントにサーバーを接続する前に、この点に留意してください。または、読み取り専用で実行してください（下記）。

接続

Node.js 22.12 以降が必要です。

npx stablevoy-mcp login

ブラウザーで Stablevoy ダッシュボードが開きます。ウォレットでサインインし、アシスタントが使用できるストアにチェックを入れて承認してください。ブラウザーから、このコンピューター上のコマンドに一度だけ使えるコードが渡されます。コマンドはそのコードを使って、ストアごとに 1 つの API キーと交換し、設定フォルダー（Linux では ~/.config/stablevoy-mcp、macOS では ~/Library/Application Support/stablevoy-mcp、Windows では %APPDATA%\stablevoy-mcp）にキーを保存します。このフォルダーを読み取れるのは、あなたのみです。キーはダッシュボードのストアページに「MCP (your computer)」という名前で表示され、いつでも取り消せます。

次に、サーバーをクライアントに追加します。

Claude Desktop（claude_desktop_config.json）、Cursor（.cursor/mcp.json）およびほとんどのクライアントの場合：

{
  "mcpServers": {
    "stablevoy": { "command": "npx", "args": ["-y", "stablevoy-mcp"] }
  }
}

Claude Code の場合：

claude mcp add stablevoy -- npx -y stablevoy-mcp

ログインせずに 1 つのストアを使う

ダッシュボードのストアページでキーを作成し、代わりにそのキーを渡します。

{
  "mcpServers": {
    "stablevoy": { "command": "npx", "args": ["-y", "stablevoy-mcp"], "env": { "STABLEVOY_API_KEY": "sk_live_..." } }
  }
}

読み取り専用

"STABLEVOY_MCP_READ_ONLY": "true" を env に追加すると、create_invoice と cancel_invoice は提供されなくなります。

ストアの変更

• npx stablevoy-mcp login を再度実行すると、このコンピューターのストアにチェックが入っています。外すストアのチェックを外してください。そのストアのキーは取り消され、新しい選択内容で置き換えられます。
• npx stablevoy-mcp stores を実行すると、このコンピューターのストアが一覧表示されます。npx stablevoy-mcp stores remove "Main" を実行すると、1 つのストアが削除され、そのキーが取り消されます。
• npx stablevoy-mcp logout を実行すると、このコンピューターのすべてのキーが取り消され、ファイルが削除されます。

ストアの追加にはウォレットが必要なため、必ずブラウザーを使用します。アシスタントがストアの設定を変更することはできません。複数のアカウントや設定を使う場合は、これらのコマンドに --profile work を指定し、クライアント設定に "STABLEVOY_MCP_PROFILE": "work" を追加してください。

ツール

ツール	内容
list_stores	接続されているストア、それぞれが支払いを受け付けられるかどうか、およびEVMの出金状況を取得します。
get_store	ストアの設定を取得します。ネットワーク、出金先アドレス、EVMの出金状況、請求書の上限、手数料、ウェブサイト、戻り先URL、Webhook URLが含まれます。読み取り専用です。
create_invoice	金額をドルで指定した請求書（「19.99」など）を作成します。参照情報、戻り先URL、支払い期限（expiresInMinutes、15～10080分。省略した場合はストアの既定値）を任意で指定できます。購入者に自分で送る支払いリンクが返されます。同じ金額と参照情報を指定すると、2件目の請求書を作成せず、同じ請求書が返されます。
cancel_invoice	支払いが確認されていない請求書をキャンセルし、購入者に支払わないよう伝えます。その後に届いた資金は、支払い済み（paid_late）として記録されます。
get_invoice	IDで請求書を取得し、受け取った支払いを表示します。
list_invoices	新しい順に請求書を一覧表示します。ステータス、ソース、検索語、作成からの日数で絞り込めます。

複数のストアがある場合、ツールはstore引数（IDまたはlist_storesに表示される正確な名前）を受け取ります。サーバーは推測せず、指定を求めます。

設定

変数	意味
STABLEVOY_API_KEY	1つのストアキーです。設定されている場合、ログインキーは使用されません。
STABLEVOY_MCP_PROFILE	使用するログインプロファイルです。既定値はdefaultです。
STABLEVOY_MCP_READ_ONLY	trueの場合、create_invoiceとcancel_invoiceは利用できません。
STABLEVOY_API_URL	APIのURLです。既定値はhttps://api.stablevoy.comです。

ライセンス

MIT