Swell MCP by usefulapi について
Swell MCP by usefulapi は、Swell のストア運営者向けホスト型 MCP サーバーです。商品、注文、顧客、カート、サブスクリプションを読み書きするツールを提供し、ストアの認証情報で接続します。
主な機能
- 01商品とカテゴリーの閲覧
- 02注文と顧客情報の確認
- 03カートとサブスクリプションの確認
- 04読み取り専用でコレクションを検索
- 05商品と注文の作成・更新
活用シーン
- 01注文と顧客の記録確認
- 02ストアのサブスクリプションと請求書の確認
- 03商品の追加や注文の更新
MCP 対応
MCP クライアント向けに、Swell ストアのデータと操作をツールとして提供します。ホスト型サーバーで、OAuth によるサインインとユーザーの Swell ストア ID、シークレットキーを使います。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://swell.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-swell https://swell.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-swell":{"type":"http","url":"https://swell.usefulapi.io/mcp"}}}Cursor で開く{"servers":{"io-usefulapi-swell":{"type":"http","url":"https://swell.usefulapi.io/mcp"}}}VS Code で開く{"mcpServers":{"io-usefulapi-swell":{"type":"http","url":"https://swell.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-swell":{"serverUrl":"https://swell.usefulapi.io/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
16| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| page | integer | いいえ | ページ番号(既定値は 1)。 |
| sort | string | いいえ | 並べ替え式。例:"date_created desc" または "name asc"。 |
| limit | integer | いいえ | 返すレコードの最大数(1–1000、Swell のデフォルトは 15)。 |
| where | string | いいえ | JSON オブジェクト文字列で指定する MongoDB 形式のフィルター。例:{"active":true,"price":{"$gte":10}}。 |
| expand | string | いいえ | 展開する関連フィールドをカンマ区切りで指定します。例:"variants,categories"。 |
| fields | string | いいえ | 返すフィールドをカンマ区切りで指定します。例:"name,price,active"。 |
| search | string | いいえ | モデルの検索可能なフィールドを対象に全文検索します。 |
詳細
usefulapi の Swell MCP
Claude、Cursor、または任意の MCP クライアントから、Swell のヘッドレスコマースストア(商品、注文、顧客、サブスクリプション)を管理できます。ホスト型のため、ローカルへのインストールは不要です。Swell のストア ID とシークレットキーを使って接続します。
ライブエンドポイント: https://swell.usefulapi.io/mcp · ホームページ: https://usefulapi.io/swell
接続
- Claude(claude.ai、Desktop):Customize → Connectors を開き、+ Add → Add custom connector をクリックして、
https://swell.usefulapi.io/mcpを貼り付けます。 - Claude Code:
claude mcp add --transport http swell https://swell.usefulapi.io/mcpを実行し、続けて/mcpを実行してログインします。 - VS Code: VS Code に追加。
- Cursor およびその他のクライアント: URL をリモート MCP サーバーとして追加します。
{
"mcpServers": {
"swell": {
"url": "https://swell.usefulapi.io/mcp"
}
}
}
URL のみを追加してください。クライアント設定に Authorization ヘッダーや API キーを追加しないでください。サーバーが OAuth でログイン処理を行い、ログインページで Swell の認証情報を求められます。
設定手順、認証情報の確認方法、よくある質問:https://usefulapi.io/swell/
初回接続時に、Swell のストア ID とシークレットキーを貼り付けます。認証情報は検証され、ユーザーごとに保存され、自分専用のものとして管理されます。
ツール
| ツール | 種類 | 機能 |
|---|---|---|
swell_list_products | read | 商品を一覧表示します |
swell_get_product | read | 商品を取得します |
swell_list_categories | read | カテゴリを一覧表示します |
swell_list_orders | read | 注文を一覧表示します |
swell_get_order | read | 注文を取得します |
swell_list_customers | read | 顧客を一覧表示します |
swell_get_customer | read | 顧客を取得します |
swell_list_carts | read | カートを一覧表示します |
swell_list_subscriptions | read | サブスクリプションを一覧表示します |
swell_get_subscription | read | サブスクリプションを取得します |
swell_list_invoices | read | 請求書を一覧表示します |
swell_list_coupons | read | クーポンを一覧表示します |
swell_query | read | 任意のコレクションをクエリします(読み取り専用) |
swell_create_product | write | 商品を作成します |
swell_update_product | write | 商品を更新します |
swell_update_order | write | 注文を更新します |
swell_usage_status | meta | 使用状況(無料プランの利用状況) |
swell_request_feature | meta | 不足している機能をリクエストします |
swell_upgrade | meta | Pro にアップグレードします(無制限*) |
swell_cancel_subscription | meta | Pro サブスクリプションをキャンセルします |
read ツールは読み取り専用です。write ツールはデータを変更するため、クライアント側で確認が必要です。meta ツールは使用状況の報告、サブスクリプションの管理、機能リクエストの送信を行います。
料金
| プラン | 料金 | 上限 |
|---|---|---|
| Free | $0 | 月50回のツール呼び出し |
| Pro | $9/mo または $90/yr(2か月分無料) | 無制限* |
*Pro には、このサーバーで月10,000回のツール呼び出しという適正利用上限があります。それ以上をご希望の場合は、[email protected] までお問い合わせください。
Pro の対象はこのサーバーのみです。swell_upgrade で登録してください(Stripe Checkout のリンクが返されます)。swell_cancel_subscription でいつでもキャンセルできます。Pro は支払い済み期間の終了まで継続し、現在の期間分の返金はありません。期間終了前に swell_upgrade を実行すると、キャンセルが取り消されます。または [email protected] までお問い合わせください。
ライセンス
MIT — LICENSE をご覧ください。ドキュメントのみです。サーバーはホスト型です。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。