Active Directory
A Model-Context-Protocol (MCP) Server for Active Directory
What is Active Directory?
Active Directory is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model-context-protocol (mcp) server for active directory
A Model-Context-Protocol (MCP) Server for Active Directory
This server falls under the Cloud Services category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A Model-Context-Protocol (MCP) Server for Active Directory
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx kopplaConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Active Directory
Koppla is a Python MCP server that bridges AI assistants with Microsoft Active Directory via LDAP, enabling natural language queries and management of users, groups, and organizational units. It supports read operations like finding inactive users, listing group memberships, and locating locked accounts, as well as optional write operations such as modifying user attributes and managing group membership. IT administrators and sysadmins use it to query and manage their AD environment conversationally without writing LDAP queries by hand.
Prerequisites
- Python 3.8+ and pip installed on the machine running the server
- Network access to an Active Directory / LDAP server
- AD credentials with appropriate read (and optionally write) permissions
- An MCP-compatible client such as Claude Desktop
Install Koppla
Install the koppla package from PyPI using pip.
pip install kopplaGather your Active Directory connection details
You will need the AD server address, a bind username and password, and the base DN (distinguished name) for your directory. For example: AD_SERVER=ldap://dc01.corp.local, BASE_DN=DC=corp,DC=local.
Configure the MCP server with AD credentials
Add Koppla to your MCP client config, passing the AD connection details as environment variables. Write operations are disabled by default and must be explicitly enabled.
Restart Claude Desktop
Restart the client to load the Koppla server. Confirm the connection by asking Claude to list users or groups.
Test a read query
Run a safe read-only query to verify connectivity and permissions before attempting any write operations.
Active Directory Examples
Client configuration
Add this to your claude_desktop_config.json. Set AD_WRITE_ENABLED to true only if you want to allow group and attribute modifications.
{
"mcpServers": {
"koppla": {
"command": "python",
"args": ["-m", "koppla"],
"env": {
"AD_SERVER": "ldap://dc01.corp.local",
"AD_USER": "cn=svc-account,dc=corp,dc=local",
"AD_PASSWORD": "your-service-account-password",
"BASE_DN": "DC=corp,DC=local",
"AD_WRITE_ENABLED": "false"
}
}
}
}Prompts to try
Example natural language queries for managing your Active Directory environment.
- "Find all users who haven't logged in for 90 days"
- "List all members of the 'IT Admins' security group"
- "Are there any currently locked-out user accounts?"
- "Show me all users in the Sales department"
- "Find users who are in the VPN group but not in the Employees group"Troubleshooting Active Directory
Connection refused or timeout when connecting to AD
Verify that AD_SERVER uses the correct protocol prefix (ldap:// or ldaps://) and that the server address is reachable from the machine running Koppla. Check firewall rules for port 389 (LDAP) or 636 (LDAPS).
Authentication failure with valid credentials
Ensure AD_USER is the full distinguished name (e.g. CN=serviceaccount,OU=ServiceAccounts,DC=corp,DC=local) or the UPN format ([email protected]). Some AD configurations require one format over the other.
Write operations fail even with AD_WRITE_ENABLED=true
The service account must have write permissions on the specific OU or object in Active Directory. Use the AD delegation wizard in ADUC to grant the minimum required permissions to the bind account.
Frequently Asked Questions about Active Directory
What is Active Directory?
Active Directory is a Model Context Protocol (MCP) server that model-context-protocol (mcp) server for active directory It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Active Directory?
Follow the installation instructions on the Active Directory GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Active Directory?
Active Directory works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Active Directory free to use?
Yes, Active Directory is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Active Directory Alternatives — Similar Cloud Services Servers
Looking for alternatives to Active Directory? Here are other popular cloud services servers you can use with Claude, Cursor, and VS Code.
Open WebUI
★ 138.2kUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)
Anything LLM
★ 60.4kThe all-in-one AI productivity accelerator. On device and privacy first with no annoying setup or configuration.
LocalAI
★ 46.4kLocalAI is the open-source AI engine. Run any model - LLMs, vision, voice, image, video - on any hardware. No GPU required.
Nacos
★ 33.0kan easy-to-use dynamic service discovery, configuration and service management platform for building AI cloud native applications.
Xiaozhi ESP32
★ 26.7k本项目为xiaozhi-esp32提供后端服务，帮助您快速搭建ESP32设备控制服务器。Backend service for xiaozhi-esp32, helps you quickly build an ESP32 device control server.
Gateway
★ 11.8kA blazing fast AI Gateway with integrated guardrails. Route to 1,600+ LLMs, 50+ AI Guardrails with 1 fast & friendly API.
Browse More Cloud Services MCP Servers
Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Active Directory in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Active Directory?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.