Setting Up MCP Servers in Claude Code: A Practical Guide

After considerable experimentation, I successfully configured working MCP servers in Claude Code. Here's what I learned so you can skip the frustration.

What Are MCP Servers?

Think of them as extensions that give Claude the ability to interact with your computer beyond just generating code. They enable Claude to access files, control browsers, search the web, and more.

Available Tools

No API Key Required

• Sequential Thinking: Enables Claude to work through problems methodically
• Filesystem: Grants Claude access to specified folders on your machine
• Playwright: Modern automation supporting multiple browsers
• Puppeteer: Chrome-only automation (older, but functional)
• Web Fetching: Retrieves content from websites
• Browser Tools (Chrome DevTools Integration): Captures and analyzes browser data via a Chrome extension

API Key Required

• Brave Search: Provides web search functionality
• Firecrawl: Offers advanced web scraping capabilities

Quick Installation (All-in-One Script)

Copy this entire block, paste it into a macOS/Linux terminal, and press Enter:

bash <<'EOF'
echo "Installing Claude MCP servers (latest versions)..."

# Sequential Thinking - Claude's chain-of-thought engine
claude mcp add sequential-thinking -s user \
  -- npx -y @modelcontextprotocol/server-sequential-thinking || true

# Filesystem - give Claude access to local folders
claude mcp add filesystem -s user \
  -- npx -y @modelcontextprotocol/server-filesystem \
     ~/Documents ~/Desktop ~/Downloads ~/Projects || true

# Playwright - modern multi-browser automation
claude mcp add playwright -s user \
  -- npx -y @playwright/mcp-server || true

# Puppeteer - Chrome-only (deprecated but still works)
claude mcp add puppeteer -s user \
  -- npx -y @modelcontextprotocol/server-puppeteer || true

# Fetch - simple HTTP GET/POST
claude mcp add fetch -s user \
  -- npx -y @kazuph/mcp-fetch || true

# Browser-Tools - DevTools logs, screenshots, etc.
claude mcp add browser-tools -s user \
  -- npx -y @agentdeskai/browser-tools-mcp || true

echo "--------------------------------------------------"
echo "MCP registration finished."
echo ""
echo "To enable Browser-Tools, run this in a *second* terminal and leave it open:"
echo "    npx -y @agentdeskai/browser-tools-server"
echo "--------------------------------------------------"
claude mcp list
EOF

You can save this as install-mcp-servers.sh, make it executable with chmod +x install-mcp-servers.sh, and run it whenever needed.

Windows users: You'll need to create a .bat file instead—adjust accordingly.

Individual Server Installation

Sequential Thinking

claude mcp add sequential-thinking -s user \
  -- npx -y @modelcontextprotocol/server-sequential-thinking

Helps Claude reason through problems systematically rather than jumping to conclusions.

Filesystem Access

claude mcp add filesystem -s user \
  -- npx -y @modelcontextprotocol/server-filesystem \
     ~/Documents ~/Desktop ~/Downloads ~/Projects

Grants Claude access to your files. Modify the paths to match your needs.

Playwright (Multi-Browser Automation)

claude mcp add playwright -s user \
  -- npx -y @playwright/mcp

Puppeteer (Chrome-Only, Older Alternative)

claude mcp add puppeteer -s user \
  -- npx -y @modelcontextprotocol/server-puppeteer

Enables automated browser control—useful for testing and web interactions.

Web Fetching

claude mcp add fetch -s user \
  -- npx -y @kazuph/mcp-fetch

Retrieves content from websites.

Browser Tools

Provides Claude access to your browser's console logs, network traffic, and the ability to run performance and accessibility audits.

Step 1: Install the Chrome extension—download from the releases page and load it through Chrome's extension manager.

Step 2: Start the middleware server (keep this terminal open):

npx -y @agentdeskai/browser-tools-server@1.2.1

Step 3: Add the MCP server to Claude Code (in a separate terminal):

claude mcp add browser-tools -s user \
  -- npx -y @agentdeskai/browser-tools-mcp@1.2.1

Step 4: Open Chrome DevTools (F12) and locate the BrowserTools tab.

Brave Search (Requires API Key)

# Replace YOUR_API_KEY_HERE with your actual Brave Search API key
claude mcp add brave-search -s user \
  -- env BRAVE_API_KEY=YOUR_API_KEY_HERE \
     npx -y @modelcontextprotocol/server-brave-search

Enables Claude to search the web and return results.

Firecrawl (Advanced Web Scraping — Requires API Key)

# Replace fc-YOUR_API_KEY with your actual Firecrawl API key
claude mcp add firecrawl -s user \
  -- env FIRECRAWL_API_KEY=fc-YOUR_API_KEY \
     npx -y firecrawl-mcp

For robust web scraping needs.

Understanding the -s user vs -s local Flag

• -s user: Makes the tool available globally across all your projects
• -s local: Restricts the tool to your current directory only

Troubleshooting

• Windows issues: Add cmd /c before npx commands
• Timeout errors: Run MCP_TIMEOUT=10000 claude
• Connection problems: Type /mcp in Claude Code to check which servers are inactive
• Filesystem access: Verify your paths are correct

This should save you significant time getting everything configured properly.