{
  "slug": "configure-filesystem-roots-for-chrome-devtools-mcp-d4032d37da16",
  "title": "Configure filesystem roots for Chrome DevTools MCP",
  "tools": [
    "chrome-devtools-mcp"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-09-08T09:49:22.000Z",
  "announced_at": "2026-09-08T09:49:22.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When starting Chrome DevTools MCP and you want filesystem tools limited to selected directories, repeat `--workspace` for each allowed directory. The CLI docs say `--allow-unrestricted-paths` cannot be combined with `--workspace`; server configuration also accepts `--filesystemRoot` or `--filesystem-root`.",
    "examples": [
      "chrome-devtools start --workspace=<repository-directory> --workspace=<output-directory>",
      "{\"mcpServers\":{\"chrome-devtools\":{\"command\":\"npx\",\"args\":[\"chrome-devtools-mcp@<version>\",\"--filesystem-root=<allowed-directory>\",\"--filesystem-root=<another-allowed-directory>\"]}}}"
    ],
    "gotchas": [
      "Version: 1.9.0",
      "--workspace: Directory filesystem tools may access; repeat for each directory. Cannot be combined with `--allow-unrestricted-paths`.",
      "--filesystemRoot / --filesystem-root: Array of directories filesystem tools may access; may be specified more than once. Default: OS temp directory.",
      "--allow-unrestricted-paths: CLI compatibility option; cannot be combined with `--workspace`.",
      "Prerequisite: Install the CLI globally with `npm i chrome-devtools-mcp@latest -g` to make the `chrome-devtools` command available.",
      "The CLI enables unrestricted filesystem access by default.",
      "`--workspace` may be repeated for multiple directories.",
      "`--allow-unrestricted-paths` still works on its own for compatibility but cannot be combined with `--workspace`.",
      "The default `--filesystemRoot` is the OS temp directory.",
      "Configured roots work together with roots sent by the MCP client; temp directory access stays the same."
    ]
  },
  "why_it_matters": "Limit filesystem tools to repository and output directories while starting Chrome DevTools MCP.",
  "before": "The CLI enables unrestricted filesystem access by default; use `--allow-unrestricted-paths` to retain that behavior for compatibility, but do not combine it with `--workspace`.",
  "sources": [
    "https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.9.0",
    "https://github.com/ChromeDevTools/chrome-devtools-mcp/pull/2605",
    "https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/d00e6f8239d9377fba60f19be635b1bef36ade33/docs/cli.md",
    "https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/d00e6f8239d9377fba60f19be635b1bef36ade33/docs/configuration.md"
  ],
  "rank": 0.98045,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v1+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "ghtools-20261008",
    "verdict_id": "ghtools-20261008:ghtools-20261008-ce8e9fb01ddcf822-8:gate",
    "evidence_hash": "024b1f67e5767639eba974ae1629b86ebc2386599fa614679aeeb61533a8bdcb"
  },
  "review": {
    "draft_hash": "3f41aee4b214aec8c7c7416254cd1e22b356a220a858c4a773b7d3111e0e9061",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "ghtools-20261008:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.98 >= 0.9; 2 needed) and Jev gave 0.77 (>= 0.6 needed)."
  }
}