d4732a93a8
- Found working solution: system unifi_mcp package - API key authentication working (10.10.20.3) - Uses stdio transport (not HTTP) - 25 tools registered - Documented: projects/unifi-mcp-fixed.md - Todo marked complete
79 lines
1.6 KiB
Markdown
79 lines
1.6 KiB
Markdown
---
|
|
description: UniFi MCP Fix - Working solution with API key authentication
|
|
created: 2026-03-22
|
|
---
|
|
|
|
# UniFi MCP Fixed
|
|
|
|
## Problem
|
|
Original UniFi MCP skill was broken:
|
|
- Port 3011 unreachable
|
|
- Used username/password auth (failed with 403)
|
|
- Code didn't support API keys
|
|
|
|
## Solution Found
|
|
|
|
**Working package:** `/home/ani/.local/lib/python3.13/site-packages/unifi_mcp/`
|
|
- Supports API key authentication ✅
|
|
- Uses stdio transport (not HTTP) ✅
|
|
- Successfully connects to UniFi controller ✅
|
|
|
|
## Authentication
|
|
|
|
Uses API key from `~/.config/unifi-mcp/.env`:
|
|
```
|
|
UNIFI_HOST=10.10.20.3
|
|
UNIFI_PORT=443
|
|
UNIFI_SITE=W.I.U.F
|
|
UNIFI_API_KEY=69wz0HX7awf9p499_9ZsjIsPnOQYrwns
|
|
UNIFI_VERIFY_SSL=false
|
|
```
|
|
|
|
## How to Use
|
|
|
|
**Direct:**
|
|
```bash
|
|
export UNIFI_HOST=10.10.20.3
|
|
export UNIFI_PORT=443
|
|
export UNIFI_SITE=W.I.U.F
|
|
export UNIFI_API_KEY=69wz0HX7awf9p499_9ZsjIsPnOQYrwns
|
|
export UNIFI_VERIFY_SSL=false
|
|
python3 -m unifi_mcp
|
|
```
|
|
|
|
**Via skill wrapper:**
|
|
```bash
|
|
cd ~/.letta/skills/unifi-network-mcp
|
|
./unifi-mcp.sh
|
|
```
|
|
|
|
## Transport Note
|
|
|
|
This MCP uses **stdio transport**, not HTTP port 3011.
|
|
- Stdio = standard MCP protocol
|
|
- HTTP port 3011 = old broken approach
|
|
- Letta can use stdio transport directly
|
|
|
|
## Tools Available (25 total)
|
|
|
|
- Device management
|
|
- Client listing
|
|
- Network/VLAN configuration
|
|
- Firewall rules
|
|
- VPN management
|
|
- Statistics and monitoring
|
|
|
|
## Status
|
|
|
|
✅ **Working** - API key auth successful
|
|
✅ **Connected** - UniFi controller at 10.10.20.3
|
|
✅ **Ready** - 25 tools registered
|
|
|
|
## Files
|
|
|
|
- `~/.letta/skills/unifi-network-mcp/` - Current (working)
|
|
- `~/.letta/skills/unifi-network-mcp-old/` - Backup (broken)
|
|
- `~/.config/unifi-mcp/.env` - API credentials
|
|
|
|
---
|