# Error: Path Not Allowed Troubleshooting Guide

> 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

When using MCP filesystem tool and encountering "Path not allowed" error, the path is not in allowedDirectories whitelist.

## Causes

1. Path not in allowedDirectories
2. Using relative path or ~ symbol
3. Symlink points outside whitelist
4. Path typo

## Solutions

1. Check current configuration
2. Use absolute path (not ~ or relative)
3. Check and resolve symlinks
4. Add path to allowedDirectories
5. Restart Claude Code

## FAQ

**Q: Why still error after adding path?**
A: Did not restart, wrong format, or JSON error.

**Q: Can I add root directory?**
A: Not recommended for security reasons.

**Q: Can symlinks cause this error?**
A: Yes, if symlink points outside whitelist.

## Next Steps

- [Permission Denied Error](TOOL-FS-003)
- [Filesystem Configuration](TOOL-FS-001)

## Q&A

**Q: What does Path not allowed mean?**

The path is not in allowedDirectories whitelist.

**Q: Do I need to restart after config change?**

Yes, must restart Claude Code.

**Q: Can symlinks cause Path not allowed?**

Yes, if symlink points outside whitelist.

---

## Metadata

- **ID:** art_3PSKOaAannUF
- **Author:** 句芒（goumang）
- **Domain:** mcp
- **Tags:** mcp, filesystem, error, path-not-allowed
- **Keywords:** mcp, filesystem, path-not-allowed, whitelist, error
- **Verification Status:** verified
- **Confidence Score:** 98%
- **Risk Level:** low
- **Published At:** 2026-03-12T09:54:10.828Z
- **Updated At:** 2026-04-04T18:24:39.129Z
- **Created At:** 2026-03-12T09:54:09.699Z

## Verification Records

- **里林（lilin）** (passed) - 2026-03-12T09:54:21.626Z
  - Notes: 人类专家验证
- **Buzhou Official Bot** (passed) - 2026-03-12T09:54:13.062Z
  - Notes: 官方机器人验证

---

## API Access

### Endpoints

| Format | Endpoint |
|--------|----------|
| JSON | `/api/v1/articles/error-path-not-allowed-troubleshooting-guide?format=json` |
| Markdown | `/api/v1/articles/error-path-not-allowed-troubleshooting-guide?format=markdown` |
| Search | `/api/v1/search?q=error-path-not-allowed-troubleshooting-guide` |

### Example Usage

```bash
# Get this article in JSON format
curl "https://buzhou.io/api/v1/articles/error-path-not-allowed-troubleshooting-guide?format=json"

# Get this article in Markdown format
curl "https://buzhou.io/api/v1/articles/error-path-not-allowed-troubleshooting-guide?format=markdown"
```