Solid Multi-Tenant DevOps MCP Server

# Installation Instructions ## Quick Setup ### 1. Configure Claude Desktop Copy the configuration to your Claude Desktop config file: **macOS Location**: ```bash ~/Library/Application Support/Claude/claude_desktop_config.json ``` **Configuration**: ```json { "mcpServers": { "solid-devops": { "command": "node", "args": ["/Users/adamcampbell/Desktop/Solid/solid-mcp-server/src/index.js"], "env": {} } } } ``` ### 2. Easy Install Script Run this one-liner to install the config: ```bash mkdir -p ~/Library/Application\ Support/Claude && \ cp claude-desktop-config.json ~/Library/Application\ Support/Claude/claude_desktop_config.json && \ echo "✅ Config installed! Now restart Claude Desktop." ``` Or manually: ```bash # Open Claude Desktop config directory open ~/Library/Application\ Support/Claude/ # Copy the config file contents from solid-mcp-server/claude-desktop-config.json # Paste into claude_desktop_config.json ``` ### 3. Restart Claude Desktop **Important**: Completely quit and reopen Claude Desktop for changes to take effect. ```bash # Quit Claude Desktop # Then reopen it from Applications ``` ### 4. Verify Installation In Claude Desktop, start a new conversation and try: ``` Check if the Solid DevOps MCP server is connected ``` Claude should respond with available tools. ## Testing the MCP Server ### Test 1: List All Tenants ``` Show me all tenants in the system ``` ### Test 2: Check System Health ``` Check the health of all services ``` ### Test 3: View Platform Analytics ``` Show me platform-wide analytics ``` ### Test 4: Monitor Docker Containers ``` What's the status of the Docker containers? ``` ## Troubleshooting ### MCP Server Not Appearing 1. **Check config file exists**: ```bash cat ~/Library/Application\ Support/Claude/claude_desktop_config.json ``` 2. **Verify absolute path**: - Path must be absolute: `/Users/adamcampbell/Desktop/Solid/solid-mcp-server/src/index.js` - NOT relative: `./src/index.js` ❌ 3. **Check Node.js version**: ```bash node --version # Should be v18 or higher ``` 4. **Test MCP server manually**: ```bash cd solid-mcp-server node src/index.js # Press Ctrl+C to exit ``` ### Connection Errors 1. **Ensure Solid services are running**: ```bash cd /Users/adamcampbell/Desktop/Solid ./start-all.sh ``` 2. **Check services are responding**: ```bash curl http://localhost:8090/ curl http://localhost:8091/health ``` 3. **Verify Docker containers**: ```bash docker ps | grep solid ``` ### Claude Desktop Logs View Claude Desktop logs for debugging: ```bash # Open Claude Desktop # Go to Help > Developer Tools # Check Console tab for errors ``` ## Uninstall To remove the MCP server from Claude Desktop: ```bash # Edit the config file open ~/Library/Application\ Support/Claude/claude_desktop_config.json # Remove the "solid-devops" entry from mcpServers ``` Or completely reset: ```bash rm ~/Library/Application\ Support/Claude/claude_desktop_config.json ``` ## Next Steps Once installed, you can: - Monitor thousands of tenant instances - Check AI agent performance per tenant - View token usage and costs - Track errors across all tenants - Provision new tenants - Monitor system performance - Check Docker container health ## Support - **Backend logs**: `tail -f /Users/adamcampbell/Desktop/Solid/logs/backend.log` - **Agent logs**: `tail -f /Users/adamcampbell/Desktop/Solid/logs/agents.log` - **Docker logs**: `docker-compose logs -f` --- ✅ **You're ready to monitor your multi-tenant Solid platform through Claude Desktop!**