IntakeQ MCP

@oktopeak/intakeq-mcp

Oktopeak が開発 — 医療機関向けの AI トランスフォーメーションと自動化

医療・法律関連事業のデジタルトランスフォーメーション。 医療機関が完全に所有できる AI 連携、ワークフロー自動化、カスタムソフトウェアを構築します。このコネクターもその一つです。→ 30 分の相談を予約

Claude 用の IntakeQ/PracticeQ MCP コネクターです。Model Context Protocol を通じて、Claude が IntakeQ のスケジュール管理、受付フォーム、治療記録、請求書、クライアント記録にアクセスできるようにします。

PHI の読み取りと書き込みはすべて、HIPAA §164.312(b) に準拠してローカルに記録されます。

---

⚠️ 実際の患者データに接続する前に

このコネクターを通じて PHI をやり取りする前に、次の 2 つを整えてください。

1. IntakeQ の BAA — IntakeQ/PracticeQ には業務提携契約（BAA）が含まれています。 本番環境で使用する前に、IntakeQ アカウント（Settings → HIPAA）で署名してください。 これは IntakeQ の強みの一つです。BAA はセルフサービスで利用でき、すべてのプランに含まれています。

2. ZDR を含む Anthropic エンタープライズプラン — ホスト型 Claude + MCP を使用すると、推論のために PHI が Anthropic に送信されます。正当に主張できるのはエンタープライズプラン + BAA のもとでの学習無効化とゼロデータ保持であり、データの所在地ではありません。「アクセス」（モデルがデータを処理したこと）がリスクであり、保持だけが問題ではありません。 実際の患者に使用する前に、Anthropic エンタープライズに申し込み、BAA を依頼してください。

このコネクターの機能：

• IntakeQ REST API への認証済み呼び出しを仲介します
• PHI の読み取りと書き込みをすべて ~/.intakeq-mcp/audit.log に記録します（HIPAA §164.312(b)）
• API キーをローカルで暗号化して保存します（AES-256-GCM）。PHI の内容は保存されません（監査記録に含まれるのはアクセス履歴の識別子のみです）

---

インストール

npm install -g @oktopeak/intakeq-mcp

Claude Desktop の設定

{
  "mcpServers": {
    "intakeq": {
      "command": "intakeq-mcp"
    }
  }
}

認証

IntakeQ で API キーを生成します：Settings → Integrations → Developer API

次に、Claude に次のように伝えます：

「IntakeQ の API キーを [your-key] に設定して」

または、MCP ツールを直接使用します：set_api_key

ツール

ツール	説明	読み取り／書き込み
set_api_key	IntakeQ API キーを保存	書き込み
auth_status	API 接続を確認	読み取り
clear_api_key	保存したキーを削除	書き込み
list_clients	クライアントを検索／一覧表示	読み取り
get_client	個別のクライアントプロフィール	読み取り
list_practitioners	アカウント内のすべての施術者	読み取り
list_services	アカウントに設定されているサービス	読み取り
list_locations	アカウントに設定されている所在地	読み取り
list_appointments	クライアント／日付ごとの予約	読み取り
get_appointment	個別の予約	読み取り
create_appointment	予約を登録	書き込み
update_appointment	予約を変更／更新	書き込み
list_intake_forms	提出済み受付フォーム	読み取り
get_form	回答を含むフォーム全体	読み取り
list_questionnaire_templates	利用可能なフォームテンプレート	読み取り
send_intake_form	クライアントにフォームを送信	書き込み
list_notes	治療記録（IntakeQ API では読み取り専用）	読み取り
get_note	記録全体	読み取り
list_invoices	クライアントの請求書	読み取り
get_invoice	個別の請求書	読み取り
list_files	クライアントファイルのメタデータ	読み取り
audit_export	HIPAA 監査証跡をエクスポート	読み取り

ヒント： create_appointment が必要とする有効な ID を取得するため、実行前に list_practitioners、list_services、list_locations を呼び出してください。

MCP リソース

リソース URI	説明
intakeq://compliance-notice	HIPAA コンプライアンス通知 — BAA の要件とコネクターの記録内容
intakeq://auth-status	認証のライブステータス（JSON）

HIPAA 監査ログ

PHI の読み取りと書き込みはすべて ~/.intakeq-mcp/audit.log に追記されます（JSONL 形式）。 各エントリーには、タイムスタンプ、セッション ID、マシンの IP アドレス、ツール名、引数（サニタイズ済み）、 結果、施術者 ID、クライアント ID、結果件数が記録されます。

いつでも Claude に audit_export の実行を依頼して、監査ログをエクスポートできます。

監査ログの記録はフェイルオープンです。 ログファイルに書き込めない場合（ディスク容量不足、権限の問題など）でも、 臨床業務を妨げないよう、ツール呼び出しは完了します。失敗は [audit-log-failure] というプレフィックス付きで stderr に出力されるため、 監視やアラートの対象にできます。PHI へのアクセスを必ずログに記録する必要がある場合は、 デプロイ環境でこのプレフィックスを含むプロセスの stderr を監視してください。

HTTP トランスポート

サーバーはデフォルトで stdio モードで動作します。HTTP サーバーとして実行する場合（複数ユーザーまたはリモート環境でのデプロイなど）：

MCP_API_KEY=your-secret TRANSPORT=http PORT=3000 intakeq-mcp

MCP エンドポイントは /mcp にあり、必須の Bearer トークン（MCP_API_KEY）で保護されています。認証されていないエンドポイントからは、ポートにアクセスできる誰もがすべての PHI ツールを利用できてしまうため、MCP_API_KEY が設定されていない状態では、サーバーは HTTP モードでの起動を拒否します。 ローカル開発に限り、認証なしのエンドポイントを明示的に許可するには MCP_ALLOW_NO_AUTH=true を設定してください。実際の患者データを扱う場合は、絶対に設定しないでください。

HTTP トランスポート自体は TLS を終端しません。HTTPS を終端するリバースプロキシ（nginx、Caddy、クラウドプロバイダーのロードバランサーなど）の背後で実行してください。そうしないと、Bearer トークンと転送中のすべての PHI がネットワーク上で平文のまま送信されます。

各 HTTP セッションは独自の API キーをメモリ上で管理します。set_api_key ツールで設定したキーはセッション内でのみ有効となり、共有ディスクファイルには書き込まれません。セッションは 24 時間後にガベージコレクションされます。

ヘルスチェック：GET /health → { "ok": true, "sessions": <count> }

環境変数

変数	デフォルト	説明
INTAKEQ_API_KEY	—	CI／ヘッドレス環境で使用するフォールバック API キー（set_api_key ツールの使用を推奨）
INTAKEQ_API_BASE	https://intakeq.com/api/v1	IntakeQ API のベース URL を上書きします
TRANSPORT	stdio	トランスポートモード：stdio または http
PORT	3000	HTTP サーバーのポート（HTTP モードのみ）
MCP_BASE_URL	http://127.0.0.1:3000	HTTP 起動ログに出力するベース URL
MCP_API_KEY	—	HTTP /mcp エンドポイントを保護する Bearer トークン。HTTP モードでは、MCP_ALLOW_NO_AUTH=true の場合を除き必須です
MCP_ALLOW_NO_AUTH	—	true に設定すると、MCP_API_KEY なしで HTTP モードを明示的に許可します（ローカル開発のみ）

レート制限

IntakeQ では約 10 リクエスト／分の制限が適用されます。このコネクターは HTTP 429 の場合に自動で再試行します（最大 3 回、バックオフ間隔は 10 秒／20 秒／30 秒）。3 回失敗すると、無期限に待機せずエラーを返します。

未対応の機能

• 保険請求／CMS-1500 の書き込み
• Webhook
• 一括操作
• 治療記録の作成（IntakeQ API では利用できません）

Oktopeak が提供するその他のオープンソースコネクター

同じアーキテクチャ（暗号化されたキーの保存、監査ログ、レート制限）を使用し、異なるプラットフォームに対応しています：

• Clio MCP — Claude と Clio の業務管理（@oktopeak/clio-mcp）
• MyCase MCP — Claude と MyCase の法律業務管理（@oktopeak/mycase-mcp）
• Filevine MCP — Claude と Filevine の業務管理（@oktopeak/filevine-mcp）

このプロジェクトを支援する

このコネクターは無料で、MIT ライセンスのもとで提供されており、Oktopeak が保守しています。今後も変わりません。寄付は受け付けていません。時間の節約に役立った場合、実際に支援となるのは次のことです。

• このリポジトリにスターを付けてください。 他の事務所がこのプロジェクトを見つけるきっかけとして、本当に役立っています。
• IntakeQ を利用している別の事務所に紹介してください。
• 直接お役に立てた場合は、レビューを投稿してください。
• 貴事務所向けの導入、拡張、保守が必要ですか？ 商用サポート — 無料の取り組みを支えているのは、こちらのサービスです。
• 事務所全体への導入： Claude とこのコネクターを事務所全体に展開する場合（Claude Cowork、複数ユーザー、セキュリティレビューなど）は、事務所への導入をご覧ください。

私たちについて

Oktopeak — 医療機関や法律事務所のデジタルトランスフォーメーションを支援します。

私たちは、規制の厳しい業界向けに AI ソリューションを構築する、社内の 7 人体制のプロダクトチームです。AI 統合、ワークフローの自動化、そしてお客様が完全に所有できるカスタムソフトウェアを提供しています。4 つのオープンソース MCP コネクター（Clio、MyCase、Filevine、および IntakeQ）を保守し、権限を限定した認証情報、監査ログ、そしてチームの実際の業務に合わせて構築したワークフローとともに、実際の事務所に導入しています。

• 🌐 oktopeak.com
• 📅 30 分の相談を予約
• ✉️ [email protected] — セキュリティに関する報告を歓迎します
• 💼 LinkedIn