Smile.io MCP by usefulapi

usefulapi による Smile.io MCP

Claude、Cursor、または任意の MCP クライアントから Smile.io を利用できます。ロイヤルティプログラムの顧客、ポイント残高と履歴、ポイントの獲得方法と交換方法、発行済み特典や VIP ティアを確認し、ポイントを調整できます。 ホスト型のため、ローカルへのインストールは不要です。ご自身の Smile.io 認証情報を使って接続できます。

ライブエンドポイント： https://smile-io.usefulapi.io/mcp · ホームページ： https://usefulapi.io/smile-io

接続

• Claude（claude.ai、デスクトップ）：Customize → Connectors を開き、+ Add → Add custom connector をクリックして、https://smile-io.usefulapi.io/mcp を貼り付けます。
• Claude Code： claude mcp add --transport http smile-io https://smile-io.usefulapi.io/mcp を実行してから、/mcp を実行してログインします。
• VS Code： VS Code に追加。
• Cursor およびその他のクライアント： URL をリモート MCP サーバーとして追加します。

{
  "mcpServers": {
    "smile-io": {
      "url": "https://smile-io.usefulapi.io/mcp"
    }
  }
}

URL のみを追加してください。クライアント設定に Authorization ヘッダーや API キーを追加しないでください。サーバーが OAuth でサインインし、ログインページで Smile.io の認証情報を求めます。

手順に沿ったセットアップ、認証情報の確認方法、よくある質問：https://usefulapi.io/smile-io/

初回接続時に、Smile.io マーチャント API キー（Smile Admin → Settings → Developer tools → API keys）を入力します。 キーは検証され、ユーザーごとに保存され、本人にのみ適用されます。設定ファイルにキーを記載する必要はありません。

ツール

ツール	種類	機能
smile_list_customers	read	顧客の一覧を取得
smile_get_customer	read	顧客を取得
smile_list_points_transactions	read	ポイント取引の一覧を取得
smile_get_points_transaction	read	ポイント取引を取得
smile_list_points_products	read	ポイント商品（交換方法）の一覧を取得
smile_get_points_product	read	ポイント商品を取得
smile_list_reward_fulfillments	read	特典の引き渡しの一覧を取得
smile_list_earning_rules	read	獲得ルール（ポイントの獲得方法）の一覧を取得
smile_list_vip_tiers	read	VIP ティアの一覧を取得
smile_get_points_settings	read	ポイント設定を取得
smile_get_referral_settings	read	紹介設定を取得
smile_create_points_transaction	write	顧客のポイント残高を調整
smile_create_activity	write	顧客のアクティビティを記録
smile_purchase_points_product	write	顧客のポイントを特典と交換
smile_usage_status	meta	使用状況（無料プランの利用状況）
smile_request_feature	meta	不足している機能をリクエスト
smile_upgrade	meta	Pro にアップグレード（無制限*）
smile_cancel_subscription	meta	Pro サブスクリプションを解約

read ツールは読み取り専用です。write ツールはデータを変更します（クライアント側で確認が必要です）。meta ツールは使用状況の報告、サブスクリプションの管理、機能リクエストの送信を行います。

料金

プラン	料金	制限
Free	$0	月 50 回のツール呼び出し
Pro（ユーザー単位）	$9/mo または $90/yr（2 か月分無料）	無制限*

*Pro には、このサーバーで月 10,000 回のツール呼び出しという公正利用の上限があります。それ以上必要な場合は、[email protected] までご連絡ください。

Pro の対象はこのサーバーのみです。smile_upgrade で登録できます（Stripe Checkout のリンクが返されます）。smile_cancel_subscription でいつでも解約できます。Pro は支払い済み期間の終了まで利用でき、現在の期間分の返金はありません。終了前に smile_upgrade を実行すると、解約は取り消されます。または、[email protected] までご連絡ください。

ライセンス

MIT © usefulapi。Smile.io とは提携しておらず、Smile.io による推奨も受けていません。