mcpField
S
Swell MCP by usefulapi

Swell MCP by usefulapi

リモート
usefulapi.ioビジネス・マーケティング0今日更新
リポジトリ公式サイト

Swell MCP by usefulapi について

Swell MCP by usefulapi は、Swell のストア運営者向けホスト型 MCP サーバーです。商品、注文、顧客、カート、サブスクリプションを読み書きするツールを提供し、ストアの認証情報で接続します。

主な機能

  1. 01商品とカテゴリーの閲覧
  2. 02注文と顧客情報の確認
  3. 03カートとサブスクリプションの確認
  4. 04読み取り専用でコレクションを検索
  5. 05商品と注文の作成・更新

活用シーン

  1. 01注文と顧客の記録確認
  2. 02ストアのサブスクリプションと請求書の確認
  3. 03商品の追加や注文の更新

MCP 対応

MCP クライアント向けに、Swell ストアのデータと操作をツールとして提供します。ホスト型サーバーで、OAuth によるサインインとユーザーの Swell ストア ID、シークレットキーを使います。

設定

リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。

エンドポイントhttps://swell.usefulapi.io/mcp
インストールコマンドをコピー
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。

ツール

16
パラメーター型必須説明
pageintegerいいえページ番号(既定値は 1)。
sortstringいいえ並べ替え式。例:"date_created desc" または "name asc"。
limitintegerいいえ返すレコードの最大数(1–1000、Swell のデフォルトは 15)。
wherestringいいえJSON オブジェクト文字列で指定する MongoDB 形式のフィルター。例:{"active":true,"price":{"$gte":10}}。
expandstringいいえ展開する関連フィールドをカンマ区切りで指定します。例:"variants,categories"。
fieldsstringいいえ返すフィールドをカンマ区切りで指定します。例:"name,price,active"。
searchstringいいえモデルの検索可能なフィールドを対象に全文検索します。

詳細

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_productsread商品を一覧表示します
swell_get_productread商品を取得します
swell_list_categoriesreadカテゴリを一覧表示します
swell_list_ordersread注文を一覧表示します
swell_get_orderread注文を取得します
swell_list_customersread顧客を一覧表示します
swell_get_customerread顧客を取得します
swell_list_cartsreadカートを一覧表示します
swell_list_subscriptionsreadサブスクリプションを一覧表示します
swell_get_subscriptionreadサブスクリプションを取得します
swell_list_invoicesread請求書を一覧表示します
swell_list_couponsreadクーポンを一覧表示します
swell_queryread任意のコレクションをクエリします(読み取り専用)
swell_create_productwrite商品を作成します
swell_update_productwrite商品を更新します
swell_update_orderwrite注文を更新します
swell_usage_statusmeta使用状況(無料プランの利用状況)
swell_request_featuremeta不足している機能をリクエストします
swell_upgrademetaPro にアップグレードします(無制限*)
swell_cancel_subscriptionmetaPro サブスクリプションをキャンセルします

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 をご覧ください。ドキュメントのみです。サーバーはホスト型です。

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。