Koppla
by ruudmens
Koppla is a model-context-protocol server for Active Directory that enables you to manage users, groups, and computer objects using natural language. It allows seamless querying and management of your Active Directory environment using Claude Desktop or other MCP capable AI agents.
Last updated: N/A
What is Koppla?
Koppla is a model-context-protocol server designed to simplify Active Directory management through natural language interaction. It acts as a bridge between AI models like Claude and your Active Directory environment, allowing you to query and update AD objects using conversational commands.
How to use Koppla?
To use Koppla, you need Python 3.7+, an Active Directory environment, and optionally Claude Desktop. Install Koppla using pip install koppla. Configure it using the interactive configuration manager (koppla-config configure) or manually via environment variables. Integrate Koppla with Claude Desktop by adding the server configuration to your claude_desktop_config.json file. Once configured, you can use natural language commands within Claude to interact with your Active Directory.
Key features of Koppla
Natural language Active Directory management
Secure password encryption using Fernet
Automatic configuration backups
Write protection to prevent accidental modifications
Integration with Claude Desktop and other MCP agents
Use cases of Koppla
Finding inactive users
Adding users to groups
Listing locked-out accounts
Identifying users in specific departments
Determining group memberships
Identifying empty groups
Complex group membership analysis
FAQ from Koppla
What are the prerequisites for using Koppla?
What are the prerequisites for using Koppla?
You need Python 3.7 or higher, an Active Directory environment, and optionally Claude Desktop for integration.
How do I install Koppla?
How do I install Koppla?
Install Koppla using pip: pip install koppla
How do I configure Koppla?
How do I configure Koppla?
You can use the interactive configuration manager (koppla-config configure) or manually configure it via environment variables.
How does Koppla handle security?
How does Koppla handle security?
Koppla encrypts passwords using Fernet, creates configuration backups, and provides write protection to prevent unintended modifications.
What write operations are supported?
What write operations are supported?
When AD_WRITE_ENABLED is set to "true", Koppla supports updating user attributes, adding users to groups, and removing users from groups, with restrictions on protected accounts and groups.