Solid Multi-Tenant DevOps MCP Server

AI-first DevOps tooling for managing your Solid SaaS platform with thousands of tenant instances.

Overview

This MCP server provides comprehensive monitoring and management capabilities for your multi-tenant Solid platform through Claude Desktop. Monitor thousands of company instances, track AI agent performance, handle errors, and provision new tenants - all through natural language conversation with Claude.

Features

🏢 Tenant Management (Thousands of Customers)

• List all tenant companies with pagination

• Get detailed tenant information

• Search tenants by name, email, or ID

• Platform-wide analytics across all tenants

• Bulk health checks for multiple tenants

🤖 AI Agent Monitoring (Per Tenant)

• Monitor all 12 AI agents (ADA, Sarah, Jake, Sophia, Marcus, Alex, Jordan, Maya, Riley, Casey, Annie, Devon)

• Track inter-agent communication

• View agent status and performance metrics

• Monitor token usage and costs per tenant

💰 Token Billing & Analytics

• Track AI token usage per tenant

• Monitor costs with 2.5x markup

• View budget status and alerts

• Cost savings analysis (AI vs Human employees)

🔍 Error Monitoring

• List recent errors across all tenants

• Filter by tenant, severity, or time range

• Get detailed error information with stack traces

• Mark errors as resolved with notes

⚡ Performance Monitoring

• System-wide performance metrics

• Identify slow API endpoints

• Database query analysis

• Real-time health checks

🐳 Docker Management

• Monitor PostgreSQL, Redis, and Backend containers

• Check container health status

• View container logs

🚀 Tenant Provisioning

• Provision new tenant companies

• Configure subscription plans (starter, professional, enterprise)

• Enable demo mode with sample data

• Automated setup workflow

Installation

1. Install Dependencies

2. Configure Environment

The .env file is already created with your local endpoints:

3. Configure Claude Desktop

Add this to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

4. Restart Claude Desktop

Quit Claude Desktop completely and reopen it.

Available Tools

Tenant Management

• list_all_tenants - List all tenant companies (with pagination)

• get_tenant_details - Get detailed info about a specific tenant

• get_platform_analytics - Platform-wide analytics

• search_tenants - Search by name, email, or ID

• bulk_check_tenant_health - Health check multiple tenants at once

System Health

• check_all_services_health - Check Backend, Agents, Docker services

• check_docker_containers - Check PostgreSQL, Redis, Backend containers

Tenant-Specific Monitoring

• get_tenant_agents - All AI agents for a tenant

• get_tenant_agent_messages - Inter-agent communication

• get_tenant_products - Products/inventory for a tenant

• get_tenant_token_usage - AI token usage and billing

Error Monitoring

• list_recent_errors - Recent errors (all tenants or specific)

• get_error_details - Detailed error information

• resolve_error - Mark error as resolved

Performance Monitoring

• get_performance_summary - Overall system performance

• get_slow_endpoints - Find slow API endpoints

Tenant Provisioning

• provision_new_tenant - Create new tenant company

Database Operations

• execute_raw_query - Execute raw SQL (READ-ONLY for safety)

Usage Examples

Example 1: List All Tenants

Example 2: Check Tenant Health

Example 3: Monitor AI Agents

Example 4: View Recent Errors

Example 5: Provision New Tenant

Example 6: Monitor Performance

Architecture

Multi-Tenant Design

• Each tenant is a Company with a unique company_id

• All data is scoped per company/tenant

• Agents, products, users, orders all belong to a company

• Platform admins can monitor all tenants from http://localhost:8080/admin

Service Endpoints

• Backend: http://localhost:8090 - Main API server

• Super Admin: http://localhost:8080 - Platform management dashboard

• Agents: http://localhost:8091 - AI agent execution server

• Frontend: http://localhost:3000 - Customer-facing UI

• CMS: http://localhost:3001 - Public CMS

Database

• PostgreSQL: Company data, agents, products, orders

• Redis: Caching, event bus, performance monitoring

Workflow Examples

Morning Health Check

Tenant Onboarding

Performance Investigation

Scaling Monitoring

Troubleshooting

MCP Server Not Appearing in Claude Desktop

1. Check config file location: ~/Library/Application Support/Claude/claude_desktop_config.json

2. Verify path to index.js is absolute (not relative)

3. Restart Claude Desktop completely

4. Check logs in Claude Desktop Developer Tools

Connection Errors

1. Ensure all Solid services are running: ./start-all.sh

2. Check services are accessible:

   curl http://localhost:8090/ curl http://localhost:8091/health

3. Verify Docker containers are running:

   docker ps

Tool Execution Errors

• Check the specific endpoint exists in your backend

• Some tools may return "Not Found" if the endpoint isn't implemented yet

• Backend logs: tail -f logs/backend.log

Development

Add New Tools

Edit src/index.js and:

1. Add tool definition to ListToolsRequestSchema handler

2. Add tool implementation to CallToolRequestSchema handler

3. Test with Claude Desktop

Update Endpoints

Edit .env file to point to different service URLs (staging, production, etc.)

System Requirements

• Node.js 18+

• Running Solid services (Backend, Agents, Docker)

• Claude Desktop

Support

For issues or questions:

• Check backend logs: tail -f logs/backend.log

• Check agent logs: tail -f logs/agents.log

• View Docker logs: docker-compose logs -f

Status: ✅ Ready for AI-first DevOps monitoring of thousands of tenant instances

Version: 1.0.0