親なき後支援データベース — ゼロから導入し、毎日の業務で使いこなすまで
対象: 障害福祉の現場で働く支援員・相談員の方(Mac / Windows 両対応)|最終更新: 2026-07-10
親なき後支援データベース nest-support を「ゼロから導入し、毎日の業務で使いこなす」までを 1 冊にまとめた完全ガイドです。
- 対象読者: パソコンの操作に不慣れな方でも大丈夫。障害福祉の現場で働く支援員・相談員の方を想定しています
- 対応 OS: Mac / Windows 両対応(手順ごとに両方の操作を記載しています)
- 所要時間の目安: 導入 30 分〜1 時間(第 2〜4 章)。応用機能は必要になったときで OK
最終更新: 2026-07-10
この書体 の部分は、パソコンに入力する文字列です。そのままコピーして貼り付けてくださいnest-support は、知的障害・精神障害のある方の支援情報を、Claude(AI アシスタント)に日本語で話しかけるだけで記録・整理・確認できるシステムです。
親が長年かけて蓄積してきた「我が子を守るための暗黙知」を、親なき後も機能する社会的システムへと継承するためのデジタル・アーカイブです。
たとえば、こんなことができます。
たとえるなら: Claude は「よく気のつくベテラン相談員」、データベースは「鍵のかかった頑丈なキャビネット」です。あなたが口頭で頼むと、Claude がキャビネットから正確な書類を出してくれます。
このシステムは、次の 5 つの価値を軸に設計されています。
| 価値 | 定義 |
|---|---|
| 尊厳 (Dignity) | 管理対象ではなく、歴史と意思を持つ一人の人間として記録する |
| 安全 (Safety) | 緊急時に「誰が」「何を」すべきか、迷わせない構造を作る |
| 継続性 (Continuity) | 支援者が入れ替わっても、ケアの質と文脈を断絶させない |
| 強靭性 (Resilience) | 親が倒れた際、その機能を即座に代替できるバックアップ体制を可視化する |
| 権利擁護 (Advocacy) | 本人の声なき声を拾い上げ、法的な後ろ盾と紐づける |
┌───────────────────────────────────────────────────────┐
│ │
│ あなた(支援者) │
│ ↕ 日本語で話しかける │
│ Claude Desktop(AI アシスタント) │
│ ↕ Skills(業務手順書・13 種類)を参照して操作 │
│ Neo4j(グラフデータベース) │
│ └─ 支援記録・禁忌事項・連絡先・手帳情報 などを保管 │
│ │
└───────────────────────────────────────────────────────┘
ポイント: あなたがやることは「Claude に話しかける」だけです。データベースの操作は Claude が代行します。どのスキルを使うかも Claude が自動で選ぶので、覚える必要はありません。
必要なアプリは 3 つだけ です。
| アプリ名 | 役割 | 日常的に例えると |
|---|---|---|
| Docker Desktop | データベースを動かす土台 | データベースの「電源スイッチ」 |
| Claude Desktop | AI アシスタント | 何でも相談できる「データベース係」 |
| Node.js | Claude とデータベースをつなぐ裏方 | 「通訳」。設定後は意識しなくて OK |
| 項目 | 条件 |
|---|---|
| OS | Windows 10 / 11、または macOS |
| メモリ | 8GB 以上を推奨 |
| 管理者権限 | インストール時に必要(会社の PC の場合は情報システム担当に相談) |
| インターネット接続 | インストール時と、Claude が応答するときに必要 |
補助金のご案内: ICT 導入支援事業の補助金(補助率 10/10)が活用できる場合があります。お住まいの自治体にお問い合わせください。
Claude Desktop のログインに使うアカウントです。まだお持ちでない場合は、メールアドレスがあれば https://claude.ai で作成できます(インストール時に作成しても OK)。
初回のみ行う作業です。一度終われば、次回からは「起動」だけで使えます。
全体の流れは次のとおりです。
Step 1 3 つのアプリを準備する(Docker Desktop / Claude Desktop / Node.js)
↓
Step 2 ワンクリックインストーラーを実行する(Step 3〜5 相当を自動実行)
↓
(うまくいかない場合のみ)
Step 3 手動: nest-support をダウンロードしてデータベースを起動
Step 4 手動: Claude にデータベースを教える(MCP 設定)
Step 5 手動: Claude に業務手順書を渡す(Skills 設定)
↓
Step 6 Claude Desktop を再起動して接続を確認
すでにインストール済みのアプリは飛ばしてください。
なぜ必要? — クライアントの情報を保存するデータベース(Neo4j)を動かすための土台です。
.dmg ファイルを開き、Docker のアイコンを「アプリケーション」フォルダにドラッグ
- Windows: .exe ファイルを開き、画面の指示に従って進めます。「Use WSL 2 instead of Hyper-V」にチェックが入っていることを確認し、完了後「Close and restart」でパソコンを再起動うまくいかないとき
| 症状 | 対処法 |
|---|---|
| Windows で「WSL 2 が必要です」と出る | PowerShell を「管理者として実行」→ wsl --install と入力 → パソコン再起動 |
| Windows で「仮想化が無効です」と出る | 「お使いの PC 名 BIOS 仮想化 有効」で検索して設定を変更 |
| Mac で「システム拡張がブロックされました」 | 「システム設定」→「プライバシーとセキュリティ」で許可 |
| クジラのアイコンが出てこない | パソコンを再起動してからもう一度 Docker Desktop を開く |
なぜ必要? — このシステムの操作はすべて Claude(AI アシスタント)に日本語で話しかけて行います。
うまくいかないとき
| 症状 | 対処法 |
|---|---|
| ログインできない | メールアドレスとパスワードを確認。「パスワードを忘れた場合」からリセット |
| アプリが開かない | パソコンを再起動してから試す |
なぜ必要? — Claude Desktop とデータベースを橋渡しする裏方のプログラムです。一度入れたら、あとは意識する必要はありません。
確認したい方は、Mac は「ターミナル」、Windows は「PowerShell」を開いて node --version と入力し、v20.xx.x のようなバージョン番号が出れば OK です。
なぜ必要? — nest-support 本体のダウンロード、データベースの起動、Skills のインストール、Claude Desktop への接続設定、デモデータの投入(任意)、接続テストまでをすべて自動で行ってくれます。
Command + スペース →「ターミナル」と入力して Entercurl -sL https://raw.githubusercontent.com/kazumasakawahara/nest-support/main/installer/install-mac.sh | bash
本体は
書類(Documents)/nest-supportフォルダに保存されます。
Set-ExecutionPolicy Bypass -Scope Process -Force
irm https://raw.githubusercontent.com/kazumasakawahara/nest-support/main/installer/install-windows.ps1 | iex
貼り付けは、画面内で右クリックすると行えます(Ctrl+V が効かない場合があります)。
本体は
ドキュメント\nest-supportフォルダに保存されます。
途中で Docker Desktop のインストールを促された場合は、指示どおりインストール後、パソコンを再起動してからもう一度インストーラーを実行してください。
うまくいかないとき
| 症状 | 対処法 |
|---|---|
| 「permission denied」 | Mac: もう一度実行 / Windows: PowerShell を「管理者として実行」で開き直す |
| ダウンロードが途中で止まる | インターネット接続を確認してもう一度実行 |
| 「Docker が起動していません」 | Docker Desktop を起動(クジラのアイコンを確認)してから再実行 |
ワンクリックインストーラーが成功した方は、Step 3〜5 は不要です。Step 6 に進んでください。
インストーラーがうまく動かなかった場合の手動手順です。
~/Documents/nest-support/
- Windows: C:\Users\あなたの名前\Documents\nest-support\フォルダ名に注意: 展開すると
nest-support-mainというフォルダ名になる場合があります。nest-supportにリネームしてください。
Mac の方 — ターミナルで:
cd ~/Documents/nest-support
chmod +x setup.sh
./setup.sh
Windows の方 — PowerShell(管理者)で:
cd $env:USERPROFILE\Documents\nest-support
Set-ExecutionPolicy Bypass -Scope Process -Force
.\setup.ps1
「セットアップが完了しました!」と表示されるまで待ちます(初回は 3〜5 分かかることがあります)。このスクリプトはデータベースの起動と Skills のインストールの両方を行います。
確認方法: ブラウザで http://localhost:7474 を開き、ログイン画面が表示されたら成功です(ユーザー名 neo4j / パスワード password)。この画面は「データベースの管理画面」で、普段使う必要はありません。
なぜ必要? — Claude Desktop に「データベースはここにありますよ」と教えてあげる設定です。
Mac の方:
cd ~/Documents/nest-support
chmod +x installer/configure-claude.sh
./installer/configure-claude.sh
Windows の方:
cd $env:USERPROFILE\Documents\nest-support
.\installer\configure-claude.ps1
「完了」と表示されたら → Step 5 へ。
~/Library/Application Support/Claude/ と入力 → claude_desktop_config.json を開く(無ければテキストエディットで新規作成)
- Windows: Windows キー + R → notepad %APPDATA%\Claude\claude_desktop_config.json と貼り付けて OK →「新しく作成しますか?」→「はい」{
"mcpServers": {
"neo4j": {
"command": "npx",
"args": ["-y", "@alanse/mcp-neo4j-server"],
"env": {
"NEO4J_URI": "bolt://localhost:7687",
"NEO4J_USERNAME": "neo4j",
"NEO4J_PASSWORD": "password"
}
}
}
}
既に他の設定がある場合: 上書きせず、
"mcpServers"の中に"neo4j"の部分だけを追加してください。不安な場合は、元のファイルをコピーしてバックアップしてから編集すると安心です。
Command + S / Windows: Ctrl + S)Windows のメモ帳の注意: 保存時にファイル名が
.txtで終わらないよう、「ファイルの種類」を「すべてのファイル」にして、末尾が.jsonになっていることを確認してください。Windows で「npx が見つからない」と言われる場合: PowerShell で
where npxを実行し、表示されたパス(例:C:\Program Files\nodejs\npx.cmd)を"command"に指定します。パスの\は\\と 2 つ重ねて書きます。
なぜ必要? — Skills(スキル)は、Claude に「このデータベースではこういう操作ができるよ」と教えるための業務手順書です。これがないと Claude はデータベースの使い方がわかりません。
Mac の方: Step 3-2 で ./setup.sh を実行済みなら、Skills は自動でインストールされています。手動で再インストールする場合:
cd ~/Documents/nest-support
./setup.sh --skills
Windows の方: setup.ps1 を実行済みならインストールされています。うまくいかない場合は手動コピーもできます:
claude-skills フォルダを開くC:\Users\あなたの名前\.claude\skills\ に貼り付け
- .claude フォルダが見えない場合: エクスプローラーの「表示」→「隠しファイル」にチェック
- skills フォルダがない場合: .claude の中に skills という名前で新規作成ここまでの設定を反映するため、Claude Desktop を一度「完全に」終了して開き直します。
∧ マーク)の Claude アイコンを右クリック →「Quit」→ スタートメニューから再度開く注意: ウィンドウの「×」ボタンだけではバックグラウンドで動いたままの場合があります。必ず「Quit」で完全終了してください。
接続成功の確認: Claude Desktop を開き直したとき、チャット入力欄のあたりにツール(ハンマー/🔧)のアイコンがあり、neo4j が表示されていれば、データベースとの接続が成功しています。
Mac の方は、doctor.sh で全体の整合性(Docker コンテナ・データベース疎通・Skills・MCP 設定)を一発確認できます。
cd ~/Documents/nest-support
./scripts/doctor.sh
問題があれば具体的な FAIL 項目が表示されます。常時 All PASS を目標にしてください。
Windows の方は、この後の「テスト 1〜3」がそのまま動作確認になります。
Claude Desktop を開いて、以下のように話しかけます:
データベースの統計情報を教えて
Claude がデータベースにアクセスし、「クライアント数: 0」のような統計情報を返してくれたら接続成功です。
以下の情報をデータベースに登録してください。
名前: テスト太郎 生年月日: 1990年4月1日 血液型: A型 特性: 自閉スペクトラム症 禁忌事項: 後ろから急に声をかけないこと。パニックになる。 推奨ケア: 声をかけるときは正面から、ゆっくり話す。
Claude が情報を整理して確認してから、データベースに登録してくれます。
テスト太郎さんのプロフィールを見せて
先ほど登録した情報が表示されれば、セットアップは完了です。おめでとうございます!
動作確認が済んだら、テスト用のデータは削除しておきましょう:
テスト太郎さんのデータをすべて削除してください
操作に慣れるため、架空の人物データで練習できます。インストーラーで「デモデータを入れますか?」に「はい」と答えた方は投入済みです。
Mac の方:
cd ~/Documents/nest-support
chmod +x installer/load-demo-data.sh
./installer/load-demo-data.sh
Windows の方:
cd $env:USERPROFILE\Documents\nest-support
.\installer\load-demo-data.ps1
デモデータ投入後、こんなふうに試せます:
山本翔太さんの緊急情報を教えて
鈴木花さんの禁忌事項を教えて
更新期限が近い手帳・受給者証を確認して
感情シミュレーションデータも入れる場合(予兆検知の練習用・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
デモデータには
isDemo = trueのフラグが付いており、実データと区別されます。研修や説明会では実データではなく、必ずこのデモデータを使ってください(→ 第 7 章)。
使い方の基本は、たった 1 つ。
Claude Desktop の入力欄に、ふだんの言葉で、やりたいことを書く。
コツは 3 つだけです。
Claude が、13 種類ある専門「スキル」の中から、あなたの用件に一番合うものを自動で選んで答えます。
⚠️ AI は「推測で作り話」をしない設計です。情報が無いときは「記録がありません」と答えます。逆に言うと、登録していないことは出てきません。大切なことは必ず記録しましょう。
そのままコピーして使える「話しかけ例」です。名前の部分をあなたの担当者に置き換えてください。
新しいクライアントを登録したい
登録ウィザードが起動し、①氏名・生年月日 → ②禁忌事項(最重要)→ ③配慮事項 → ④キーパーソン → ⑤かかりつけ医、の順に聞き取りを案内します。全部を一度に入力しなくても大丈夫。 わかる範囲から登録して、あとで追加できます。
山本翔太さんの緊急情報を教えて
重要な順(①禁忌事項 → ②推奨ケア → ③緊急連絡先 → ④かかりつけ医 → ⑤後見人)に表示されます。新しい職員がクライアントに関わる前には、必ずこれを確認してください。
山本翔太さんの訪問準備をして
前回の記録・注意点・最近の変化・今回の確認ポイントがまとめて出ます。訪問の前日〜当日にどうぞ。
山本翔太さんの支援記録を追加: 今日の訪問で、新しい絵を見せてくれた。 母から相談:来月の手帳更新について心配している。 次回は更新手続きの準備を一緒に行う予定。
日常のできごとを自然な文章のまま入力するだけ。自動で整理されて保存されます。
更新期限が近い手帳・受給者証を確認して
今後 90 日以内に更新が必要なものが一覧で出ます。更新漏れは本人の不利益に直結します。
このシステムの核心機能です。親御さんの語りや聞き取りメモなどの自然な日本語テキストを Claude に渡すだけで、構造化されてデータベースに登録されます。
以下の聞き取り内容を構造化してデータベースに登録してください。
うちの太郎はね、昭和62年の夏に生まれたんです。小さい頃から 音に敏感で、運動会のピストルの音で泣いてしまって…。 今でも大きな音は絶対ダメです。掃除機も怖がります。 でもね、音楽は好きなんですよ。童謡を歌ってあげると にこにこして、すごく穏やかになるの。 かかりつけは北九州中央病院の田中先生です。月に一回通ってます。 療育手帳は A1 で、来年の 3 月に更新です。
テキスト中の表現から、禁忌事項(「〜しないで」「絶対ダメ」)、推奨ケア(「〜すると落ち着く」)、診断、連絡先、病院・医師、手帳と更新期限、生育歴などが自動で分類・抽出されます。和暦(昭和・平成・令和)は自動的に西暦に変換されます。
Word・Excel・PDF・テキストのファイルを添付して「この面談記録を登録して」と頼むこともできます。
セットアップは最初の 1 回だけです。普段は以下だけで使えます。
朝(使い始めるとき)
便利な設定: Docker Desktop を「ログイン時に自動起動」にしておくと、手順 2 を省略できます。 Docker Desktop → Settings(歯車アイコン)→ General → 「Start Docker Desktop when you sign in」にチェック
夜(終わるとき)
特別な操作は不要です。パソコンをそのままシャットダウンして構いません。データは自動的に保存され、次回起動時に復元されます。
| やること | 方法 |
|---|---|
| 更新期限の確認 | Claude に「更新期限が近い手帳・受給者証を確認して」 |
| データ品質チェック | Claude に「データ品質チェックをお願いします」 |
| バックアップ | 下記のコマンドを実行(またはフォルダをコピー) |
バックアップの方法
クライアントの情報は大切な資産です。月に 1 回はバックアップすることをお勧めします。
# Mac(ターミナル)
cd ~/Documents/nest-support
docker compose stop
cp -r neo4j_data neo4j_data_backup_$(date +%Y%m%d)
docker compose start
# Windows(PowerShell)
cd $env:USERPROFILE\Documents\nest-support
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フォルダをコピーするだけでできます。
| やりたいこと | Claude にこう話しかける |
|---|---|
| 意味で検索する | 「入浴を嫌がるケースを検索して」(「お風呂拒否」もヒット・要 Gemini 設定) |
| エコマップを作る | 「〇〇さんのエコマップを作成して」 |
| 事業所を探す | 「北九州市の生活介護で空きのある事業所を検索して」 |
| 口コミを見る | 「△△事業所の口コミを見せて」 |
| 親なき後の備えを診断 | 「〇〇さんのレジリエンス診断をして」 |
| 感情トレンドを分析する | 「〇〇さんの最近の変化を分析して」 |
| 相続の計算 | 「配偶者と子供 2 人がいる場合の法定相続分を計算して」 |
| 緊急時 | 「田中さんがパニックを起こしています。緊急対応情報をください」 |
第 6 章の機能はすべて任意です。基本の記録・照会は第 5 章までで完結します。必要になったときに設定してください。
何ができるようになる?
Gemini API キーがなくても、テキスト入力での登録やデータ閲覧は問題なく使えます。
設定手順
.env ファイルをメモ帳(テキストエディット)で開き、追記:GEMINI_API_KEY=取得したキーをここに貼り付け
uv run python scripts/backfill_embeddings.py --all
⚠️ 個人情報の注意: Gemini API を設定すると、支援記録・禁忌事項などのテキストや音声ファイルが Google のサーバーに送信されます(実名・生年月日は概要送信から除外される設計です)。外部送信を避けたい場合はキーを設定しないでください。詳細は 第 7 章 を参照。
音声で記録を残す
Gemini 設定後は、Claude Desktop に音声ファイル(MP3 / WAV / M4A など)を添付して:
この録音を山田太郎さんの面談記録として登録して
詳しい録音の仕方は docs/VOICE_RECORDING_GUIDE.md を参照してください。
多機能インポーター(まとめて登録)
音声・画像・PDF・テキストをフォルダごと一括登録できます:
# 単一ファイル
uv run python scripts/multi_importer.py 録音.m4a --client "山田太郎" --supporter "鈴木"
# フォルダ一括
uv run python scripts/multi_importer.py ./今日の記録/ --client "山田太郎"
# ドライラン(登録せず結果だけ確認)
uv run python scripts/multi_importer.py memo.jpg --client "山田太郎" --dry-run
対応形式: .mp3 .wav .m4a .ogg .flac .docx .xlsx .pdf .txt .jpg .png .webp .heic
現場スタッフがスマホのブラウザから直接操作できる画面です。Claude Desktop を使わずに、支援記録の入力や感情サマリーの確認ができます。
起動方法(パソコン側で・ターミナル / PowerShell):
cd ~/Documents/nest-support # Windows: cd $env:USERPROFILE\Documents\nest-support
uv run uvicorn field-ui.server:app --host 0.0.0.0 --port 8001
3 つの画面
| 画面 | URL | 説明 |
|---|---|---|
| 支援記録フォーム | http://localhost:8001/record | チップ選択式の簡単入力。現場からすばやく登録 |
| 管理者ダッシュボード | http://localhost:8001/dashboard | クライアントの感情サマリーとドリルダウン分析 |
| 音声ワンタップ録音 | http://localhost:8001/voice | ブラウザで録音 → 文字起こし → 自動登録(要 Gemini) |
スマホからは、同じ Wi-Fi 内であれば http://パソコンの IP アドレス:8001 でアクセスできます。
認証について: 現場 UI の情報取得にはログイン(認証)が必要です。
.envのAPP_ACCESS_TOKENに長いランダムな文字列を設定してください(未設定のままだと保護された API は動作しません)。設定・URL の発行は管理担当者が行ってください。
知的障害のある方ご本人が、スマホからワンタップで支援者グループの LINE に SOS を送れるサービスです。位置情報(Google Maps リンク)、キーパーソンの連絡先、禁忌事項が自動でメッセージに含まれます。
設定手順(管理担当者向け)
.env に設定:LINE_CHANNEL_ACCESS_TOKEN=取得したトークン
LINE_GROUP_ID=グループID
cd sos
uv run python api_server.py
http://サーバーのアドレス:8000/app/?id=クライアント名 を開き、ホーム画面に追加(PWA)LINE の認証情報が未設定の場合は自動的にモック送信モード(画面出力のみ)で動くため、事前に安全にテストできます。
設計上の注意: SOS の送信ボタンだけは、緊急時に確実に使えるようあえてログイン不要です。その分、退職者を LINE グループから即時除外するなどの運用管理を徹底してください。
D3.js による感情時系列チャート + 関係図 + AI 相談プロンプトを統合したダッシュボードを生成できます。
Claude に「山本翔太さんのエコマップを作成して」と頼むだけでも生成されます。コマンドで直接生成する場合:
uv run python claude-skills/ecomap-generator/scripts/generate_html.py "山本翔太" hybrid
このシステムは、障害のある方やご家族の要配慮個人情報(障害の種類・等級、医療情報、生育歴等)を扱います。導入する事業所は必ずこの章を確認してください。
保存場所: クライアントの情報(データベース本体)は、すべてお使いのパソコンの中(nest-support/neo4j_data/ フォルダ)に保存されます。クラウドのデータベースは使いません。
ただし「すべてローカルで完結」ではありません。次の通信が発生します。
| 通信先 | いつ・何が送られるか | 避けたい場合 |
|---|---|---|
| Anthropic 社(Claude) | Claude Desktop に入力した内容・Claude が読み取ったデータ(応答生成のため) | 仮名化機能の利用を推奨。組織の規程と照らして運用判断 |
| Google 社(Gemini API) | 音声ファイル、スキャン画像、支援記録等のテキスト(文字起こし・OCR・意味検索のため。実名・生年月日は概要送信から除外) | GEMINI_API_KEY を設定しない(該当機能はスキップされる) |
| LINE 社(SOS 通知) | クライアント名・位置情報・緊急連絡先・禁忌事項(SOS 送信時のみ) | SOS 機能を使わない。グループのメンバー管理を徹底 |
Pro プランの場合、Claude への入力データは AI モデルのトレーニングには使用されません(2025 年 3 月時点。ポリシーは変更される可能性があるため定期的に確認を: https://www.anthropic.com/privacy )
やること
やってはいけないこと
研修や説明会で画面を見せる場面では、表示時に名前を自動でマスクできます。データベース内の実データは変更されません。
| モード | 表示例 | 用途 |
|---|---|---|
mask |
山田 → 山●●● | 研修、説明会、デモ |
pseudonym |
山田 → 青山あおい | テスト、開発、公開資料 |
.env に設定して有効化します:
PSEUDONYMIZATION_ENABLED=true
PSEUDONYMIZATION_MODE=mask
研修が終わったら false に戻してください。
安全上の例外: 禁忌事項・推奨ケア・手帳の種類等級は、緊急時の安全に直結するため仮名化されません。
初回利用時はマイグレーションが必要です。詳細は
docs/PRIVACY_GUIDELINES.mdの「仮名化の有効化手順」を参照してください。
データベースの初期パスワード(password)は、本番運用前に必ず変更してください。
docker-compose.yml の NEO4J_AUTH=neo4j/password を強いパスワードに変更claude_desktop_config.json)の NEO4J_PASSWORD も同じ値に変更.env の NEO4J_PASSWORD も同じ値に変更docker compose stop でデータベースを停止Docker Desktop と Claude Desktop の両方を再起動する。 多くの不調はこれで直ります。
それでもダメなときは、Claude 自身に聞くのも有効です:
セットアップで困っています
〇〇というエラーが出ました(エラーメッセージをそのまま伝える)
| 症状 | よくある原因 | 解決法 |
|---|---|---|
| Docker Desktop が起動しない | インストール未完了 | パソコンを再起動 → Docker Desktop を開く |
| 「port is already allocated」 | 前回のデータベースが残っている | Docker Desktop の画面で該当コンテナを停止 → 再起動 |
| Claude がデータベースにつながらない | 設定ファイルの記述ミス | 第 3 章 Step 4 の JSON を丸ごとコピーし直す |
ツールアイコンに neo4j が出ない |
Claude Desktop を完全終了していない | 「Quit」で完全終了 → 開き直し(× ボタンでは不十分) |
| 「npx: command not found」 | Node.js 未インストール or 再起動していない | 第 3 章 Step 1-3 をやり直す → パソコン再起動 |
| JSON の書式エラー | カンマの過不足 | Claude に JSON を見せて「間違いがないか確認して」と聞く |
| 「話しかけても情報がありませんと言われる」 | まだ登録されていないだけ(故障ではない) | 第 5 章の操作 1・4 で登録してから再確認 |
| パソコンの動作が遅い | メモリ不足 | Docker Desktop → Settings → Resources でメモリ調整。使わないときは docker compose stop |
# コンテナの状態確認(Mac / Windows 共通)
docker ps
# 再起動
cd ~/Documents/nest-support # Windows: cd $env:USERPROFILE\Documents\nest-support
docker compose restart
# ログの確認
docker logs nest-support-neo4j
ブラウザで http://localhost:7474 を開き、画面が出れば動いています(neo4j / password)。
よくある原因: Docker Desktop が起動していない / ポート 7474・7687 が他のアプリに使われている / メモリ不足(Docker Desktop の Settings → Resources で 4GB 以上に)。
# Mac
cat ~/Library/Application\ Support/Claude/claude_desktop_config.json
# Windows
Get-Content "$env:APPDATA\Claude\claude_desktop_config.json"
# Mac
cd ~/Documents/nest-support && ./installer/configure-claude.sh
# Windows
cd $env:USERPROFILE\Documents\nest-support; .\installer\configure-claude.ps1
npx -y @alanse/mcp-neo4j-server --help# Mac — 状態確認と再インストール
ls -la ~/.claude/skills/
cd ~/Documents/nest-support && ./setup.sh --skills
# Windows — 状態確認と再インストール
dir $env:USERPROFILE\.claude\skills\
cd $env:USERPROFILE\Documents\nest-support; .\setup.ps1 -Skills
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> |
| 症状 | 対処法 |
|---|---|
| 「開発元を確認できない」警告 | chmod +x setup.sh installer/*.sh で実行権限を付与 |
| 環境の総点検をしたい | ./scripts/doctor.sh を実行(第 4 章 4-1 参照) |
docs/FAQ.md — よくある質問と詳しいトラブルシューティングClaude が状況に応じて自動で選ぶ「業務手順書」です。名前を覚える必要はありませんが、何ができるかの一覧として参考にしてください。
| Skill | 対象業務 | 説明 |
|---|---|---|
neo4j-support-db |
クライアント管理 | プロフィール、支援記録、ケアパターン発見、更新期限チェック |
onboarding-wizard |
新規登録 | 対話型の聞き取りで新規クライアントを登録 |
narrative-extractor |
テキスト→登録 | 語りや記録の文章から構造化データを抽出・登録 |
emergency-protocol |
緊急時対応 | Safety First プロトコル(禁忌→推奨ケア→連絡先→医療→後見人) |
visit-prep |
訪問準備 | 禁忌事項・推奨ケア・直近記録の自動収集ブリーフィング |
insight-agent |
予兆検知 | 感情トレンド分析、連鎖リスク検知、ケアパターン自動発見 |
resilience-checker |
親なき後診断 | 親が担う機能のカバー率診断・代替サービス候補の検索 |
provider-search |
事業所検索 | サービス種類・地域・空き状況での検索、口コミ評価 |
wamnet-provider-sync |
WAM NET 同期 | 障害福祉サービス情報公表システムからのデータ同期 |
data-quality-agent |
品質チェック | 更新期限アラート・データ欠損・スキーマ違反の検出 |
ecomap-generator |
可視化 | エコマップ・インサイトビューの生成 |
inheritance-calculator |
相続計算 | 日本民法に基づく法定相続人・相続分の計算 |
html-to-pdf |
PDF 変換 | HTML → PDF の全自動変換 |
印刷してパソコンの横に置いておける一覧です。〇〇には担当クライアントの名前を入れてください。
毎日使う
定期的に使う
必要なときに
困ったときに
| 用語 | やさしい説明 |
|---|---|
| Docker Desktop | データベースを動かすためのアプリ。「箱の中でデータベースを安全に動かす」イメージ |
| Neo4j | 人と人のつながりを記録するのが得意なデータベース。支援者・クライアント・医療機関の関係を自然に表現できる |
| Claude Desktop | Anthropic 社の AI アシスタント。日本語で話しかけるだけでデータベースを操作してくれる |
| Node.js / npx | Claude とデータベースをつなぐ裏方プログラム。一度設定したら意識不要 |
| MCP | Claude がデータベースなどの外部ツールと連携するための仕組み(Model Context Protocol の略) |
| Skills | Claude に業務の手順を教える説明書ファイル。13 種類が用意されている |
| ターミナル(Mac) | パソコンに直接命令を入力するアプリ。Command + スペース で「ターミナル」と検索 |
| PowerShell(Windows) | Windows 版のターミナル。スタートメニューで「PowerShell」と検索 |
| ポート | パソコン内の通信口の番号。nest-support は 7474・7687(DB)、8000(SOS)、8001(現場 UI)を使用 |
| JSON | 設定ファイルの書き方のルール。カンマや波かっこの位置が 1 つでもずれると動かない |
| セマンティック検索 | キーワードの一致ではなく「意味」で検索する機能 |
| embedding | 文章を数値(ベクトル)に変換したもの。セマンティック検索の裏側で使われている技術 |
| PWA | スマホのホーム画面に追加して、アプリのように使える Web ページ |
| 仮名化 | 表示時に名前などを自動でマスクする機能。研修・デモ用 |
| 要配慮個人情報 | 障害・医療・生育歴など、特に慎重な取り扱いが法律で求められる個人情報 |
さらに詳しく知りたいときは、docs/ フォルダの各ドキュメントを参照してください。
| ドキュメント | 内容 |
|---|---|
docs/QUICK_START.md |
5 分セットアップガイド(技術者向けの最短手順) |
docs/SETUP_GUIDE.md |
詳細セットアップガイド(本マニュアル第 3 章の元資料) |
docs/USER_MANUAL_WINDOWS.md |
Windows 利用者向けユーザーマニュアル |
docs/FIRST_5_OPERATIONS.md |
まず試す 5 つの操作(第 5 章の短縮版) |
docs/ADVANCED_USAGE.md |
Skills の詳細な使い方とプロンプト例 |
docs/VOICE_RECORDING_GUIDE.md |
声の記録マニュアル(現場スタッフ向け) |
docs/PRIVACY_GUIDELINES.md |
プライバシーガイドライン & 個人情報保護運用規程(第 7 章の元資料) |
docs/FAQ.md |
よくある質問とトラブルシューティング |
docs/SCHEMA_CONVENTION.md |
Neo4j 命名規則(開発者向け) |
manifesto/MANIFESTO.md |
マニフェスト(5 つの価値と 7 本柱) |
sos/README.md |
SOS 緊急通知サービスの詳細 |
このマニュアルは「はじめての方」が導入から日常運用まで一冊でたどり着けることを目的にしています。 説明でわかりにくいところがあれば、Claude 自身に「このマニュアルのここが分からない」と聞くこともできます。