配对
Koppla是一个 模型上下文协议服务器 为了 活动目录 它使您能够使用自然语言管理用户、组和计算机对象。
有关更多信息，请访问 https://lazyadmin.nl/koppla
使用Koppla，您可以使用Claude Desktop或其他支持MCP的AI代理无缝查询和管理您的Active Directory环境。
🔹 Koppla能做什么？
Koppla允许您执行复杂的 Active Directory查询和更新 毫不费力。示例：
- “查找所有90天内未登录的非活动用户。”
- “将John Doe添加到‘IT管理员’安全组。”
- “列出所有锁定的用户帐户。”
- “查找销售部门的所有用户。”
- “简·史密斯属于哪些团体？”
- “显示空组。”
- “查找组A中的用户，但不查找组B中的用户。”
______________________________________________________________________
🚀 入门指南
1.️⃣ 先决条件
- Python 3.7或更高版本
- Active Directory环境
- Claude桌面应用程序（用于与Claude集成）
2.️⃣ 安装
Koppla需要Python，可以使用以下方式安装：
pip install koppla3.️⃣ 配置
使用配置管理器（推荐）
Koppla包括一个处理敏感凭据加密的安全配置管理器：
koppla-config configure此交互式工具将：
- 提示输入Active Directory连接详细信息
- 使用Fernet对称加密对密码进行安全加密
- 使用Koppla服务器设置创建或更新Claude Desktop配置文件
- 自动创建现有Claude Desktop配置的备份
- 测试连接以验证您的凭据
您还可以：
- 显示当前配置：
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）。 |
______________________________________________________________________
要使用Claude Desktop应用程序手动配置Koppla，请将以下配置添加到Claude_Desktop_config.json的“mcpServers”部分：
{
"mcpServers": {
"Koppla-Active-Directory": {
"command": "python",
"args": ["-m", "koppla.server"],
"env": {
"AD_SERVER": "ldap://:389",
"AD_USER": "",
"AD_PASSWORD": "
",
"BASE_DN": "DC=lazyadmin,DC=nl",
"AD_WRITE_ENABLED": "false"
}
}
}
}⚠️ 数据处理和隐私声明
重要提示：Koppla将Active Directory数据传输到外部AI模型进行处理。这可能会对安全和合规性产生影响，特别是对于受GDPR或类似法规约束的组织。Koppla本身不会存储任何广告数据，但请注意，AI代理可能会根据自己的策略保留对话历史。确保使用符合您组织的数据处理要求，并考虑通过仔细配置来限制可查询数据的范围。
🔒 安全功能
密码加密
- Koppla使用Fernet对称加密（来自加密软件包）来保护您的Active Directory密码
- 加密密钥与配置分开存储在具有受限权限的密钥文件中
- 使用配置管理器时，密码从不以纯文本形式存储
- 加密密码显示为
ENCRYPTED:xxxx...在配置文件中
备份系统
- 在任何配置更改之前，Koppla会自动为您的Claude Desktop配置创建带时间戳的备份
- 备份与配置一起存储，格式为：
claude_desktop_config.json.backup_YYYYMMDD_HHMMSS
写保护
- 默认情况下，禁用所有写入操作（从组中添加/删除用户、更新用户属性）
- 要启用写入操作，请设置
AD_WRITE_ENABLED为了“真实” - 无论写入设置如何，关键帐户和组都有额外的保护
支持的写入操作
Koppla支持以下写入操作： AD_WRITE_ENABLED 设置为“true”：
- 更新用户属性
- 修改标准用户属性，如描述、标题、部门等。 - 受保护的字段（密码、安全标识符、帐户控制）不能修改 - 无法修改受保护的帐户（管理员、服务帐户等）
- 将用户添加到组
- 将标准用户添加到安全组或通讯组 - 无法将用户添加到受保护的管理组 - 受保护的帐户不能添加到任何组
- 从组中删除用户
- 从大多数安全组或通讯组中删除用户 - 无法从关键系统组中删除用户 - 无法从任何组中删除受保护的帐户
所有写入操作在执行前都需要明确确认。
