Browser MCP + GitHub Copilot (VS Code): 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 GitHub Copilot (VS Code), you can:
- Access Browser MCP functionality through GitHub Copilot (VS Code)
This guide provides step-by-step instructions to set up Browser MCP in GitHub Copilot (VS Code), 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 GitHub Copilot (VS Code)
- All Browser MCP capabilities will be available for your workflows
Prerequisites
Before starting, ensure you have:
- GitHub Copilot (VS Code) installed and configured
- Compatible operating system (Windows, macOS, Linux)
Installation
Step 1: Install Browser MCP
Configuration
Step 2: Configure GitHub Copilot (VS Code)
-
Locate your configuration file:
- Windows:
.vscode\\mcp.json in your project directory - macOS:
.vscode/mcp.json in your project directory - Linux:
.vscode/mcp.json in your project directory
- Windows:
-
Add server configuration:
{
"mcpServers": {
"browser-mcp": {
"command": "browser mcp",
"args": [],
"env": {
}
}
}
}
- Restart GitHub Copilot (VS Code)
Completely quit and restart GitHub Copilot (VS Code) to load the new configuration.
Examples
Once configured, you can use Browser MCP in GitHub Copilot (VS Code):
Testing Your Setup
- Start a new conversation in GitHub Copilot (VS Code)
- Ask GitHub Copilot (VS Code) to list available tools
- Try using Browser MCP functionality
Test prompts:
- "What MCP tools are available?"
- "Use Browser MCP to help with my code"
- "Show me what Browser MCP can do"
Troubleshooting
Common Issues
MCP Configuration Not Loaded
Symptoms: MCP tools not appearing, Copilot does not recognize MCP server
Cause: Configuration file not in correct location or invalid JSON
Solution:
- Verify .vscode/mcp.json exists in project root directory
- Check JSON syntax is valid (no trailing commas, proper quotes)
- Reload VS Code window after making configuration changes
- Check VS Code Developer Tools (Help > Toggle Developer Tools) for errors
MCP Server Not Starting
Symptoms: Tools listed but not responding, Server connection errors
Cause: Server command path incorrect or dependencies missing
Solution:
- Test the MCP server command independently in terminal
- Verify all server prerequisites are installed
- Check that command path is correct (use absolute paths if needed)
- Ensure required environment variables are set in mcp.json
- Review VS Code Output panel for MCP server error messages
GitHub Copilot Subscription Required
Symptoms: Copilot features grayed out, Unable to access Copilot Chat
Cause: No active GitHub Copilot subscription
Solution:
- Sign up for GitHub Copilot subscription (Individual, Business, or Enterprise)
- Verify subscription is active in GitHub account settings
- Re-authenticate GitHub Copilot in VS Code
- Check that VS Code is using correct GitHub account
VS Code Version Too Old
Symptoms: MCP configuration ignored, No mcp.json recognition
Cause: VS Code version below 1.99 does not have native MCP support
Solution:
- Update VS Code to version 1.99 or later
- Check current version: Help > About
- Download latest version from code.visualstudio.com
- After updating, reload window and verify MCP support
{server_name} Tools Not Working
Symptoms: Server connected but tools fail, Error messages when invoking tools
Cause: Server-specific configuration or authentication issues
Solution:
- Verify all required environment variables for {server_name} are set
- Check {server_name} documentation for specific prerequisites
- Test {server_name} with another MCP client to isolate issue
- Review error messages in VS Code Output panel for specific failures
Browser MCP not appearing in GitHub Copilot (VS Code)
Symptoms: Server not listed, Tools not available
Cause: Configuration or installation issue
Solution:
- Verify configuration syntax
- Check Browser MCP installation
- Restart GitHub Copilot (VS Code)
- Check logs for error messages
Next Steps
Now that Browser MCP is integrated with GitHub Copilot (VS Code):
- Explore all Browser MCP capabilities through GitHub Copilot (VS Code)
- Check out other MCP servers that work with GitHub Copilot (VS Code)
- Join the MCP community for tips and support
- Consider contributing to Browser MCP development
Need Help?
- Search for Browser MCP documentation
- Check the GitHub Copilot (VS Code) MCP guide
- Join the MCP community discussions