Skip to content

Latest commit

 

History

History
92 lines (66 loc) · 2.33 KB

claude-desktop.md

File metadata and controls

92 lines (66 loc) · 2.33 KB

Firewalla MCP × Claude Desktop

Connect your Firewalla firewall data directly to Claude Desktop for real-time security analysis and network monitoring.

Prerequisites

  • Claude Desktop app installed
  • Node.js 18+ for running the MCP server
  • Active Firewalla MSP account with API access

Quick Setup

1. Install the MCP Server

# Install globally (recommended)
npm install -g firewalla-mcp-server

# Or install locally
npm install firewalla-mcp-server

2. Configure Claude Desktop

Open Claude Desktop settings and click Developer → Edit Config to modify claude_desktop_config.json:

{
  "mcpServers": {
    "firewalla": {
      "command": "npx",
      "args": ["firewalla-mcp-server"],
      "env": {
        "FIREWALLA_MSP_TOKEN": "your_msp_access_token_here",
        "FIREWALLA_MSP_ID": "yourdomain.firewalla.net",
        "FIREWALLA_BOX_ID": "your_box_gid_here"
      }
    }
  }
}

3. Get Your Credentials

  1. MSP Token: Log into your Firewalla MSP portal → API Settings → Generate Token
  2. MSP ID: Your full domain (e.g., company.firewalla.net)
  3. Box ID: Device settings → Copy the Box GID (long UUID format)

4. Test the Connection

Restart Claude Desktop and try:

"Show me my Firewalla security alerts from the last hour"

Configuration Locations

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Troubleshooting

Authentication Errors

  • Verify MSP token hasn't expired
  • Check Box ID format (should be UUID, not device name)
  • Ensure network connectivity to your MSP domain

No Data Returned

  • Confirm your Firewalla is online and reporting
  • Try broader time ranges in queries
  • Check MSP portal for API rate limits

Example Queries

"What are my top 10 bandwidth users this week?"
"Show me all high-severity security alerts"
"Are there any offline devices I should know about?"
"What firewall rules are currently blocking traffic?"

Features

  • 28 tools for comprehensive network analysis
  • Advanced search syntax with logical operators and filters
  • Geographic threat analysis with country-level insights
  • Real-time monitoring with intelligent caching

Need another client? Return to main setup guide