Koppla

Koppla

Koppla は、自然言語を使ってユーザー、グループ、コンピューターオブジェクトを管理できる、Active Directory 向けの モデルコンテキストプロトコルサーバーです。

詳しくは、https://lazyadmin.nl/kopplaをご覧ください。

Koppla を使うと、Claude Desktop やその他の MCP 対応 AI エージェントから、Active Directory 環境をシームレスに検索、管理できます。

🔹 Koppla でできること

Koppla を使えば、複雑な Active Directory の検索と更新を簡単に実行できます。例：

• 「90 日間ログインしていない非アクティブなユーザーをすべて検索する。」
• 「John Doe を『IT Admins』セキュリティグループに追加する。」
• 「ロックアウトされたユーザーアカウントをすべて一覧表示する。」
• 「Sales 部門のユーザーをすべて検索する。」
• 「Jane Smith が所属しているグループはどれですか？」
• 「空のグループを表示する。」
• 「グループ A にはいてグループ B にはいないユーザーを検索する。」

---

🚀 はじめに

1️⃣ 前提条件

• Python 3.7 以降
• Active Directory 環境
• Claude Desktop アプリケーション（Claude との連携用）

2️⃣ インストール

Koppla には Python が必要です。次のコマンドでインストールできます。

pip install koppla

3️⃣ 設定

設定マネージャーを使用する（推奨）

Koppla には、機密性の高い認証情報の暗号化を行う、安全な設定マネージャーが含まれています。

koppla-config configure

この対話型ツールでは、次の処理を行います。

1. Active Directory の接続情報を入力するよう求めます
2. Fernet 対称暗号化を使ってパスワードを安全に暗号化します
3. Koppla サーバー設定を含む Claude Desktop の設定ファイルを作成または更新します
4. 既存の Claude Desktop 設定のバックアップを自動的に作成します
5. 認証情報を確認するために接続をテストします

次の操作も実行できます。

• 現在の設定を表示する：koppla-config show
• AD 接続をテストする：koppla-config test

手動設定

Koppla の設定には環境変数を使用します。

名前	説明
AD_SERVER	Active Directory サーバーのアドレス。
AD_USER	認証に使用するユーザー名。
AD_PASSWORD	認証に使用するパスワード。
BASE_DN	LDAP クエリのベース DN。
AD_WRITE_ENABLED	書き込み操作を有効または無効にします（true/false）。

---

Koppla を Claude Desktop アプリで手動設定するには、次の設定を claude_desktop_config.json の「mcpServers」セクションに追加してください。

{
  "mcpServers": {
    "Koppla-Active-Directory": {
        "command": "python",
        "args": ["-m", "koppla.server"],
        "env": {
            "AD_SERVER": "ldap://<domain-controller-name>:389",
            "AD_USER": "<domain\\username>",
            "AD_PASSWORD": "<password>",
            "BASE_DN": "DC=lazyadmin,DC=nl",
            "AD_WRITE_ENABLED": "false"
        }
    }
  }
}

⚠️ データ処理とプライバシーに関する通知

重要：Koppla は、処理のために Active Directory のデータを外部 AI モデルに送信します。特に、GDPR や同様の規制の対象となる組織では、セキュリティやコンプライアンスに影響する可能性があります。Koppla 自体は AD データを保存しませんが、AI エージェントが独自のポリシーに従って会話履歴を保持する場合がある点にご注意ください。組織のデータ取り扱い要件に準拠して使用し、設定を慎重に行ってクエリ可能なデータの範囲を制限することを検討してください。

🔒 セキュリティ機能

パスワードの暗号化

• Koppla は Fernet 対称暗号化（cryptography パッケージの機能）を使って、Active Directory のパスワードを保護します
• 暗号化キーは設定とは別に、アクセス許可を制限したキーファイルに保存されます
• 設定マネージャーを使用すると、パスワードが平文で保存されることはありません
• 暗号化されたパスワードは、設定ファイル内で ENCRYPTED:xxxx... と表示されます

バックアップシステム

• 設定を変更する前に、Koppla は Claude Desktop の設定をタイムスタンプ付きで自動的にバックアップします
• バックアップは設定ファイルと同じ場所に、次の形式で保存されます：claude_desktop_config.json.backup_YYYYMMDD_HHMMSS

書き込み保護

• デフォルトでは、すべての書き込み操作（グループへのユーザーの追加・削除、ユーザー属性の更新）が無効になっています
• 書き込み操作を有効にするには、AD_WRITE_ENABLEDを「true」に設定します
• 重要なアカウントとグループには、書き込み設定にかかわらず、追加の保護が適用されます

対応している書き込み操作

Kopplaは、AD_WRITE_ENABLEDを「true」に設定すると、次の書き込み操作に対応します。

1. ユーザー属性の更新

   • 説明、役職、部署などの標準的なユーザー属性を変更します
   • 保護対象のフィールド（パスワード、セキュリティ識別子、アカウント制御）は変更できません
   • 保護対象のアカウント（管理者、サービスアカウントなど）は変更できません

2. グループへのユーザーの追加

   • 標準ユーザーをセキュリティグループまたは配布グループに追加します
   • 保護対象の管理グループにはユーザーを追加できません
   • 保護対象のアカウントはいずれのグループにも追加できません

3. グループからのユーザーの削除

   • ほとんどのセキュリティグループまたは配布グループからユーザーを削除します
   • 重要なシステムグループからユーザーを削除することはできません
   • 保護対象のアカウントはいずれのグループからも削除できません

すべての書き込み操作の実行前に、明示的な確認が必要です。