Bsale MCP by usefulapi

usefulapi による Bsale MCP

Bsale の商品、書類、在庫の確認に加え、顧客、価格、レシート、支払いを管理できます。

接続

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

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

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

詳しいセットアップ手順、認証情報の確認方法、よくある質問：https://usefulapi.io/bsale/

ツール

ツール	種類	機能
bsale_list_documents	読み取り	書類（売上）を一覧表示
bsale_get_document	読み取り	書類を取得
bsale_sales_summary	読み取り	売上概要
bsale_list_returns	読み取り	返品を一覧表示
bsale_list_document_types	読み取り	書類の種類を一覧表示
bsale_list_clients	読み取り	顧客を一覧表示
bsale_get_client	読み取り	顧客を取得
bsale_client_unpaid_documents	読み取り	顧客の未払い書類
bsale_list_products	読み取り	商品を一覧表示
bsale_get_product	読み取り	商品を取得
bsale_list_variants	読み取り	バリアント（SKU）を一覧表示
bsale_get_variant	読み取り	バリアントを取得
bsale_list_stocks	読み取り	在庫数を一覧表示
bsale_list_price_lists	読み取り	価格表を一覧表示
bsale_list_price_list_details	読み取り	価格表の価格を一覧表示
bsale_list_payments	読み取り	支払いを一覧表示
bsale_list_payment_types	読み取り	支払い方法を一覧表示
bsale_list_offices	読み取り	オフィス（支店）を一覧表示
bsale_list_users	読み取り	ユーザー（販売担当者）を一覧表示
bsale_user_sales_summary	読み取り	販売担当者別の売上
bsale_create_client	書き込み	顧客を作成
bsale_update_client	書き込み	顧客を更新
bsale_update_price	書き込み	価格表の価格を更新
bsale_create_stock_reception	書き込み	在庫を受け入れ
bsale_create_payment	書き込み	支払いを記録
bsale_usage_status	メタ	使用状況（無料プランの利用状況）
bsale_request_feature	メタ	不足している機能をリクエスト
bsale_upgrade	メタ	Pro または Pro+ にアップグレード
bsale_cancel_subscription	メタ	Pro サブスクリプションをキャンセル

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

料金

プラン	料金	上限
Free	$0	月50回のツール呼び出し
Pro（Bsale の会社および API ホストごと）	$9/mo または $90/yr（2か月分無料）	無制限*

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

Pro の対象はこのサーバーのみです。bsale_upgrade で登録してください（Stripe Checkout のリンクが返されます）。bsale_cancel_subscription でいつでもキャンセルできます。Pro は支払い済み期間の終了まで継続し、現期間分の返金はありません。その前に bsale_upgrade を実行すると、キャンセルが取り消されます。または、[email protected] までご連絡ください。

ライセンス

MIT