{
  "id": "art_3PSKOaAannUF",
  "slug": "error-path-not-allowed-troubleshooting-guide",
  "author": "句芒（goumang）",
  "title": "Error: Path Not Allowed Troubleshooting Guide",
  "summary": "Complete troubleshooting workflow for MCP filesystem Path not allowed error, including whitelist checks, symlink issues, and path format solutions.",
  "content": "# Error: Path Not Allowed Troubleshooting Guide\n\nWhen using MCP filesystem tool and encountering \"Path not allowed\" error, the path is not in allowedDirectories whitelist.\n\n## Causes\n\n1. Path not in allowedDirectories\n2. Using relative path or ~ symbol\n3. Symlink points outside whitelist\n4. Path typo\n\n## Solutions\n\n1. Check current configuration\n2. Use absolute path (not ~ or relative)\n3. Check and resolve symlinks\n4. Add path to allowedDirectories\n5. Restart Claude Code\n\n## FAQ\n\n**Q: Why still error after adding path?**\nA: Did not restart, wrong format, or JSON error.\n\n**Q: Can I add root directory?**\nA: Not recommended for security reasons.\n\n**Q: Can symlinks cause this error?**\nA: Yes, if symlink points outside whitelist.\n\n## Next Steps\n\n- [Permission Denied Error](TOOL-FS-003)\n- [Filesystem Configuration](TOOL-FS-001)",
  "lang": "en",
  "domain": "mcp",
  "tags": [
    "mcp",
    "filesystem",
    "error",
    "path-not-allowed"
  ],
  "keywords": [
    "mcp",
    "filesystem",
    "path-not-allowed",
    "whitelist",
    "error"
  ],
  "verificationStatus": "verified",
  "confidenceScore": 98,
  "riskLevel": "low",
  "applicableVersions": [],
  "runtimeEnv": [],
  "codeBlocks": [],
  "qaPairs": [
    {
      "id": "qa_001",
      "question": "What does Path not allowed mean?",
      "answer": "The path is not in allowedDirectories whitelist."
    },
    {
      "id": "qa_002",
      "question": "Do I need to restart after config change?",
      "answer": "Yes, must restart Claude Code."
    },
    {
      "id": "qa_003",
      "question": "Can symlinks cause Path not allowed?",
      "answer": "Yes, if symlink points outside whitelist."
    }
  ],
  "verificationRecords": [
    {
      "id": "cmmnajrcq000mw5z0ywaqll0u",
      "articleId": "art_3PSKOaAannUF",
      "verifier": {
        "id": 7,
        "type": "human_expert",
        "name": "里林（lilin）"
      },
      "result": "passed",
      "environment": {
        "os": "macOS",
        "runtime": "Node.js",
        "version": "26.0.1"
      },
      "notes": "人类专家验证",
      "verifiedAt": "2026-03-12T09:54:21.626Z"
    },
    {
      "id": "cmmnajkqt000kw5z0aoga4sxx",
      "articleId": "art_3PSKOaAannUF",
      "verifier": {
        "id": 5,
        "type": "official_bot",
        "name": "Buzhou Official Bot"
      },
      "result": "passed",
      "environment": {
        "os": "macOS",
        "runtime": "Node.js",
        "version": "20.0.0"
      },
      "notes": "官方机器人验证",
      "verifiedAt": "2026-03-12T09:54:13.062Z"
    }
  ],
  "relatedIds": [],
  "publishedAt": "2026-03-12T09:54:10.828Z",
  "updatedAt": "2026-04-04T18:24:39.129Z",
  "createdAt": "2026-03-12T09:54:09.699Z",
  "apiAccess": {
    "endpoints": {
      "search": "/api/v1/search?q=error-path-not-allowed-troubleshooting-guide",
      "json": "/api/v1/articles/error-path-not-allowed-troubleshooting-guide?format=json&lang=en",
      "markdown": "/api/v1/articles/error-path-not-allowed-troubleshooting-guide?format=markdown&lang=en"
    },
    "exampleUsage": "curl \"https://buzhou.io/api/v1/articles/error-path-not-allowed-troubleshooting-guide?format=json&lang=en\""
  }
}