MCP Made Simple

Discover how to use the MCP Marketplace to easily find, install, and set up MCP servers that expand Bwat's functionality with powerful new tools and resources.

Understanding MCP Servers

MCP servers are specialized extensions that supercharge Bwat's abilities. They enable features like:

• Web browsing
• Image processing
• API integrations
• Data analysis
• And much more

Navigating the MCP Marketplace

The MCP Marketplace offers one-click installation for hundreds of specialized servers across multiple categories.

1. Opening the Marketplace

1. Click the "Extensions" icon (square button) in Bwat's toolbar
2. Browse available servers organized by category

2. Finding Your Server

• Explore categories (Search, File Management, Browser Automation, Data Analysis, etc.)
• Select any server to view its capabilities and requirements

3. Installation & Setup

1. Click "Install" for your chosen server
2. For API-key protected servers, Bwat will guide you through:
   • Obtaining the API key
   • Securely storing it
3. The server automatically integrates with Bwat's settings

4. Confirming Installation

• Bwat confirms successful installation
• Verify server status in the MCP settings interface

5. Using Your New Tools

• Bwat seamlessly incorporates the server's capabilities
• New tools appear in Bwat's available functions
• Simply ask Bwat to use them (e.g., "Find recent React updates using Perplexity")

Enterprise Note: Corporate users should verify permissions before installing third-party MCP servers per organizational security policies.

Technical Overview

During installation, Bwat automatically handles:

1. Installation Process

• Server code installs to /Users/<username>/Documents/Bwat/MCP/
• Required dependencies are added
• Compilation/build process completes

2. Configuration

• Updates the MCP settings file: /Users/<username>/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/bwat_mcp_settings.json
• Securely stores environment variables
• Registers server paths

3. Activation

• Bwat detects the new configuration
• Launches server as a separate process
• Establishes communication via stdio/HTTP

4. Integration

• New capabilities appear in Bwat's toolset
• Tools become accessible through commands
• Bwat can now leverage these features when requested

Troubleshooting Guide

System Requirements

Ensure your system meets these specifications:

• Node.js 18+
  • Verify: node --version
  • Download: nodejs.org (opens in a new tab)
• Python 3.10+
  • Verify: python --version
  • Download: python.org (opens in a new tab)
• UV Package Manager
  • Install:

    curl -LsSf https://astral.sh/uv/install.sh | sh
    Or: pip install uv
  • Confirm: uv --version

Common Solutions

• Verify stable internet connection
• Check installation permissions
• Confirm correct API key entry
• Review server status for errors

Complete Removal

To fully uninstall a problematic server:

1. Open: /Users/<username>/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/bwat_mcp_settings.json
2. Delete the server's entry
3. Save changes
4. Restart Bwat

Advanced Debugging

For persistent errors:

• Inspect the MCP settings file
• Use Claude Sonnet for installations
• Verify file paths and environment variables
• Check port availability for HTTP servers
• Test server commands directly in terminal

Smart MCP Management

Organize your MCP servers with rules that automatically activate them based on conversation context.

Rule Configuration

{
  "mcpRules": {
    "webTools": {
      "servers": ["firecrawl-mcp", "web-fetcher"],
      "triggers": ["web", "scrape", "browse", "site"],
      "description": "Web browsing and data extraction"
    }
  }
}

Key Components

• Categories: Logical server groupings
• Servers: Included MCP servers
• Triggers: Activating keywords/phrases
• Description: Human-readable purpose

Benefits

• Context-Aware Selection: Bwat chooses tools based on conversation
• Streamlined Workflow: Automatic tool activation
• Logical Organization: Group related capabilities
• Priority Handling: Resolves ambiguous cases

Example Implementation

When you ask "Can you scrape this website?", Bwat detects keywords and automatically selects web-related MCP servers.

Starter Template

{
  "mcpRules": {
    "category1": {
      "servers": ["server1", "server2"],
      "triggers": ["keyword1", "keyword2"],
      "description": "Function description"
    },
    "category2": {
      "servers": ["server3"],
      "triggers": ["keyword3", "phrase1"],
      "description": "Function description"
    }
  },
  "defaultBehavior": {
    "priorityOrder": ["category1", "category2"],
    "fallbackBehavior": "Prompt user for tool selection"
  }
}

Add this to your .bwatrules file or custom instructions for smarter MCP server management.