hokan MCP サーバー（非公式）
hokan 保険代理店 CRM の API v2 を MCP ツールとして利用できます。
セットアップ
cd C:\Users\mktin\hokan-mcp
pip install -r requirements.txt
Claude Code への登録
C:\Users\mktin\.claude\settings.json に追記：
{
"mcpServers": {
"hokan": {
"command": "python",
"args": ["C:/Users/mktin/hokan-mcp/server.py"],
"env": {
"HOKAN_API_KEY": "ここにAPIトークンを貼り付け"
}
}
}
}
APIキーの取得
- hokan 管理画面 > 設定 > WebAPIトークン管理
- トークンを追加 → v2権限を付与
- 発行されたトークンを
HOKAN_API_KEYに設定
利用可能なツール（35個）
| カテゴリ | ツール |
|---|---|
| 顧客 | list_customers, get_customer, create_customer, update_customer, delete_customer |
| ユーザー | list_users, get_user |
| メモ | list_memos, get_memo, create_memo, update_memo, delete_memo |
| 予定 | list_calendar_events, get_calendar_event, create_calendar_event, update_calendar_event, delete_calendar_event |
| ToDo | list_todos, get_todo, create_todo, update_todo, delete_todo |
| プロジェクト | list_projects, list_project_tickets, get_project_ticket, create_project_ticket, update_project_ticket, delete_project_ticket |
| グループ | list_groups, get_group |
| 世帯 | list_customer_groups, get_customer_group |
| VOC | list_voc_tickets, create_voc_ticket |
| アクティビティ | list_activity_items |
| リード | list_leads |
認証ヘッダー
X-API-KEY: Basic $TOKEN
Strands Agent — 保険業法改正対応エージェント
agent.py は Strands Agents フレームワークを使い、hokan CRM と保険業法改正コンプライアンス対応を統合したエージェントです。
セットアップ
pip install -r requirements.txt
実行
set HOKAN_API_KEY=<hokan_token>
set ANTHROPIC_API_KEY=<anthropic_key>
python agent.py
保険業法改正ツール（6種）
| ツール | 説明 |
|---|---|
get_insurance_law_reforms | 2016/2022/2024〜2025年改正の要点取得 |
check_intent_confirmation | 意向確認書チェックリスト生成（乗換・特定保険契約対応） |
check_comparison_recommendation | 比較推奨販売規制の適用可否チェック |
check_fiduciary_duty | フィデューシャリー・デューティー（2022年改正）チェック |
get_compliance_calendar | コンプライアンス対応カレンダー |
generate_compliance_report | 代理店コンプライアンスレポート自動生成 |
対応法令
- 保険業法 第294条（意向把握・確認義務）
- 保険業法 第294条の2（比較推奨販売）
- 保険業法施行規則 第227条の2（顧客中心義務）
- 保険業法 第300条の2（特定保険契約）