Redis MCP Server

Connection refused or Redis server not accessible

Verify Redis running with redis-cli ping (should return PONG). Check URL format: redis://localhost:6379/0 or redis://user:password@host:port/db. Confirm network allows port 6379. Test with redis-cli -u URL command.

NOAUTH Authentication required error

Add password to connection URL: redis://:password@host:6379. Use AUTH command or configure ACL username. Verify requirepass in redis.conf matches. Check ACL user exists with ACL LIST command.

NOPERM user has no permissions to run command or access key

Grant permissions with ACL SETUSER username +@all ~*. Check ACL rules with ACL GETUSER username. Ensure user has +@read +@write categories. Verify key patterns allow access with ~key:* syntax.

ACL authentication failed or WRONGPASS invalid password

Verify password matches ACL user with ACL GETUSER. Check ACL file loaded correctly (restart Redis after editing). Ensure user not flagged nopass without valid passwords. View security events with ACL LOG.

TLS/SSL connection error or certificate validation failed

Use rediss:// (note double 's') for TLS connections. Add tls=true parameter to URL. Verify Redis built with TLS support (redis-server --version). Check certificates match CA and have correct permissions.