# hokan MCP サーバー（非公式）

hokan 保険代理店 CRM の [API v2](http://ext-api-v2.hokan.io/) を MCP ツールとして利用できます。

## セットアップ

```bash
cd C:\Users\mktin\hokan-mcp
pip install -r requirements.txt
```

## Claude Code への登録

`C:\Users\mktin\.claude\settings.json` に追記：

```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](https://strandsagents.com/) フレームワークを使い、hokan CRM と保険業法改正コンプライアンス対応を統合したエージェントです。

## セットアップ

```bash
pip install -r requirements.txt
```

## 実行

```bash
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（特定保険契約）