Firefox DevTools MCP

Servidor do Model Context Protocol que permite que agentes de IA usem o Firefox. Ele tem dois casos de uso principais:

• Navegação agêntica: o agente usa o navegador para tarefas comuns, como ler páginas, preencher formulários e percorrer fluxos de várias etapas em sites.
• Desenvolvimento web assistido por agente: o agente carrega a página em que você está trabalhando e a inspeciona com ferramentas de desenvolvedor, como o console, requisições de rede, o depurador e o profiler.

Ele controla o Firefox por meio do WebDriver BiDi (via Selenium WebDriver) e funciona com Claude Code, Claude Desktop, Cursor, Cline e outros clientes MCP.

Repositório: https://github.com/mozilla/firefox-devtools-mcp

Nota: Este servidor MCP requer uma instalação local do navegador Firefox e não pode ser executado em serviços de hospedagem em nuvem como o glama.ai. Use npx @mozilla/firefox-devtools-mcp@latest para executar localmente, ou use Docker com o Dockerfile fornecido.

Segurança

Servidores MCP de navegador trazem riscos inerentes. Algumas práticas essenciais:

• Use um perfil dedicado do Firefox. Nunca execute o servidor com seu perfil habitual — o agente tem acesso a tudo o que o navegador alcança, incluindo cookies e sessões salvas.
• Tenha cuidado com os sites que visita. As páginas podem retornar conteúdo projetado para manipular o agente (injeção de prompt). Fique em sites que você controla ou em que confia.
• Habilite apenas os módulos de ferramentas de que precisa. O preset padrão basic já inclui evaluate_script; --tool-preset slim o remove. Presets mais elevados, como --tool-preset developer (depuração, rede, console, profiler) e --tool-preset mozilla (contexto privilegiado), ampliam ainda mais o que o agente pode fazer.

Consulte SECURITY.md para uma análise completa dos riscos e como relatar vulnerabilidades.

Requisitos

• Node.js ≥ 20.19.0
• Firefox 100+ instalado (detectado automaticamente, ou passe --firefox-path)

Instalação e uso com Claude Code ou Codex (npx)

Recomendado: use npx para executar a versão publicada mais recente do npm.

Opção A — CLI

Claude Code

claude mcp add firefox-devtools npx @mozilla/firefox-devtools-mcp@latest

# Headless + viewport via args
claude mcp add firefox-devtools npx @mozilla/firefox-devtools-mcp@latest -- --headless --viewport 1280x720

# Or via environment variables
claude mcp add firefox-devtools npx @mozilla/firefox-devtools-mcp@latest \
  --env START_URL=https://example.com \
  --env FIREFOX_HEADLESS=true

Codex

codex mcp add firefox-devtools -- npx @mozilla/firefox-devtools-mcp@latest

# Headless + viewport via args
codex mcp add firefox-devtools -- \
  npx @mozilla/firefox-devtools-mcp@latest -- --headless --viewport 1280x720

# Or via environment variables
codex mcp add firefox-devtools \
  --env START_URL=https://example.com \
  --env FIREFOX_HEADLESS=true \
  -- npx @mozilla/firefox-devtools-mcp@latest

Opção B — Editar o arquivo de configuração

Claude Code

Adicione ao mcp_settings.json do Claude Code:

{
  "mcpServers": {
    "firefox-devtools": {
      "command": "npx",
      "args": ["-y", "@mozilla/firefox-devtools-mcp@latest", "--headless", "--viewport", "1280x720"],
      "env": {
        "START_URL": "about:blank"
      }
    }
  }
}

Codex

Adicione a ~/.codex/config.toml:

[mcp_servers.firefox-devtools]
command = "npx"
args = ["-y", "@mozilla/firefox-devtools-mcp@latest", "--headless", "--viewport", "1280x720"]

[mcp_servers.firefox-devtools.env]
START_URL = "about:blank"

Opção C — Script auxiliar (build de desenvolvimento local)

npm run setup
# Choose Claude Code; the script saves JSON to the right path

Experimente com o MCP Inspector

npx @modelcontextprotocol/inspector npx @mozilla/firefox-devtools-mcp@latest --start-url https://example.com --headless

Em seguida, chame ferramentas como:

• list_pages, select_page, navigate_page
• take_snapshot e depois click_by_uid / fill_by_uid
• list_network_requests (captura sempre ativa), get_network_request
• list_downloads (captura sempre ativa), set_download_behavior
• screenshot_page, list_console_messages

Opções de CLI

Você pode passar flags ou variáveis de ambiente (nomes à direita):