beginner⏱️ 15-25 minutes📅 Updated June 2026

Step-by-step guide to integrate Browser MCP MCP server with Amazon Q CLI. Enhanced Amazon Q CLI functionality with Browser MCP integration.

Browser MCP + Amazon Q CLI: Complete MCP Integration

Browser MCP is a MCP server that Browser extension and MCP server that enables AI applications to automate web browser tasks locally. Connect AI apps to your browser to automate tests and tasks while maintaining privacy and avoiding bot detection..

When integrated with Amazon Q CLI, you can:

  • Access Browser MCP functionality through Amazon Q CLI

This guide provides step-by-step instructions to set up Browser MCP in Amazon Q CLI, including configuration, examples, and troubleshooting.

What You'll Achieve

After completing this setup:

  • Browser MCP will be fully integrated and operational
  • You can use Browser MCP tools directly in Amazon Q CLI
  • All Browser MCP capabilities will be available for your workflows

Prerequisites

Before starting, ensure you have:

  • Amazon Q CLI installed and configured
  • Compatible operating system (Windows, macOS, Linux)

Installation

Step 1: Install Browser MCP

Configuration

Step 2: Configure Amazon Q CLI

  1. Install Amazon Q CLI

Download and install Q CLI for your platform

Visit: https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-installing.html

  1. Authenticate

Set up authentication with AWS Builder ID or IAM Identity Center

q auth

Note: Follow interactive authentication flow

  1. Verify Installation

Test Q CLI installation and configuration

q doctor
  1. Install MCP Server

Install the MCP server you want to integrate

Note: Ensure server is accessible from command line

  1. Configure MCP Integration

Add MCP server configuration to Q CLI

Note: Use q config commands to set server parameters

  1. Test Integration

Verify MCP server works with Q CLI

q chat "Use Browser MCP to help me"

Configuration Details

Configure MCP servers through Q CLI commands:

# Configure MCP server integration
q config set mcp.servers.browser-mcp.command "browser mcp"
q config set mcp.servers.browser-mcp.args ""
q config set mcp.servers.browser-mcp.env ""

# Verify configuration
q config list mcp.servers

Examples

Once configured, you can use Browser MCP in Amazon Q CLI:

Testing Your Setup

  1. Run q doctor to verify system health
  2. Start Q CLI chat session
  3. Ask Q to list available MCP tools
  4. Test specific Browser MCP functionality

Test commands:

q doctor

q chat

q config list mcp.servers

Troubleshooting

Common Issues

Installation Failed

Symptoms: Q command not found, Installation errors

Cause: Incomplete installation or PATH issues

Solution:

  • Verify installer completed successfully
  • Check PATH environment variable includes Q CLI
  • Try running q doctor for diagnostics
  • Reinstall using platform-specific method

Authentication Problems

Symptoms: Auth errors, Cannot connect to AWS services

Cause: Invalid credentials or network issues

Solution:

  • Run q auth to re-authenticate
  • Verify AWS Builder ID or IAM credentials
  • Check network connectivity to AWS
  • Ensure proper AWS permissions are set

MCP Server Not Found

Symptoms: Server command not found, MCP tools unavailable

Cause: Server not installed or not in PATH

Solution:

  • Verify MCP server installation
  • Check server executable permissions
  • Use absolute path in configuration
  • Test server independently with direct command

Configuration Errors

Symptoms: Config commands fail, Settings not persisting

Cause: Invalid configuration syntax or permissions

Solution:

  • Check Q CLI configuration file permissions
  • Verify configuration syntax is correct
  • Use q config list to review current settings
  • Report issues with q issue command

Browser MCP not appearing in Amazon Q CLI

Symptoms: Server not listed, Tools not available

Cause: Configuration or installation issue

Solution:

  • Verify configuration syntax
  • Check Browser MCP installation
  • Restart Amazon Q CLI
  • Check logs for error messages

Next Steps

Now that Browser MCP is integrated with Amazon Q CLI:

  • Explore all Browser MCP capabilities through Amazon Q CLI
  • Check out other MCP servers that work with Amazon Q CLI
  • Join the MCP community for tips and support
  • Consider contributing to Browser MCP development

Need Help?

Related Resources

More Integrations

Explore other MCP servers that work with Amazon Q CLI

Need Help?

Join the MCP community for support and discussions

Browser MCP + Amazon Q CLI: MCP Setup Guide (2026)