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キーの取得

1. hokan 管理画面 > 設定 > WebAPIトークン管理
2. トークンを追加 → v2権限を付与
3. 発行されたトークンを 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（特定保険契約）