Integrate your Blue Matador infrastructure monitoring directly into Claude Desktop, enabling natural language access to your alerts, metrics, integrations, and team management.
Prerequisites
Claude Desktop application (macOS, Windows, or Linux)
Active Blue Matador account with API key access
Node.js and npm installed
Compatibility
Supported:
Claude Desktop (all platforms)
Claude Dev for VS Code
Not Supported:
Claude Web (claude.ai)
ChatGPT or other AI assistants
Installation
Install the integration globally via npm:
npm install -g bluematador-mcp-server
Configuration
Step 1: Obtain API Credentials
Log into your Blue Matador account
Navigate to Settings → API Keys
Create a new API key or use an existing one
Copy your API Key and Account ID (UUID format:
12345678-1234-1234-1234-123456789abc)
Step 2: Locate Claude Desktop Config
Open your Claude Desktop configuration file (if the file does not exist, create it) at:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%/Claude/claude_desktop_config.jsonLinux:
~/.config/claude/claude_desktop_config.json
Step 3: Add Configuration
Credentials are saved in the config file and used automatically:
{
"mcpServers": {
"bluematador": {
"command": "bluematador-mcp-server",
"env": {
"BLUEMATADOR_API_KEY": "your-api-key-here",
"BLUEMATADOR_ACCOUNT_ID": "your-account-id-here"
}
}
}
}
Step 4: Restart Claude Desktop
Fully quit and restart Claude Desktop to activate the integration.
Features
Alert Management
Monitor and control your infrastructure alerts:
View active alerts and real-time events
Query historical monitoring data and trends
Create mute rules for specific alerts or resources
Use wildcard patterns (e.g., prod-*, *-staging) to mute multiple resources
Configure alert severity levels and visibility
Example queries:
"What active alerts do I have right now?"
"Show me events from the last 24 hours"
"Mute all SQS monitors for the next hour"
"Mute resources matching pattern 'test-*'"
Mute Rules
Create and manage rules to suppress alerts temporarily or permanently:
View all active and scheduled mute rules
Create mute rules for specific resources or services
Use wildcard patterns (e.g.,
prod-*,*-staging) to mute multiple resourcesMute by service type (SQS, RDS, EC2, Lambda, etc.)
Set time-based muting with duration or schedules
Delete or modify existing mute rules
Example queries:
"Can you list me all of my currently active Mute Rules?"
"Show me what mute rules are scheduled for next week"
"Mute all SQS monitors for the next hour"
"Create a mute rule for production EC2 instances"
"Mute all resources matching pattern 'test-*'"
"Mute resources ending with '-staging' for 24 hours"
"Show me what monitors are available for muting"
"Delete the mute rule for my test servers"
"Which resources are currently muted?"
Cloud Integration Management
Manage your AWS and Azure monitoring connections:
Create and configure new cloud integrations
View integration status and health
Enable, disable, or update existing integrations
Troubleshoot connection issues
Example queries:
"List all my AWS integrations and their status"
"Create a new AWS integration for my production account"
"Disable the integration for my staging environment"
Notification Configuration
Set up and manage alert delivery channels:
Configure email notifications with custom addresses
Integrate with PagerDuty, OpsGenie, VictorOps, SquadCast
Set up AWS SNS and ServiceNow notifications
Control notification severity thresholds
Example queries:
"Create an email notification for critical alerts to ops@company.com"
"Set up a PagerDuty integration for our production service"
"Show me all my current notification settings"
Metrics and Monitoring
Access infrastructure performance data:
Query CPU, memory, and resource utilization
View time-series metrics and trends
Get infrastructure health summaries
Analyze historical performance data
Example queries:
"Get CPU utilization metrics for the last week"
"Show me a summary of events for the past month"
"What's the current health status of my infrastructure?"
Team and Project Management
Manage user access and organization:
View team members and their permissions
Invite new users with role assignments
Organize monitoring by projects
Track user activity and access logs
Example queries:
"Who are the users in my account?"
"Invite john@company.com as an admin user"
"What projects do we have set up?"
Troubleshooting
Integration Not Working
Symptoms: Claude doesn't recognize Blue Matador commands
Solutions:
Completely restart Claude Desktop (quit and reopen, don't just close the window)
Verify the config file is valid JSON with no syntax errors
Check that bluematador-mcp-server is installed globally: npm list -g bluematador-mcp-server
Authentication Failed
Symptoms: "Authentication error" or credential-related messages
Solutions:
Verify your API key is correct and active in Blue Matador
Ensure Account ID is in proper UUID format:
12345678-1234-1234-1234-123456789abcTest credentials by logging into the Blue Matador web interface
Check for extra spaces or characters when copying credentials
No Response from Claude
Symptoms: Claude doesn't respond to Blue Matador queries
Solutions:
Confirm Claude Desktop was restarted after configuration changes
Check that the integration appears in Claude's available tools
Try a simple test query: "List my Blue Matador integrations"
Review Claude Desktop logs for error messages
Common Configuration Errors
Invalid JSON: Ensure proper comma placement and quote matching in config file
Wrong file location: Verify you're editing the correct claude_desktop_config.json for your OS
Permissions issues: Ensure the config file is readable by Claude Desktop
Security Considerations
API credentials connect only to your Blue Matador account
No data is transmitted to third parties
Support Resources
Blue Matador Support: support.bluematador.com
Claude Desktop Documentation: https://docs.anthropic.com/claude/docs
MCP Protocol: https://modelcontextprotocol.io
Version Information
Package: bluematador-mcp-server
Registry: npm