クラウド版 ORCA とつなぐ（AI エージェントに任せる）

ORCA には、院内に置くオンプレ版と、インターネットの向こうにあるクラウド版（WebORCA クラウド）があります。DoctorAssist と ORCA がやりとりする API の中身はどちらも同じですが、クラウド版はつなぎ方が違います。

この直しは、医師が自分で FileMaker のスクリプトを書き換えるより、AI エージェント（FileMaker に接続できる Claude Code など）に任せるのが早く確実です。この記事では、オンプレ版との違いと、AI エージェントにそのまま渡せるプロンプト（指示文）を載せます。

クラウド版との通信は、作者の環境ではまだ試していません（テストはオンプレ版で行いました）。下の内容は ORCA 管理機構の公開資料をもとにしています。つながったら、この記事を書き直します。

1. オンプレ版とクラウド版の違い

オンプレ版（院内） クラウド版
つなぎ先 院内の日レセの PC（例 http://192.168.11.42:8000/api/） https://weborca.cloud.orcamo.jp/api/
パスの欄 日レセのパスワード API キー（システム管理サイトで確認）
クライアント証明書 要らない 要る（有効期間 3年）
送るもの（API） 同じ（患者の受け取り、中途データの送信）

2. ブラウザの証明書は FileMaker では使えない

施設のパソコンのブラウザで日レセが開けていても、それだけでは DoctorAssist はつながりません。日レセの画面は、ブラウザが自分で証明書を出してつないでいます。DoctorAssist は FileMaker の「URL から挿入」という別の通り道で通信するので、ブラウザやパソコンに入っている証明書を使いません。

そのため、証明書のファイルを FileMaker に持たせて、通信のたびに渡す仕組みが必要です。今の DoctorAssist にはこれがないので、AI エージェントに作ってもらいます。

3. 先に用意するもの（医師・施設がすること）

  • WebORCA クラウド版の契約（施設がすでに使っていれば、それを使います）
  • クライアント証明書のファイルと、そのパスフレーズ（ORCA 管理機構・導入業者から受け取ったもの）
  • API を使うユーザー ID と API キー
  • FileMaker Cloud のバックアップ（作業の直前に取る）
  • FileMaker に接続できる AI エージェント（例：Claude Code と ProofKit MCP）

証明書・API キー・パスフレーズ・パスワードは、AI エージェントに見せないでください。チャットに書かず、FileMaker の欄には自分で入れます。本物の患者のデータでは試さず、架空の患者で試します。

4. AI エージェントに渡すプロンプト

下の文をそのままコピーして、AI エージェントに渡します。施設の事情に合わせて書き足してかまいません。

DoctorAssist（Claris FileMaker で作った、医師個人の業務支援ツール。診療録ではありません）を、WebORCA クラウド版の API につなげたいです。手伝ってください。

■ いまの状態
・DoctorAssist は WebORCA オンプレ版とつながっている。患者の受け取りは api01rv2/patientgetv2、診療の送信は api21/medicalmodv2（中途データ）。
・接続の設定は「医療機関」テーブルにある：ORCA_接続方式（クラウド／オンプレ）、ORCAホスト、ORCAポート、ORCAのアカウント、ORCAのパス、計算フィールドの ORCA_URLベース と ORCA_cURL基本。
・ORCA_URLベース は、接続方式が「クラウド」のとき ORCAホスト をそのまま URL の頭にする。
・通信は「URL から挿入」で、cURL オプションに ORCA_cURL基本 を使っている。

■ クラウド版で違うこと
1. つなぎ先は https://weborca.cloud.orcamo.jp/api/ ＋ API のパス（ポート 443）。
2. 認証は Basic 認証。パスワードの代わりに WebORCA の API キーを使う。
3. クライアント証明書の認証が要る。ブラウザに入っている証明書は FileMaker の「URL から挿入」では使えない。証明書のファイルを FileMaker に持たせて、cURL オプション（--cert、--key、--pass など）で渡す必要がある。

■ お願いしたいこと
1. まず今の作り（医療機関テーブル、ORCA_cURL基本、接続テスト・患者の受け取り・診療の送信のスクリプト）を調べて、直す案を出してください。直すのは、案に私が OK を出してから。
2. 医療機関テーブルに、証明書を入れるオブジェクトフィールド、証明書のパスフレーズ、証明書の期限の欄を足す。
3. 接続方式が「クラウド」のときだけ証明書を付けて通信する。オンプレの動きは変えない。証明書を cURL に渡す書き方は、Claris の公式資料で確かめてから使う。
4. 接続テスト、新規ボタンでの患者の受け取り、処方の送信の3つが、クラウドでも通るようにする。
5. 通信できなかったときは、HTTP の番号と ORCA の返事（Api_Result とメッセージ）を画面に出す。
6. 証明書の期限が近づいたら（30日前から）知らせる。

■ 守ってほしいこと
・作業を始める前に、FileMaker Cloud のバックアップを取ったか私に確かめる。
・API キー、証明書、パスフレーズ、パスワードを、チャットに書かせない・表示しない・ファイルやログに残さない。欄には私が自分で入れる。
・本物の患者のデータは使わない。テストは架空の患者で行う。
・配布用のファイルや DDR に、証明書や API キーが入らないようにする。
・DoctorAssist を「診療録」「電子カルテ」と呼ばない。
・スクリプトを私が直す必要があるときは、スクリプト名、行番号、入れる式をそのまま書いて渡す。
・終わったら、変えたこと、試したこと、試せなかったことを一覧にする。

5. AI エージェントが終わったら確かめること

  1. 医療機関の「ORCA接続設定」で、方式を「クラウド」、ホストを https://weborca.cloud.orcamo.jp/api/ にし、アカウント・API キー・証明書を自分で入れる
  2. 「送信テスト」で「成功。患者「…」を取得しました。」と出る
  3. 架空の患者で「新規」を押し、名前と保険が入る
  4. 処方を送り、日レセの「21 診療行為」の中途データに入っている（ORCA に送って中途データで確かめると同じ手順）
  5. 証明書の期限が入っていて、更新したら FileMaker の証明書も入れ替えることを決めておく

6. うまくいかないとき

  • 401：ユーザー ID か API キーが違う
  • 証明書・SSL のエラー：証明書のファイルかパスフレーズが違う、または期限切れ
  • 404：ホストに /api/ が抜けている
  • 503、「マスター更新中です」：日レセ側の準備中。少し待ってからもう一度

関連

DoctorAssist は、Claris FileMaker で開発された、医師個人が自身の診療業務を効率化するために使用する業務支援ツールです。診療録ではありません。法定の診療記録は各医療機関の記録および ORCA が正本であり、本ツールが保持するのは医師個人の作業用データです。

TOP