Halaxy MCP by usefulapi

usefulapi の Halaxy MCP

ライブエンドポイント： https://halaxy.usefulapi.io/mcp

接続

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

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

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

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

初回接続時に、Halaxy Client ID と Client Secret を貼り付けます。これらは検証され、ユーザーごとに保存され、本人のみに適用されます。設定ファイルにキーを記載する必要はありません。

ツール

ツール	種類	機能
halaxy_list_patients	read	患者を一覧表示または検索
halaxy_list_practitioners	read	施術者を一覧表示
halaxy_list_practitioner_roles	read	施術者の役割（クリニックの所在地）を一覧表示
halaxy_list_organizations	read	組織とクリニックを一覧表示
halaxy_list_appointments	read	予約を一覧表示
halaxy_list_schedules	read	施術者のスケジュールを一覧表示
halaxy_list_slots	read	時間枠を一覧表示
halaxy_list_healthcare_services	read	予約の種類を一覧表示
halaxy_list_fees	read	料金を一覧表示
halaxy_list_coverage	read	患者の保険適用範囲（請求の詳細）を一覧表示
halaxy_list_invoices	read	請求書を一覧表示
halaxy_list_invoice_lines	read	請求書の明細を一覧表示
halaxy_list_payment_transactions	read	支払い取引を一覧表示
halaxy_list_referrals	read	紹介状を一覧表示
halaxy_list_referral_definitions	read	紹介状テンプレートを一覧表示
halaxy_get_patient	read	患者を取得
halaxy_get_practitioner	read	施術者を取得
halaxy_get_practitioner_role	read	施術者の役割を取得
halaxy_get_organization	read	組織を取得
halaxy_get_appointment	read	予約を取得
halaxy_get_schedule	read	スケジュールを取得
halaxy_get_slot	read	時間枠を取得
halaxy_get_healthcare_service	read	予約の種類を取得
halaxy_get_fee	read	料金を取得
halaxy_get_coverage	read	患者の保険適用範囲を取得
halaxy_get_invoice	read	請求書を取得
halaxy_get_invoice_line	read	請求書の明細を取得
halaxy_get_payment_transaction	read	支払い取引を取得
halaxy_get_referral	read	紹介状を取得
halaxy_get_referral_definition	read	紹介状テンプレートを取得
halaxy_find_available_appointments	read	予約可能な時間を検索
halaxy_create_patient	write	患者を作成
halaxy_create_appointment	write	予約を登録
halaxy_update_appointment_status	write	予約のステータスを更新
halaxy_create_clinical_note	write	臨床記録の下書きを作成
halaxy_usage_status	meta	使用状況（無料プランの利用状況メーター）
halaxy_request_feature	meta	不足している機能をリクエスト
halaxy_upgrade	meta	Pro にアップグレード（無制限*）
halaxy_cancel_subscription	meta	Pro サブスクリプションをキャンセル

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

料金

プラン	料金	上限
無料	$0	月50回のツール呼び出し
Pro（アカウントごと）	$9/月 または $90/年（2か月分無料）	無制限*

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

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

ライセンス

MIT