Install UniFi Gateway for Claude Desktop
Claude Desktop reads mcpServers from claude_desktop_config.json. Restart the app after saving.
- Open ~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows, or ~/.config/Claude/claude_desktop_config.json on Linux.
- Paste the JSON config below.
- Replace placeholder secrets, then restart the client if it does not reload on its own.
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"pete-builds-mcp-unifi": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/pete-builds/mcp-unifi:0.25.0"
],
"env": {
"STUB_MODE": "true",
"UNIFI_HOST": "",
"UNIFI_API_KEY": "YOUR_UNIFI_API_KEY",
"UNIFI_SITE": "default",
"UNIFI_VERIFY_SSL": "false",
"MCP_UNIFI_CONTROLLERS_FILE": "",
"MCP_UNIFI_MODULES_ENABLED": "network",
"UNIFI_ACCESS_HOST": "",
"UNIFI_ACCESS_API_KEY": "YOUR_UNIFI_ACCESS_API_KEY",
"UNIFI_ACCESS_PORT": "12445",
"MCP_UNIFI_AUDIT_SINK": "file",
"MCP_UNIFI_AUDIT_PATH": "audit.jsonl"
}
}
}
}