Skip to content

Commit b91df18

Browse files
Merge pull request modelcontextprotocol#116 from jonathansampson/sampson-explain-appdata-enoent
Explains cause/solution for ${APPDATA} ENOENT
2 parents 16a93d7 + 3cecb06 commit b91df18

File tree

1 file changed

+29
-0
lines changed

1 file changed

+29
-0
lines changed

quickstart/user.mdx

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -193,6 +193,35 @@ type "%APPDATA%\Claude\logs\mcp*.log"
193193
</Accordion>
194194
<Accordion title="None of this is working. What do I do?">
195195
Please refer to our [debugging guide](/docs/tools/debugging) for better debugging tools and more detailed guidance.
196+
</Accordion>
197+
<Accordion title="ENOENT error and `${APPDATA}` in paths on Windows">
198+
If your configured server fails to load, and you see within its logs an error referring to `${APPDATA}` within a path, you may need to add the expanded value of `%APPDATA%` to your `env` key in `claude_desktop_config.json`:
199+
200+
```json
201+
{
202+
"brave-search": {
203+
"command": "npx",
204+
"args": ["-y", "@modelcontextprotocol/server-brave-search"],
205+
"env": {
206+
"APPDATA": "C:\\Users\\user\\AppData\\Roaming\\",
207+
"BRAVE_API_KEY": "..."
208+
}
209+
}
210+
}
211+
```
212+
213+
With this change in place, launch Claude Desktop once again.
214+
215+
<Warning>
216+
**NPM should be installed globally**
217+
218+
The `npx` command may continue to fail if you have not installed NPM globally. If NPM is already installed globally, you will find `%APPDATA%\npm` exists on your system. If not, you can install NPM globally by running the following command:
219+
220+
```bash
221+
npm install -g npm
222+
```
223+
</Warning>
224+
196225
</Accordion>
197226
</AccordionGroup>
198227

0 commit comments

Comments
 (0)