設定、AI、API

Settings は、Owner と Admin が診療所全体の Genkō の挙動を定義する場所です。高度な AI 機能や MCP API もここで設定します。

Settings にあるもの

主な領域は通常次のとおりです。

  • Practice profile: 組織情報
  • Services: 予約タイプと所要時間
  • Members: 招待とロール管理
  • Portal: セルフ予約設定
  • Integrations: Google Calendar、API キー、AI 設定
  • Billing: プラン管理

日々の操作が別ページで行われていても、実際の運用設定の多くは最終的に Settings を経由します。

ダッシュボード AI アシスタント

Practice プラン以上では、Genkō に組み込みの AI アシスタントをダッシュボード上に表示できます。

有効にすると:

  • ダッシュボードにフローティングチャットウィジェットが表示される
  • 使用できるのは Owner と Admin のみ
  • 内部ツール層を使って、運用上の質問への回答やアクション実行ができる

例:

  • 「今日の次の患者は誰ですか？」
  • 「この患者の今月の予約をすべて見つけて」
  • 「金曜日にこのプロバイダーで空いている時間は？」
  • 「この予約を別の時間に変更して」

Settings → Integrations の Dashboard AI Assistant から有効にできます。

MCP API とは何か

Genkō は、外部の AI エージェントやツール向けに Model Context Protocol (MCP) サーバーを提供しています。

これにより、対応クライアントはスクリーンスクレイピングや場当たり的な連携ではなく、構造化されたツール呼び出しで Genkō のデータを扱えます。

MCP エンドポイント:

https://www.getgenko.com/api/mcp

MCP のプラン別アクセス

プラン MCP アクセス
Group 読み取り専用、キー 1 個
Practice 以上 読み取り + 書き込み、キー 3 個
Enterprise 全スコープ、キー無制限

API キーは Settings → Integrations → API Access (MCP) で作成します。

クイックスタート

  1. Settings → Integrations を開く
  2. MCP キーを追加する
  3. キー名とスコープを設定する
  4. キーは一度しか表示されないので、その場でコピーする
  5. MCP クライアントで Bearer トークンとして使う

設定例:

{
  "mcpServers": {
    "genko": {
      "url": "https://www.getgenko.com/api/mcp",
      "headers": {
        "Authorization": "Bearer genko_YOUR_KEY_HERE"
      }
    }
  }
}

認証とスコープ

すべての MCP リクエストには次を含める必要があります。

Authorization: Bearer genko_...

利用可能なスコープ:

  • Read: 一覧取得・参照ツール
  • Read + Write: 作成・更新アクション
  • Admin: Enterprise 向けの最も広い権限

キーはいつでも失効できます。失効は新しいリクエストに対して即時に反映されます。

利用可能な MCP ツール

読み取りツール

  • list_appointments
  • get_appointment
  • list_patients
  • get_patient
  • list_providers
  • get_provider
  • list_appointment_types
  • check_availability

書き込みツール

  • create_appointment
  • update_appointment
  • cancel_appointment
  • create_patient
  • update_patient
  • find_or_create_patient

予約の作成・更新ではサーバー側で競合チェックが実行されるため、MCP クライアントが静かに二重予約を作ることはできません。

レート制限

MCP キーはキーごとに 60 秒単位のレート制限があります。

  • デフォルト制限: 1 分あたり 100 リクエスト
  • 超過時: HTTP 429 Too Many Requests
  • Enterprise: hello@getgenko.com への依頼で上限引き上げ可能

過去 7 日間の利用量は、Integrations パネルで各キーの横に表示されます。

AI 機能の境界

ダッシュボード AI アシスタントはスタッフ向けで、現在のセッションを自動的に使います。患者向け AI フロー（例: WhatsApp AI スケジューラ）とは別物です。

この違いは重要です。

  • Dashboard AI はスタッフを支援する
  • 患者向け AI はコミュニケーションチャネルや予約フローを通じて患者を支援する

関連ガイド