BlueFolder MCP by usefulapi

usefulapi の BlueFolder MCP

Claude、Cursor、または任意の MCP クライアントから、BlueFolder アカウントを利用できます。顧客、機器、サービス依頼、契約を参照したり、サービス依頼やコメントを追加したりできます。ホスト型のため、ローカルへのインストールは不要です。ご自身の認証情報で接続します。

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

接続

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

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

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

設定手順、認証情報の確認方法、よくある質問：https://usefulapi.io/bluefolder/

初回接続時に、BlueFolder API token を入力します（BlueFolder → Settings → API の Authorized API Users テーブル内にあります。API アクセスには Premium プランが必要です）。サーバーはトークンを検証し、ユーザーごとに保存します。設定ファイルにキーを記載する必要はありません。

ツール

ツール	種類	機能
bluefolder_list_customers	read	顧客の一覧を取得
bluefolder_get_customer	read	顧客を取得
bluefolder_list_service_requests	read	サービス依頼の一覧を取得
bluefolder_get_service_request	read	サービス依頼を取得
bluefolder_get_service_request_history	read	サービス依頼の履歴を取得
bluefolder_list_equipment	read	機器の一覧を取得
bluefolder_get_equipment	read	機器を取得
bluefolder_list_contracts	read	契約の一覧を取得
bluefolder_get_contract	read	契約を取得
bluefolder_list_items	read	項目の一覧を取得
bluefolder_get_item	read	項目を取得
bluefolder_list_users	read	ユーザーの一覧を取得
bluefolder_get_user	read	ユーザーを取得
bluefolder_list_tax_codes	read	税コードの一覧を取得
bluefolder_add_service_request	write	サービス依頼を作成
bluefolder_add_service_request_comment	write	サービス依頼にコメントを追加
bluefolder_add_customer_comment	write	顧客にコメントを追加
bluefolder_usage_status	meta	使用状況（無料プランの利用量メーター）
bluefolder_request_feature	meta	不足している機能をリクエスト
bluefolder_upgrade	meta	Pro にアップグレード（無制限*）
bluefolder_cancel_subscription	meta	Pro サブスクリプションをキャンセル

read ツールは読み取り専用です。write ツールはデータを変更するため、クライアント側で実行前に確認してください。meta ツールは使用状況の報告、サブスクリプションの管理、または機能リクエストの送信に使用します。

料金

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

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

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

ライセンス

MIT — LICENSE をご覧ください。ドキュメントのみです。サーバーはホストされています。