福祉専門職のための完全導入マニュアル

親亡き後支援データベース（oya-inai-db）／ このページは同フォルダの Markdown 版から生成しています

親亡き後支援データベース（oya-inai-db）を「ゼロから導入し、毎日の業務で使いこなす」までを 1 冊にまとめた完全ガイドです。

最終更新: 2026-08-12

目次

このマニュアルの読み方

手順に自信がない方へ —— Claude に横についてもらえます

このシステムはどうせ Claude を使います。その Claude に、導入作業そのものを手伝ってもらえます。導入のためだけに新しい道具を入れる必要はありません。

やることは2つだけです。

  1. Claude Desktop を入れる（→ 6-2）
  2. filesystem の差込口だけ先につなぐ（→ 6-3 の手順 1 と 3 だけ。Neo4j の差込口はデータベースが動いてからで構いません）

これだけで、あとは Claude に「導入マニュアルの第 3 章を見ながら手伝ってください」とお願いできます。

Claude ができること ご自身の手が要ること
設定ファイル（.env）を読んで正しいか確かめる アプリのインストール（管理者パスワードの入力）
エラーの文字を読んで、何が起きているか日本語で説明する ライセンスの同意ボタンを押す
フォルダの中を見て、必要なファイルが揃っているか確かめる ボタンを押す・文字を貼る
次に何をすればよいかを、いまの状態に合わせて案内する 最後の確認と判断

なぜ全部を任せられないのか。アプリの導入には、パソコンの管理者パスワードの入力と、ライセンスへの同意が含まれます。この2つは、AI が代わりにやってはいけない操作です。ここだけは必ずご自身で。

全体の道のり

いまどこにいるかを見失ったときは、ここに戻ってください。

【初回だけ】
  第2章  準備を確かめる（パソコンの条件・Claude の契約）
    ↓
  第3章  入れる（Docker ・本体）         ← ここがやま場。Claude に手伝ってもらえます
    ↓
  第4章  動くことを確かめる
    ↓
【毎日】
  第5章  画面で見る・記録する（Claude なしでも動きます）
    ↓
  第6章  Claude に登録・まとめ入力・照会をお願いする

【困ったとき】
  第8章  トラブルシューティング（まず 8-0 を読んでください）

困ったときの入口は3つだけです。

状況 どこへ
エラーの文字が出た そのまま Claude に貼る（→ 8-0）
画面が開かない・つながらない 8-1・8-2
Claude がデータベースを見てくれない 6-5・docs/mcp-setup.md 8 章

第 1 部　知る

第 1 章　このシステムでできること

1-1. 親亡き後支援データベースとは

親亡き後支援データベース（oya-inai-db） は、知的障害・精神障害のある方の支援情報を、パソコンのブラウザで開く Web 画面から記録・整理・確認できるシステムです。

親が長年かけて蓄積してきた「我が子を守るための暗黙知」を、親なき後も機能する社会的システムへと継承するためのデジタル・アーカイブです。

たとえば、こんなことができます。

たとえるなら: データベースは「鍵のかかった頑丈なキャビネット」、Web 画面は「そのキャビネットの前に立つ受付係」、Claude は「キャビネットの中身を知り尽くした事務員」です。日々の確認と記録は受付係（画面）に、書類の作成や整理は事務員（Claude）に頼む、という分担です。

1-2. 「ソフトは無償・AI は Claude」という考え方

ソフトウェア本体（この Web 画面とデータベース）は無償です。そのうえで、このシステムは AI アシスタントの Claude（Anthropic 社）と組み合わせて使う設計になっています。

担当 できること 費用
Web 画面（このソフト） 閲覧・照会（緊急照会・訪問前の確認・更新期限アラート・エコマップ・知識グラフ）と、日々の記録（出来事の記録・面談記録） 無償
Claude（別途契約） 新しい方の登録、語りや文書からのまとめ入力、自由な言葉での照会・検索 Claude の有料プランが実質的な導入要件です

つまり、閲覧と日々の記録だけなら Web 画面だけで完結しますが、新しい方を登録したり、聞き取りメモをまとめて取り込んだりするには Claude が必要です。データベースを育てていく運用には、Claude の有料プランの契約を前提としてください。

なぜ Claude 一本なのか: 以前は複数の AI（Ollama・Gemini・Claude）から選ぶ設計でしたが、資料の受け取り・仕分け・引き出しまでを一貫して任せられる形を優先し、2026-08 に Claude 一本へまとめました。設定が 1 種類になり、説明も同意もシンプルになります。音声の文字起こしと意味検索は、この切り替えに伴い廃止しています。

1-3. 5 つの価値

このシステムは、次の 5 つの価値を軸に設計されています。

価値 定義
尊厳 (Dignity) 管理対象ではなく、歴史と意思を持つ一人の人間として記録する
安全 (Safety) 緊急時に「誰が」「何を」すべきか、迷わせない構造を作る
継続性 (Continuity) 支援者が入れ替わっても、ケアの質と文脈を断絶させない
強靭性 (Resilience) 親が倒れた際、その機能を即座に代替できるバックアップ体制を可視化する
権利擁護 (Advocacy) 本人の声なき声を拾い上げ、法的な後ろ盾と紐づける

1-4. 仕組みの全体像

┌───────────────────────────────────────────────────────┐
│                                                       │
│  あなた（支援者）                                      │
│    ↕ ブラウザで操作する          ↕ 日本語で話しかける    │
│  Web 画面                        Claude Desktop        │
│  （http://localhost:3001）       （第 6 章で設定）      │
│    ↕ 入力・照会の受け渡し          ↕ MCP という差込口     │
│  API サーバー（localhost:8001）    │                    │
│    ↕                             │                    │
│  Neo4j（グラフデータベース／Docker の中で動く）          │
│    └─ 支援記録・禁忌事項・連絡先・手帳情報 などを保管    │
│                                                       │
└───────────────────────────────────────────────────────┘

ポイント: 日々の操作は「ブラウザで画面を開いて、ボタンを押す」だけです。API サーバーとデータベースは、アプリの起動と同時に裏側で立ち上がるので、意識する必要はありません。Claude は、同じデータベースに MCP（差込口の仕組み） 経由でつながり、登録やまとめ入力を引き受けます（→ 第 6 章）。

必要なアプリは、日常利用では 2 つ、Claude と組み合わせる段階で もう 1 つ です。

アプリ名 役割 日常的に例えると
Docker Desktop データベースを動かす土台 データベースの「電源スイッチ」
Node.js Web 画面を動かす裏方 「画面を組み立てる職人」。設定後は意識しなくて OK
Claude Desktop（第 6 章） 登録・まとめ入力・自由な照会 「キャビネットの中身を知り尽くした事務員」

このほか、ふだんお使いのブラウザ（Chrome・Edge・Safari など）を使います。

第 2 章　導入前の準備と確認

2-1. パソコンの条件

項目 条件
OS Windows 10 / 11、または macOS
メモリ 8GB 以上を推奨
管理者権限 インストール時に必要（会社の PC の場合は情報システム担当に相談）
インターネット接続 インストール時に必要。導入後、中核機能はインターネットに繋がっていなくても使えます

2-2. 料金について

補助金のご案内: ICT 導入支援事業の補助金（補助率 10/10）が活用できる場合があります。お住まいの自治体にお問い合わせください。

2-3. Claude の準備

このシステムの AI は Claude 一本です（2026-08 方針決定）。以前あった「3 つの AI から選ぶ」形と、アプリ内の AI 機能（自動抽出・AI チャット・意味検索・音声の文字起こし）は廃止しました。かわりに、Claude Desktop というアプリからデータベースに直接つないで、登録・まとめ入力・照会を行います。

準備するものは 2 つです。

準備するもの 内容
Claude の有料プラン Anthropic 社のサイト（https://claude.com）で契約します
Claude Desktop パソコンにインストールする Claude のアプリ。データベースへの差込口（MCP）はこのアプリに設定します

設定の手順は 第 6 章 と docs/mcp-setup.md で丁寧に説明しています。導入の時点では契約だけ決めておけば十分です。まず第 3〜5 章で画面に慣れてから、第 6 章に進んでください。

⚠️ 個人情報の注意: Claude に支援記録などを扱わせると、そのテキストは Anthropic 社のサーバーに送信されます。組織で導入する場合は、第 7 章 を必ず確認してください。

2-4. 導入前チェックリスト

第 2 部　導入する

第 3 章　インストール（初回だけ）

初回のみ行う作業です。一度終われば、次回からは「起動」だけで使えます。

🤝 この章は、Claude に横についてもらいながら進められます。

先に Claude Desktop と filesystem の差込口だけ済ませて（→ 手順に自信がない方へ）、この章に戻ってきてください。そのうえで、Claude にこうお願いします。

「導入マニュアルの第 3 章を見ながら、導入を手伝ってください。いまのパソコンの状態を確かめて、次にすることを一つずつ教えてください」

アプリの導入（Step 1）だけは、必ずご自身で。管理者パスワードの入力とライセンスの同意が含まれるためです。Step 2 以降は、つまずいたときにエラーをそのまま貼れば、何が起きているかを読み解いてくれます。

全体の流れは次のとおりです。

Step 1  2 つのアプリを準備する（Docker Desktop / Node.js）
  ↓
Step 2  ワンクリックインストーラーを実行する（Step 3 相当を自動実行）
  ↓
（うまくいかない場合のみ）
Step 3  手動: 本体をダウンロードしてデータベースを起動
  ↓
Step 4  設定ファイル（.env）を確認する ※通常はそのままで OK
  ↓
Step 5  アプリを起動して Web 画面を開く

Step 1: 2 つのアプリを準備する

すでにインストール済みのアプリは飛ばしてください。

1-1. Docker Desktop を入れる

なぜ必要？ — クライアントの情報を保存するデータベース（Neo4j）を動かすための土台です。

  1. ブラウザで https://www.docker.com/products/docker-desktop/ を開きます
  2. お使いのパソコンに合ったボタンをクリックしてダウンロードします - Mac の方: 「Download for Mac」
    • Apple Silicon（M1/M2/M3/M4）か Intel かを聞かれた場合: 画面左上のリンゴマーク →「この Mac について」→「チップ」の欄を確認
    • Windows の方: 「Download for Windows」
  3. ダウンロードしたファイルを開きます - Mac: .dmg ファイルを開き、Docker のアイコンを「アプリケーション」フォルダにドラッグ - Windows: .exe ファイルを開き、画面の指示に従って進めます。「Use WSL 2 instead of Hyper-V」にチェックが入っていることを確認し、完了後「Close and restart」でパソコンを再起動
  4. Docker Desktop を起動します
  5. 画面上部（Mac）またはタスクバー右下（Windows）に クジラのアイコン が表示されたら準備完了です（初回は起動に 1〜2 分かかることがあります）

うまくいかないとき

症状 対処法
Windows で「WSL 2 が必要です」と出る PowerShell を「管理者として実行」→ wsl --install と入力 → パソコン再起動
Windows で「仮想化が無効です」と出る 「お使いの PC 名 BIOS 仮想化 有効」で検索して設定を変更
Mac で「システム拡張がブロックされました」 「システム設定」→「プライバシーとセキュリティ」で許可
クジラのアイコンが出てこない パソコンを再起動してからもう一度 Docker Desktop を開く

1-2. Node.js を入れる

なぜ必要？ — ブラウザで開く Web 画面を動かすための裏方のプログラムです。一度入れたら、あとは意識する必要はありません。

  1. ブラウザで https://nodejs.org/ を開きます
  2. 「LTS」と書かれた緑色のボタンをクリック（「推奨版」という意味です）
  3. ダウンロードしたファイルを開いてインストールします。すべてデフォルトのまま「Next」→「Next」→「Install」で OK です
  4. インストール後、パソコンを再起動してください（再起動しないと反映されない場合があります）

確認したい方は、Mac は「ターミナル」、Windows は「PowerShell」を開いて node --version と入力し、v20.xx.x のようなバージョン番号が出れば OK です。

Step 2: ワンクリックインストーラーを実行する（おすすめ）

なぜ必要？ — 前提条件（Docker Desktop・Node.js）の確認、本体のダウンロード、データベースの起動、接続テストまでをすべて自動で行ってくれます。

Mac の方

  1. 「ターミナル」アプリを開きます - 見つけ方: キーボードで Command + スペース →「ターミナル」と入力して Enter
  2. 以下の 1 行をコピーして、ターミナルに貼り付けて、Enter キーを押します:
curl -sL https://raw.githubusercontent.com/kazumasakawahara/oya-inai-db/main/installer/install-mac.sh | bash
  1. 画面に質問が表示されたら「Y」を入力して Enter（「はい」という意味です）
  2. 「セットアップが完了しました！」と表示されたら → Step 4 に進んでください

本体は 書類（Documents）/oya-inai-db フォルダに保存されます。

Windows の方

  1. 「PowerShell」を 管理者として 開きます - 見つけ方: 画面左下の Windows マーク（スタート）を右クリック →「ターミナル（管理者）」または「Windows PowerShell（管理者）」を選ぶ - 「このアプリがデバイスに変更を加えることを許可しますか？」→「はい」
  2. 以下の 2 行を 1 行ずつコピーして貼り付け、それぞれ Enter キーを押します:
Set-ExecutionPolicy Bypass -Scope Process -Force

irm https://raw.githubusercontent.com/kazumasakawahara/oya-inai-db/main/installer/install-windows.ps1 | iex

貼り付けは、画面内で右クリックすると行えます（Ctrl+V が効かない場合があります）。

  1. 画面に質問が表示されたら「Y」を入力して Enter
  2. 「セットアップが完了しました！」と表示されたら → Step 4 に進んでください

本体は ドキュメント\oya-inai-db フォルダに保存されます。

インストーラーが行うこと（両 OS 共通）

  1. 前提条件の確認 — Docker Desktop・Node.js が入っているか確認（無ければ入れ方を案内）
  2. リポジトリの取得 — 本体プログラムのダウンロード
  3. Neo4j の起動 — データベースを Docker で立ち上げる
  4. 接続テスト — データベースに繋がるか確認

途中で Docker Desktop のインストールを促された場合は、指示どおりインストール後、パソコンを再起動してからもう一度インストーラーを実行してください。

練習用のデモデータは、インストーラーとは別に、あとから投入できます（→ 4-3）。

うまくいかないとき

症状 対処法
「permission denied」 Mac: もう一度実行 / Windows: PowerShell を「管理者として実行」で開き直す
ダウンロードが途中で止まる インターネット接続を確認してもう一度実行
「Docker が起動していません」 Docker Desktop を起動（クジラのアイコンを確認）してから再実行

ワンクリックインストーラーが成功した方は、Step 3 は不要です。Step 4 に進んでください。

Step 3（手動）: 本体をダウンロードしてデータベースを起動

インストーラーがうまく動かなかった場合の手動手順です。

3-1. ダウンロード

  1. ブラウザで https://github.com/kazumasakawahara/oya-inai-db を開きます
  2. 緑色の 「Code」ボタン → 「Download ZIP」 をクリック
  3. ダウンロードした ZIP ファイルを展開（解凍）します - Windows: ZIP ファイルを右クリック →「すべて展開」 - Mac: ZIP ファイルをダブルクリック
  4. 展開したフォルダを 「書類（Documents）」フォルダ に移動します - Mac: ~/Documents/oya-inai-db/ - Windows: C:\Users\あなたの名前\Documents\oya-inai-db\

フォルダ名に注意: 展開すると oya-inai-db-main というフォルダ名になる場合があります。oya-inai-db にリネームしてください。

3-2. データベースの起動

Mac の方 — ターミナルで:

cd ~/Documents/oya-inai-db
docker compose up -d neo4j

Windows の方 — PowerShell で:

cd $env:USERPROFILE\Documents\oya-inai-db
docker compose up -d neo4j

データベースが立ち上がるまで待ちます（初回はイメージのダウンロードがあるため 3〜5 分かかることがあります）。

確認方法: ブラウザで http://localhost:7474 を開き、ログイン画面が表示されたら成功です（ユーザー名 neo4j / パスワード password）。この画面は「データベースの管理画面」で、普段使う必要はありません。

Step 4: 設定ファイル（.env）を確認する ※通常はそのままで OK

なぜ必要？ — データベースへの接続先とパスワードを書いておくファイルです。初期設定のまま使い始める場合、この Step は飛ばして構いません。 AI のキーを書く欄はありません（Claude の設定は第 6 章で、別のアプリに対して行います）。

データベースのパスワードを変えるとき（→ 7-4）だけ、このファイルを使います。

  1. 本体フォルダにある .env.example を .env という名前でコピーします
# Mac（ターミナル）
cd ~/Documents/oya-inai-db
cp .env.example .env

# Windows（PowerShell）
cd $env:USERPROFILE\Documents\oya-inai-db
Copy-Item .env.example .env
  1. .env をテキストエディット（Mac）／メモ帳（Windows）で開き、必要な項目を書き換えます
NEO4J_URI=bolt://localhost:7687
NEO4J_USERNAME=neo4j
NEO4J_PASSWORD=password
  1. 保存します（Mac: Command + S / Windows: Ctrl + S）

Windows のメモ帳の注意: 保存時にファイル名が .txt で終わらないよう、「ファイルの種類」を「すべてのファイル」にして、ファイル名が .env のままであることを確認してください。

Step 5: アプリを起動して Web 画面を開く

Mac の方: 本体フォルダ（書類/oya-inai-db）の中にある start.command をダブルクリックします。

Windows の方: 本体フォルダ（ドキュメント\oya-inai-db）の中にある start.bat をダブルクリックします。

黒い画面（ターミナル / コマンドプロンプト）が開いて、起動の様子が流れます。この画面は使っている間、閉じないでください。

起動が終わったら、ブラウザで次のアドレスを開きます。

http://localhost:3001

ホーム画面（ダッシュボード） が表示されたら成功です。画面の左側にサイドバーがあり、「ホーム」「出来事の記録」「面談記録」…と各ページが並んでいます。

ブックマークしておくと便利です。 次回からは、start.command / start.bat を実行してから、このブックマークを開くだけです。

Mac で「開発元を確認できない」と出た場合: start.command を右クリック →「開く」→ もう一度「開く」を選ぶと実行できます。

第 4 章　動作確認と練習用データ

🤝 ここも Claude に見てもらえます。「テスト 1〜3 を一緒に確かめてください」とお願いすれば、どこまでできていて、どこで止まっているかを整理してくれます。

4-1. 環境整合チェック（Mac の方・推奨）

Mac の方は、doctor.sh で全体の整合性（Docker コンテナ・データベース疎通・.env・API サーバー・Web 画面）を一発確認できます。

cd ~/Documents/oya-inai-db
./scripts/doctor.sh

問題があれば具体的な FAIL 項目が表示されます。常時 All PASS を目標にしてください。

.env の項目は「INFO」と表示されることがあります。初期設定のまま使う場合は .env が無くても動くため、異常ではありません。

Windows の方は、この後の「テスト 1〜3」がそのまま動作確認になります。

4-2. 3 つのテストで動作確認

テスト 1: 画面が開くか確認する

start.command（Mac）／ start.bat（Windows）を実行したうえで、ブラウザで http://localhost:3001 を開きます。

ホーム にダッシュボード（利用者数・今月の記録・更新期限アラート）が表示されたら起動成功です。まだ何も登録していないので、数字は 0 で構いません。

テスト 2: 練習用のデモデータを入れる

動作確認には、合成データ（架空の人物データ） を使います。投入コマンドは 4-3 のとおりです。投入後、サイドバーの 「クライアント一覧」 に「山本翔太」さんたちが並べば、データベースへの書き込みと読み出しが両方できています。

実在の方の登録はここでは行いません。 新しい方の登録は Claude に頼む方式です（→ 第 6 章）。まずデモデータで画面の見方に慣れてから進むのがおすすめです。

テスト 3: 記録を 1 件登録してみる

サイドバーの 「出来事の記録」 を開き、デモデータの「山本翔太」さんを選んで、様子を 1 件登録してみます。入力画面は 番号のついたステップ式（①→②→…） です。まだ足りない項目があるときは、ボタンの下に 「あと「◯◯」を済ませると押せます」 とヒントが出ます。案内に従って埋めていけば大丈夫です。

登録後、「クライアント一覧」 →「山本翔太」の詳細画面に今の記録が表示されれば、セットアップは完了です。おめでとうございます！

練習で入れた記録ごと消したいときは、4-3 の削除コマンドでデモデータを丸ごと削除できます。

4-3. 練習用のデモデータを入れる

操作に慣れるため、合成データ（架空の人物データ） で練習できます。実在の人物とは一切関係のないデータなので、研修や説明会でも安全に使えます。

Mac の方:

cd ~/Documents/oya-inai-db
chmod +x installer/load-demo-data.sh
./installer/load-demo-data.sh

Windows の方:

cd $env:USERPROFILE\Documents\oya-inai-db
.\installer\load-demo-data.ps1

デモデータ投入後、Web 画面でこんなふうに試せます:

感情シミュレーションデータも入れる場合（1 ヶ月分の出来事データ）:

# Mac
./installer/load-demo-data.sh --simulation

# Windows
.\installer\load-demo-data.ps1 -Simulation

投入後は、「クライアント一覧」 の詳細画面や 「エコマップ」 で、山本翔太さんの記録の積み重なりを見ることができます。

デモデータを削除する場合:

# Mac
./installer/load-demo-data.sh --remove

# Windows
.\installer\load-demo-data.ps1 -Remove

デモデータには専用の識別子（demoId）が付いており、実データと区別されます。削除もこの識別子を目印に行うため、実データを巻き込むことはありません。研修や説明会では実データではなく、必ずこのデモデータを使ってください（→ 第 7 章）。

第 3 部　使う

第 5 章　初期運用 — 最初の 5 操作と日常の起動

5-1. 使い方の基本 — サイドバーからページを選ぶ

使い方の基本は、たった 1 つ。

ブラウザで http://localhost:3001 を開き、左のサイドバーからやりたいことのページを選ぶ。

サイドバーは、用途ごとにまとまっています。全部で 6 ページです。

まとまり ページ どんなとき
ホーム ホーム 全体の状況を見る（利用者数・今月の記録・更新期限アラート）
記録 出来事の記録 本人の様子をその場で短く記録する
記録 面談記録 面談の内容を残す（文字入力・文書ファイル添付）
管理 クライアント一覧 詳細確認・緊急照会
活用 エコマップ 支援ネットワークを図で見る
活用 知識グラフ 人・情報のつながりを図で見る

入力画面はすべて番号ステップ式（①→②→…）です。 上から順に埋めていけば完了します。まだ足りない項目があるときは、ボタンの下に 「あと「◯◯」を済ませると押せます」 と表示されるので、その項目を埋めてください。

📌 新しい方の登録や、語り・文書からのまとめ入力は、画面にはありません。 それらは Claude に頼みます（→ 第 6 章）。画面は「日々の確認と記録」に専念する作りです。

⚠️ 画面には「登録されていること」しか出てきません。 記録がなければ空欄のままです。大切なことは必ず記録しましょう。

5-2. まず試してほしい 5 つの操作

まず覚えるのは、この 5 つだけで十分です。

操作 1: 新しいクライアントを登録する（Claude に頼む）

新しい方の登録は、画面ではなく Claude に日本語で頼みます（設定は 第 6 章）。

「新しい利用者さんを登録してください。名前は◯◯さん、生年月日は…。絶対にしてはいけないことは…」

と話しかけると、Claude が内容を整理し、登録する前に確認を取ってからデータベースに書き込みます。全部を一度に伝えなくても大丈夫。 わかる範囲から登録して、あとから追加できます。登録された内容は、「クライアント一覧」 にすぐ反映されます。

まだ Claude の設定が済んでいない段階では、この操作は飛ばして、デモデータ（→ 4-3）で操作 2 以降を練習してください。

操作 2: 緊急情報をすぐ確認する（★関わる前に必ず）

サイドバー 「クライアント一覧」 → 対象の方 → 詳細画面の 緊急照会。

重要な順（①禁忌事項 → ②推奨ケア → ③緊急連絡先 → ④かかりつけ医 → ⑤後見人）に表示されます。新しい職員がクライアントに関わる前には、必ずこれを確認してください。 この機能は AI を使いません。ネットに繋がっていなくても表示されます。

操作 3: 訪問前に確認する

同じく 「クライアント一覧」 → 対象の方の詳細画面。

禁忌事項・推奨ケア・直近の記録・更新期限がまとまって並んでいます。訪問の前日〜当日に、この画面をひととおり見てから出かけてください。

操作 4: その場の様子を記録する

サイドバー 「出来事の記録」。

本人の様子を 絵文字ボタン（喜び・不安・パニック・固まった・怒り・悲しみ）から選び、 → 場面 → 環境 → 詳細 の順に進みます。最後に、任意で 職員の対応とその効果 も残せます。

短時間で入力できるので、現場で気づいたことをその場で残すのに向いています。

操作 5: 更新期限を確認する（月 1 回おすすめ）

サイドバー 「ホーム」 の 更新期限アラート。

更新が近づいている手帳・受給者証が一覧で出ます。更新漏れは本人の不利益に直結するので、月に 1 回は目を通してください。

5-3. 面談の記録を残す

サイドバー 「面談記録」 では、2 つのやり方が選べます。

やり方 内容
その場で文字入力 面談中・直後にそのまま打ち込む
文書ファイルを添付 Word・Excel・PDF・テキストのファイルを添付する

音声ファイルの文字起こしは廃止しました（2026-08-12）。録音を残したい場合は、お手元で保管し、要点を文字でご入力ください。

5-4. 文章まるごと登録は Claude へ

親御さんの語りや聞き取りメモをまとめてデータベースに取り込むのは、Claude の担当です（設定は 第 6 章）。Claude にテキストを貼り付けて（または文書ファイルを渡して）「この内容を登録してください」と頼むと、内容を読み取って項目ごとに整理し、確認を取ってから登録します。

たとえば、こんな文章をそのまま渡せます。

うちの太郎はね、昭和62年の夏に生まれたんです。小さい頃から
音に敏感で、運動会のピストルの音で泣いてしまって…。
今でも大きな音は絶対ダメです。掃除機も怖がります。
でもね、音楽は好きなんですよ。童謡を歌ってあげると
にこにこして、すごく穏やかになるの。
かかりつけは北九州中央病院の田中先生です。月に一回通ってます。
療育手帳は A1 で、来年の 3 月に更新です。

テキスト中の表現から、禁忌事項（「〜しないで」「絶対ダメ」）、推奨ケア（「〜すると落ち着く」）、診断、連絡先、病院・医師、手帳と更新期限、生育歴などが分類・整理されます。

Claude は登録前に必ず内容を提示して確認を求めます。 そのまま保存されることはありません。違っているところは「ここはこう直して」と伝えてから登録してもらってください。

5-5. 毎日の起動と終了

セットアップは最初の 1 回だけです。普段は以下だけで使えます。

朝（使い始めるとき）

  1. パソコンを起動する
  2. Docker Desktop が起動していることを確認（クジラのアイコン）
  3. start.command（Mac）／ start.bat（Windows） をダブルクリック
  4. ブラウザで http://localhost:3001 を開く（ブックマークしておくと楽です）

便利な設定: Docker Desktop を「ログイン時に自動起動」にしておくと、手順 2 を省略できます。 Docker Desktop → Settings（歯車アイコン）→ General → 「Start Docker Desktop when you sign in」にチェック

起動時に開いた黒い画面（ターミナル / コマンドプロンプト）は、使っている間は閉じないでください。 閉じると画面が表示されなくなります。

夜（終わるとき）

ブラウザを閉じ、起動時の黒い画面を閉じれば終了です。パソコンをそのままシャットダウンして構いません。データは自動的に保存され、次回起動時に復元されます。

5-6. 月に 1 回のルーチン（おすすめ）

やること 方法
更新期限の確認 「ホーム」 の更新期限アラートを見る
記録の抜けの確認 「クライアント一覧」 で、禁忌事項や連絡先が空欄の方がいないか見る
バックアップ 下記のコマンドを実行（またはフォルダをコピー）

バックアップの方法

クライアントの情報は大切な資産です。月に 1 回はバックアップすることをお勧めします。

# Mac（ターミナル）
cd ~/Documents/oya-inai-db
docker compose stop
cp -r neo4j_data neo4j_data_backup_$(date +%Y%m%d)
docker compose start

# Windows（PowerShell）
cd $env:USERPROFILE\Documents\oya-inai-db
docker compose stop
Copy-Item -Recurse neo4j_data "neo4j_data_backup_$(Get-Date -Format yyyyMMdd)"
docker compose start

ターミナル操作が不安な方は、Docker Desktop を停止してから、neo4j_data フォルダをそのままコピーして別の場所に保存するだけでも OK です。バックアップにも個人情報が含まれるため、暗号化した USB や施錠できる場所に保管してください。

別のパソコンへの移行も、この neo4j_data フォルダをコピーするだけでできます。

5-7. さらに使いこなす

やりたいこと どこで
支援ネットワークを図で見る 「エコマップ」
人・情報のつながりをたどる 「知識グラフ」
過去の記録を言葉で探す Claude に聞く（「◯◯さんの入浴に関する記録を探して」など・→ 第 6 章）
登録内容について質問する Claude に聞く（「◯◯さんの禁忌事項を教えて」など・→ 第 6 章)

第 6 章　Claude と組み合わせる — 登録とまとめ入力

この章が、このシステムの新しい導線の要です。 新しい方の登録、語りや文書からのまとめ入力、自由な言葉での照会は、すべて Claude Desktop から日本語で頼む方式です。画面の操作を覚える必要はありません。

閲覧と日々の記録（第 5 章）は Claude なしでも動くので、画面に慣れてからこの章に進んで大丈夫です。

6-1. Claude を設定すると何ができるようになるか

やりたいこと 頼み方の例
新しい方の登録 「新しい利用者さんを登録してください。名前は◯◯さん、…」
語り・文書のまとめ入力 聞き取りメモを貼り付けて「この内容を整理して登録してください」
自由な言葉での照会 「◯◯さんの禁忌事項と緊急連絡先を教えてください」
記録の検索 「◯◯さんの入浴に関する記録を探してください」
書類の下書き 「◯◯さんの直近 3 ヶ月の記録から、モニタリング報告の下書きを作ってください」

どの場合も、データベースへの書き込みの前には、Claude が内容を提示して確認を求めます。 特に禁忌事項のような安全に関わる情報は、表示された内容をよく確かめてから「登録してください」と伝えてください。

6-2. 必要なもの

準備するもの 内容
Claude の有料プラン https://claude.com で契約します（→ 2-3）
Claude Desktop Claude のパソコン用アプリ。https://claude.com/download からインストールします
データベースが起動していること いつもどおり Docker Desktop と start.command / start.bat を起動しておきます

6-3. 設定のしかた — 差込口（MCP）をつなぐ

Claude Desktop とデータベースをつなぐ仕組みを MCP（差込口） と呼びます。設定の手順は、専用のガイド docs/mcp-setup.md に、画面写真つきの丁寧さで書いてあります。そちらに沿って進めてください。

流れだけ先に紹介すると:

  1. filesystem の差込口を入れる — Claude がパソコンのフォルダ（文書ファイルなど）を読めるようにする（docs/mcp-setup.md 3 章）
  2. Neo4j の差込口を入れる — Claude がこのデータベースを読み書きできるようにする（同 7 章）。設定に貼る文字列は、Claude 自身に「Neo4j の差込口を足したいです」と頼めば作ってくれます
  3. Claude Desktop を「完全終了」して起動し直す — 設定はこの操作で反映されます（同 0 章。いちばんつまずきやすいポイントです）

ご自身の手が要るのは「押す・貼る・打つ」だけです。設定文字列の作成やエラーの読み解きは、Claude 自身が引き受けてくれます。画面に出たエラーは、そのまま Claude に貼り付けて「どうすればいいですか」と聞いてください。

6-4. はじめての登録をやってみる

設定が済んだら、Claude Desktop に次のように話しかけてみてください。

「支援データベースに新しい利用者さんを登録してください。 名前はテスト太郎さん、生年月日は 1990 年 4 月 1 日。 自閉スペクトラム症があります。 絶対にしてはいけないことは、後ろから急に声をかけること。パニックになります。 声をかけるときは正面から、ゆっくり話すと落ち着きます。」

Claude が内容を整理して「この内容で登録しますか？」と確認してくるので、間違いがなければ「お願いします」と答えます。登録が終わったら、ブラウザの 「クライアント一覧」 を開いて、テスト太郎さんが表示されることを確かめてください。画面と Claude が同じデータベースを見ていることが実感できるはずです。

確認が済んだら、「いま登録したテスト太郎さんを削除してください」と頼めば片付けも Claude がやってくれます。

6-5. うまく動かないとき

6-6. エコマップ・知識グラフ（Claude の設定は不要）

サイドバー 「エコマップ」 では支援ネットワークの関係図を、「知識グラフ」 では人や情報のつながりを、それぞれ画面上で見ることができます。どちらも Claude の設定は不要です。

第 4 部　守る・直す

第 7 章　個人情報を守るための運用

このシステムは、障害のある方やご家族の要配慮個人情報（障害の種類・等級、医療情報、生育歴等）を扱います。導入する事業所は必ずこの章を確認してください。

7-1. データはどこに保存され、どこへ送信されるのか

保存場所: クライアントの情報（データベース本体）は、すべてお使いのパソコンの中（oya-inai-db/neo4j_data/ フォルダ）に保存されます。クラウドのデータベースは使いません。

外部への送信が起きるのは、Claude に頼んだときだけです。

操作 データの行き先
Web 画面での閲覧・記録（緊急照会・出来事の記録・面談記録など） 外部に送信されません。 パソコンの中で完結します
Claude への依頼（登録・まとめ入力・照会・検索） Claude が読み書きしたテキストが Anthropic 社のサーバーに送信されます

つまり、緊急照会や日々の記録は、インターネットに繋がっていなくても動きます。一方で、Claude に語りの整理や照会を頼んだ内容（そこに含まれる支援記録・禁忌事項など）は Anthropic 社のサーバーで処理されます。

⚠️ 導入前に必ず確認してください: Anthropic 社のデータの取り扱い方針（入力データが学習に使われる条件・保持期間など）は、プランや設定によって異なり、変更されることもあります。組織で導入する際は、契約するプランのポリシーを確認し、個人情報保護規程と突き合わせてください。 確認した日付と内容を控えておくことをおすすめします。

7-2. 職員一人ひとりの約束

やること

やってはいけないこと

7-3. 仮名化機能 — 研修・デモで名前を伏せる

研修や説明会で画面を見せる場面では、表示時に名前を自動でマスクできます。データベース内の実データは変更されません。

モード 表示例 用途
mask 山田 → 山●●● 研修、説明会、デモ
pseudonym 山田 → 青山あおい テスト、開発、公開資料

.env に設定して有効化します:

PSEUDONYMIZATION_ENABLED=true
PSEUDONYMIZATION_MODE=mask

研修が終わったら false に戻してください。

安全上の例外: 禁忌事項・推奨ケア・手帳の種類等級は、緊急時の安全に直結するため仮名化されません。

詳細は docs/manuals/PRIVACY_GUIDELINES.md を参照してください。

7-4. 本番運用前に必ずやること — パスワード変更

データベースの初期パスワード（password）は、本番運用前に必ず変更してください。

  1. docker-compose.yml の NEO4J_AUTH=neo4j/password を強いパスワードに変更
  2. .env の NEO4J_PASSWORD も同じ値に変更
  3. データベースを再起動し、アプリを起動し直す（start.command / start.bat）

7-5. 組織導入時のチェックリスト

7-6. もしも情報漏えいが起きたら

  1. 即座にアクセスを遮断: docker compose stop でデータベースを停止
  2. 影響範囲の確認: いつ・どの情報が対象になったかを整理する
  3. 関係者への報告: 管理者、個人情報保護責任者に報告
  4. 原因の特定と再発防止: パスワード変更、アクセス権限の見直し
  5. 本人への通知: 個人情報保護法に基づき、本人に通知

第 8 章　トラブルシューティング

8-0. まず Claude に聞いてみる

エラーの文字が出たら、意味を考える前に、そのまま Claude に貼り付けてください。英語でも、長くても、途中で切れていても構いません。

「このエラーが出ました。何が起きていて、次に何をすればよいか教えてください。 （ここにエラーの文字を貼る）」

filesystem の差込口がつながっていれば、Claude は実際のファイルを見て確かめられます。症状に応じて、次の場所を見てもらってください。

症状 Claude に見てもらうもの 頼み方の例
画面が開かない docker-compose.yml、.env 「設定ファイルを見て、おかしなところがないか見てください」
起動に失敗する ターミナルに出たメッセージ全体 「この出力を読んで、どこで止まっているか教えてください」
ファイルが見当たらない インストール先のフォルダ 「oya-inai-db のフォルダを見て、必要なファイルが揃っているか確かめてください」
何が原因か分からない このマニュアル自体 「導入マニュアルの第 8 章を見ながら、一緒に原因を探してください」

ただし、Claude が自分でコマンドを実行することはできません。読む・調べる・案内するまでです。実行するのはご自身です。これは制限ではなく、利用者さんの情報が入ったパソコンで、AI が勝手に操作をしないための設計です。

以下は、ご自身で確かめるときの手順です。

8-1. まず試すこと

Docker Desktop を起動し直してから、start.command（Mac）／ start.bat（Windows）を実行し直す。 多くの不調はこれで直ります。

Mac の方は、./scripts/doctor.sh を実行すると、どこでつまずいているかが一覧で表示されます（→ 4-1）。

8-2. 症状別の対処法

症状 よくある原因 解決法
Docker Desktop が起動しない インストール未完了 パソコンを再起動 → Docker Desktop を開く
「port is already allocated」 前回のデータベースが残っている Docker Desktop の画面で該当コンテナを停止 → 再起動
ブラウザで画面が出ない アプリが起動していない start.command / start.bat を実行し、黒い画面を閉じずに http://localhost:3001 を開く
画面は出るがデータが表示されない データベースが起動していない Docker Desktop を起動 → 8-3 を確認
Claude がデータベースにつながらない 差込口（MCP）の設定・完全終了もれ 8-5 と docs/mcp-setup.md 8 章を確認
登録したはずの情報が出てこない まだ登録されていないだけ（故障ではない） 第 5 章・第 6 章の手順で登録してから再確認
「登録」ボタンが押せない 必須項目が未入力 ボタンの下の 「あと「◯◯」を済ませると押せます」 の案内どおりに埋める
パソコンの動作が遅い メモリ不足 Docker Desktop → Settings → Resources でメモリ調整。使わないときは docker compose stop

8-3. データベースに繋がらないとき

# コンテナの状態確認（Mac / Windows 共通）
docker ps

# 再起動
cd ~/Documents/oya-inai-db   # Windows: cd $env:USERPROFILE\Documents\oya-inai-db
docker compose restart

# ログの確認
docker logs oya-inai-db-neo4j

ブラウザで http://localhost:7474 を開き、画面が出れば動いています（neo4j / password）。

よくある原因: Docker Desktop が起動していない / ポート 7474・7687 が他のアプリに使われている / メモリ不足（Docker Desktop の Settings → Resources で 4GB 以上に）。

8-4. Web 画面が開かないとき

  1. start.command（Mac）／ start.bat（Windows）を実行したときの黒い画面が閉じていないか確認します。閉じているとアプリは止まっています
  2. ブラウザのアドレスが http://localhost:3001 になっているか確認します（https ではありません）
  3. Mac の方は ./scripts/doctor.sh を実行し、API サーバー（8001）と Web 画面（3001）の項目を確認します
  4. それでも開かないときは、黒い画面を閉じて、Docker Desktop を起動し直してから start.command / start.bat を実行し直します

8-5. Claude がうまく動かないとき

Web 画面（閲覧・日々の記録）は Claude なしで動きます。Claude 側の不調で画面が壊れることはありません。

Claude がデータベースにつながらないときは、次の順で確認してください。

  1. Docker Desktop とデータベースが起動しているか（クジラのアイコン → 8-3）
  2. Claude Desktop を「完全終了」してから起動し直したか（docs/mcp-setup.md 0 章。「×」で閉じただけでは設定が反映されません）
  3. それでもだめなら、docs/mcp-setup.md 8 章の一覧を上から順に（多い原因順に並んでいます）
  4. エラーの文字をそのまま Claude に貼り付けて「これはどういう意味ですか」と聞く

8-6. Windows 固有のトラブル

症状 対処法
「スクリプトの実行が無効になっています」 Set-ExecutionPolicy Bypass -Scope Process -Force を実行してから再実行（現在のウィンドウのみに適用され、閉じれば元に戻ります）
Neo4j コンテナがすぐ停止する / out of memory Docker Desktop → Settings → Resources でメモリを 4GB 以上に。または %USERPROFILE%\.wslconfig に [wsl2] memory=4GB を記述 → wsl --shutdown → Docker Desktop 再起動
ポート使用中の調査 netstat -ano | findstr :7474 で PID を確認 → tasklist | findstr <PID>

8-7. Mac 固有のトラブル

症状 対処法
「開発元を確認できない」警告 start.command を右クリック →「開く」→ もう一度「開く」。または chmod +x start.command installer/*.sh で実行権限を付与
環境の総点検をしたい ./scripts/doctor.sh を実行（第 4 章 4-1 参照）

8-8. それでも解決しないとき

付録

付録 A　Web 画面のページ一覧

サイドバーに並ぶページの一覧です。ブラウザで http://localhost:3001 を開くと表示されます。すべて Claude なしで使えます。

まとまり ページ できること
ホーム ホーム ダッシュボード（利用者数・今月の記録・更新期限アラート）
記録 出来事の記録 本人の様子を絵文字ボタンで選択（喜び・不安・パニック・固まった・怒り・悲しみ）→ 場面 → 環境 → 詳細。任意で職員の対応と効果
記録 面談記録 その場で文字入力／文書ファイル添付（Word・Excel・PDF・テキスト）
管理 クライアント一覧 詳細確認・緊急照会
活用 エコマップ 支援ネットワークの関係図
活用 知識グラフ 人・情報のつながりの可視化

新しい方の登録・まとめ入力・自由な照会は、ページではなく Claude に頼みます（→ 第 6 章）。

付録 B　よく使う操作クイックリファレンス

印刷してパソコンの横に置いておける一覧です。

毎日使う

定期的に使う

必要なときに

困ったときに

付録 C　用語集

用語 やさしい説明
Docker Desktop データベースを動かすためのアプリ。「箱の中でデータベースを安全に動かす」イメージ
Neo4j 人と人のつながりを記録するのが得意なデータベース。支援者・クライアント・医療機関の関係を自然に表現できる
Node.js Web 画面を動かす裏方プログラム。一度入れたら意識不要
Web 画面 ブラウザで開く操作画面。http://localhost:3001 で表示する
API サーバー 画面とデータベースの間で情報を受け渡す裏方。8001 番を使う
localhost 「このパソコン自身」という意味。外のインターネットには出ていません
Claude このシステムが組み合わせて使う AI アシスタント（Anthropic 社）。登録・まとめ入力・照会を担当
Claude Desktop Claude のパソコン用アプリ。データベースへの差込口（MCP）はここに設定する
MCP Claude と外部の道具（このデータベースやフォルダ）をつなぐ「差込口」の仕組み。設定は docs/mcp-setup.md
.env データベースの接続先とパスワードを書いておく設定ファイル。通常は触らなくて OK
ターミナル（Mac） パソコンに直接命令を入力するアプリ。Command + スペース で「ターミナル」と検索
PowerShell（Windows） Windows 版のターミナル。スタートメニューで「PowerShell」と検索
ポート パソコン内の通信口の番号。3001（Web 画面）、8001（API）、7474・7687（データベース）を使用
仮名化 表示時に名前などを自動でマスクする機能。研修・デモ用
要配慮個人情報 障害・医療・生育歴など、特に慎重な取り扱いが法律で求められる個人情報

付録 D　関連ドキュメント

さらに詳しく知りたいときは、docs/ フォルダの各ドキュメントを参照してください。

ドキュメント 内容
docs/manuals/QUICK_START.md 短縮セットアップガイド（最短手順）
docs/manuals/SETUP_GUIDE.md 詳細セットアップガイド（本マニュアル第 3 章の元資料）
docs/manuals/USER_MANUAL_WINDOWS.md Windows 利用者向けユーザーマニュアル
docs/manuals/FIRST_5_OPERATIONS.md まず試す 5 つの操作（第 5 章の短縮版）
docs/mcp-setup.md Claude Desktop と MCP（差込口）の設定ガイド（第 6 章の元資料）
docs/manuals/PRIVACY_GUIDELINES.md プライバシーガイドライン & 個人情報保護運用規程（第 7 章の元資料）
docs/manuals/FAQ.md よくある質問とトラブルシューティング
docs/manuals/DEPLOYMENT_GUIDE.md 事業所への配布・導入手順（管理担当者向け）
docs/ADVANCED_USAGE.md 応用的な使い方
docs/SCHEMA_CONVENTION.md Neo4j 命名規則（開発者向け）
manifesto/MANIFESTO.md マニフェスト（5 つの価値と 7 本柱）

このマニュアルは「はじめての方」が導入から日常運用まで一冊でたどり着けることを目的にしています。 説明でわかりにくいところがあれば、職場の IT 担当・管理担当者にご相談ください。