Nookal MCP by usefulapi について
Nookal MCP by usefulapiは、Nookalの診療所データを読み取るホスト型MCPサーバーです。MCPクライアントから、拠点、施術者、予約、患者、ケース、請求書の情報を扱いたいユーザー向けです。
主な機能
- 01拠点、施術者、サービス、クラスの一覧取得
- 02予約可能状況の確認
- 03予約一覧と患者検索
- 04ケース、請求書、支払い情報の取得
活用シーン
- 01拠点ごとの予約可能状況の確認
- 02患者や治療ケースの検索
- 03予約、請求書、支払い記録の確認
MCP 対応
MCPクライアントにNookalの読み取り専用ツールとメタデータツールを提供します。ユーザーのNookal API v3.0 Basic Keyとリージョンを使ってホスト型サーバーに接続します。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://nookal.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-nookal https://nookal.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-nookal":{"type":"http","url":"https://nookal.usefulapi.io/mcp"}}}Cursor で開く{"servers":{"io-usefulapi-nookal":{"type":"http","url":"https://nookal.usefulapi.io/mcp"}}}VS Code で開く{"mcpServers":{"io-usefulapi-nookal":{"type":"http","url":"https://nookal.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-nookal":{"serverUrl":"https://nookal.usefulapi.io/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
11| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| page | integer | いいえ | ページ番号(デフォルトは 1)。 |
| active | boolean | いいえ | true = 有効な所在地のみ、false = 無効な所在地のみ。 |
| page_length | integer | いいえ | 1 ページあたりの項目数。1~100(デフォルトは 50)。 |
| location_ids | array | いいえ | 指定した所在地のみ(数値の Nookal ID、最大 100 件)。 |
詳細
usefulapi の Nookal MCP
Claude、Cursor、または任意の MCP クライアントから Nookal を利用できます。Nookal の拠点、施術者、空き状況、予約、クライアント、症例、請求書を確認できます。 ホスト型のため、ローカルへのインストールは不要です。ご自身の Nookal 認証情報を使って接続します。
ライブエンドポイント: https://nookal.usefulapi.io/mcp · ホームページ: https://usefulapi.io/nookal
接続
- Claude(claude.ai、デスクトップ):Customize → Connectors を開き、+ Add → Add custom connector をクリックして、
https://nookal.usefulapi.io/mcpを貼り付けます。 - Claude Code:
claude mcp add --transport http nookal https://nookal.usefulapi.io/mcpを実行し、続いて/mcpを実行してログインします。 - VS Code: VS Code に追加。
- Cursor およびその他のクライアント: URL をリモート MCP サーバーとして追加します。
{
"mcpServers": {
"nookal": {
"url": "https://nookal.usefulapi.io/mcp"
}
}
}
URL だけを追加してください。クライアント設定に Authorization ヘッダーや API キーを追加しないでください。サーバーは OAuth でサインインし、ログインページで Nookal の認証情報を求めます。
設定手順、認証情報の確認方法、よくある質問については、https://usefulapi.io/nookal/ をご覧ください。
初回の接続時に、Nookal API v3.0 Basic Key とリージョンを入力します。 認証情報は検証され、ユーザーごとに保存され、本人にのみ適用されます。設定ファイルにキーを記載する必要はありません。
ツール
| ツール | 種別 | 機能 |
|---|---|---|
nookal_list_locations | read | 拠点の一覧を取得 |
nookal_list_staff | read | 施術者とスタッフの一覧を取得 |
nookal_list_services | read | サービス(予約種別)の一覧を取得 |
nookal_list_classes | read | クラス種別の一覧を取得 |
nookal_get_availability | read | 予約の空き状況を取得 |
nookal_list_appointments | read | 予約の一覧を取得 |
nookal_search_clients | read | クライアント(患者)を検索 |
nookal_get_client | read | クライアント(患者)を取得 |
nookal_list_cases | read | 治療症例の一覧を取得 |
nookal_list_invoices | read | 請求書の一覧を取得 |
nookal_list_payments | read | 請求書の支払いの一覧を取得 |
nookal_usage_status | meta | 利用状況(無料プランの利用量)を確認 |
nookal_request_feature | meta | 不足している機能をリクエスト |
nookal_upgrade | meta | Pro にアップグレード(無制限*) |
nookal_cancel_subscription | meta | Pro サブスクリプションをキャンセル |
read ツールは読み取り専用です。write ツールはデータを変更するため、クライアント側で確認が必要です。meta ツールは利用状況の報告、サブスクリプションの管理、または機能リクエストの送信を行います。
料金
| プラン | 料金 | 上限 |
|---|---|---|
| 無料 | $0 | 月50回のツール呼び出し |
| Pro(ユーザー単位) | $9/mo または $90/yr(2か月分無料) | 無制限* |
*Pro には、このサーバーで月10,000回のツール呼び出しという公正利用上限があります。それ以上必要な場合は、[email protected] までご連絡ください。
Pro が適用されるのはこのサーバーのみです。nookal_upgrade を使って登録してください(Stripe Checkout のリンクが返されます)。nookal_cancel_subscription でいつでもキャンセルできます。Pro は支払い済み期間の終了まで利用でき、現在の期間分の返金はありません。また、その期間が終わる前に nookal_upgrade を実行すると、キャンセルが取り消されます。[email protected] へのご連絡でも手続きできます。
ライセンス
MIT © usefulapi。Nookal とは提携しておらず、Nookal の推奨を受けたものでもありません。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。