Skip to main content
Glama
DOCKER_DESKTOP_UI_TROUBLESHOOTING.md3.52 kB
# Docker Desktop MCP Toolkit UI Visibility Issue ## Issue Your `vault-mcp` server is installed and working via CLI, but it's not appearing in the Docker Desktop MCP Toolkit UI. ## Root Cause Docker Desktop's MCP Toolkit UI **only displays servers from the official `docker-mcp` catalog**. Custom catalogs are functional via CLI but are not shown in the GUI. ### Verification Your server IS working: ```powershell ✓ Server is enabled: docker mcp server ls ✓ Catalog exists: docker mcp catalog ls ✓ Server in catalog: docker mcp catalog show vault-mcp ``` ## Solutions ### Option 1: Use CLI Commands (Current Status) Your server works perfectly via CLI: ```powershell # Enable/disable server docker mcp server enable vault-mcp docker mcp server disable vault-mcp # List enabled servers docker mcp server ls # Connect clients docker mcp client connect claude-desktop --global ``` ### Option 2: Check Docker Desktop Settings 1. **Restart Docker Desktop** - Sometimes the UI needs a refresh - Quit Docker Desktop completely - Restart it - Check the MCP Toolkit section again 2. **Verify MCP Toolkit is Enabled** - Settings → Beta features → Enable Docker MCP Toolkit - Click "Apply & Restart" 3. **Check MCP Toolkit Container** - Settings → Extensions → Show Docker Extensions system containers - Look for MCP Toolkit containers in the Containers tab ### Option 3: Add to Official Catalog (Advanced) If you want the server to appear in the UI, you would need to: 1. Submit it to the official Docker MCP catalog (requires publishing to a registry) 2. Or manually add it to the `docker-mcp` catalog (may be overwritten on updates) ### Option 4: Use with MCP Clients Directly You can use the server directly with MCP clients without needing the UI: #### Claude Desktop Configuration Edit: `%APPDATA%\Claude\claude_desktop_config.json` ```json { "mcpServers": { "vault": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "VAULT_ADDR=http://host.docker.internal:8200", "-e", "VAULT_TOKEN=myroot", "vault-mcp-vault-mcp:latest" ] } } } ``` ## Current Status Summary ✅ **Server is installed and working** ✅ **Server is enabled in MCP Toolkit** ✅ **Catalog is properly configured** ❌ **Server does not appear in Docker Desktop UI** (expected behavior for custom catalogs) ## Why This Happens Docker Desktop's MCP Toolkit UI is designed to show: - Official catalog servers with rich metadata (icons, descriptions, etc.) - Servers from the `docker-mcp` catalog that have been curated Custom catalogs are a CLI feature and don't automatically appear in the UI. This is by design to: - Keep the UI clean and focused on curated servers - Allow CLI power users to add custom servers - Maintain separation between official and custom servers ## Verification Commands Run these to confirm everything is working: ```powershell # Check server status docker mcp server ls # Check catalog docker mcp catalog show vault-mcp # Test server (if you have test scripts) .\test-mcp-simple.ps1 ``` ## Conclusion Your server is **fully functional** and ready to use. The lack of UI visibility is expected for custom catalogs and doesn't affect functionality. You can: 1. Continue using CLI commands to manage it 2. Connect MCP clients directly (Claude Desktop, etc.) 3. Use it programmatically via the MCP protocol The server will work exactly the same whether it appears in the UI or not!

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/kelleyblackmore/vault-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server