Skip to content

Commit 0f0bcfd

Browse files
committed
Add Windows support to user quickstart, move user quickstart to end, remove open source quick start.
1 parent 75bfa63 commit 0f0bcfd

File tree

4 files changed

+67
-48
lines changed

4 files changed

+67
-48
lines changed

introduction.mdx

Lines changed: 3 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -46,13 +46,6 @@ Choose the path that best fits your needs:
4646

4747
#### Quick Starts
4848
<CardGroup cols={2}>
49-
<Card
50-
title="For Claude Users"
51-
icon="bolt"
52-
href="/quickstart/user"
53-
>
54-
Get started using pre-built servers in Claude for Desktop to experience the power of MCP
55-
</Card>
5649
<Card
5750
title="For Server Developers"
5851
icon="bolt"
@@ -68,11 +61,11 @@ Choose the path that best fits your needs:
6861
Get started building your own client that can integrate with all MCP servers
6962
</Card>
7063
<Card
71-
title="For Open Source Developers"
64+
title="For Claude Desktop Users"
7265
icon="bolt"
73-
href="/quickstart/opensource"
66+
href="/quickstart/user"
7467
>
75-
Dig into the MCP spec and contribute to the ongoing development of MCP
68+
Get started using pre-built servers in Claude for Desktop
7669
</Card>
7770
</CardGroup>
7871

mint.json

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -50,10 +50,9 @@
5050
{
5151
"group": "Quickstart",
5252
"pages": [
53-
"quickstart/user",
5453
"quickstart/server",
5554
"quickstart/client",
56-
"quickstart/opensource"
55+
"quickstart/user"
5756
]
5857
},
5958
"examples",

quickstart/opensource.mdx

Lines changed: 0 additions & 22 deletions
This file was deleted.

quickstart/user.mdx

Lines changed: 63 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
2-
title: "For Claude Users"
3-
description: "Get started using pre-built servers in Claude for Desktop to experience the power of MCP."
2+
title: "For Claude Desktop Users"
3+
description: "Get started using pre-built servers in Claude for Desktop."
44
---
55

6-
In this tutorial, you will extend Claude for Desktop so that it can read from your computer's file system, write new files, move files, and even search files.
6+
In this tutorial, you will extend [Claude for Desktop](https://claude.ai/download) so that it can read from your computer's file system, write new files, move files, and even search files.
77

88
<Frame>
99
<img src="/images/quickstart-filesystem.png" />
@@ -39,9 +39,15 @@ Click on "Developer" in the lefthand bar of the Settings pane, and then click on
3939
<img src="/images/quickstart-developer.png" />
4040
</Frame>
4141

42-
This will create a configuration file at `~/Library/Application Support/Claude/claude_desktop_config.json` if you don't already have one, and will display the file in your file system.
42+
This will create a configuration file at:
43+
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
44+
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
4345

44-
Open up the configuration file in any text editor (e.g. [VS Code](https://code.visualstudio.com/)). Replace the file contents with this:
46+
if you don't already have one, and will display the file in your file system.
47+
48+
Open up the configuration file in any text editor. Replace the file contents with this:
49+
<Tabs>
50+
<Tab title="MacOS/Linux">
4551
```json
4652
{
4753
"mcpServers": {
@@ -57,17 +63,40 @@ Open up the configuration file in any text editor (e.g. [VS Code](https://code.v
5763
}
5864
}
5965
```
66+
</Tab>
67+
<Tab title="Windows">
68+
```json
69+
{
70+
"mcpServers": {
71+
"filesystem": {
72+
"command": "npx",
73+
"args": [
74+
"-y",
75+
"@modelcontextprotocol/server-filesystem",
76+
"C:\\Users\\username\\Desktop",
77+
"C:\\Users\\username\\Downloads"
78+
]
79+
}
80+
}
81+
}
82+
```
83+
</Tab>
84+
</Tabs>
6085

6186
Make sure to replace `username` with your computer's username. The paths should point to valid directories that you want Claude to be able to access and modify. It's set up to work for Desktop and Downloads, but you can add more paths as well.
6287

63-
You will also need Node.js on your computer for this to run properly. In the command line of your computer, verify you have Node installed:
88+
You will also need [Node.js](https://nodejs.org) on your computer for this to run properly. To verify you have Node installed, open the command line on your computer.
89+
- On macOS, open the Terminal from your Applications folder
90+
- On Windows, press Windows + R, type "cmd", and press Enter
91+
92+
Once in the command line, verify you have Node installed by entering in the following command:
6493
```bash
6594
node --version
6695
```
67-
If needed, download Node from [nodejs.org](https://nodejs.org/).
96+
If you get an error saying "command not found" or "node is not recognized", download Node from [nodejs.org](https://nodejs.org/).
6897

6998
<Tip>
70-
**How does this work?**
99+
**How does the configuration file work?**
71100

72101
This configuration file tells Claude for Dekstop which MCP servers to start up every time you start the application. In this case, we have added one server called "filesystem" that will use the Node `npx` command to install and run `@modelcontextprotocol/server-filesystem`. This server, described [here](https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem), will let you access your file system in Claude for Desktop.
73102
</Tip>
@@ -113,21 +142,41 @@ As needed, Claude will call the relevant tools and seek your approval before tak
113142
3. Make sure the file paths included in `claude_desktop_config.json` are valid and that they are absolute and not relative
114143
4. Look at [logs](#getting-logs-from-claude-for-desktop) to see why the server is not connecting
115144
5. In your command line, try manually running the server (replacing `username` as you did in `claude_desktop_config.json`) to see if you get any errors:
145+
<Tabs>
146+
<Tab title="MacOS/Linux">
116147
```bash
117148
npx -y @modelcontextprotocol/server-filesystem /Users/username/Desktop /Users/username/Downloads`
118149
```
150+
</Tab>
151+
<Tab title="Windows">
152+
```bash
153+
npx -y @modelcontextprotocol/server-filesystem C:\Users\username\Desktop C:\Users\username\Downloads
154+
```
155+
</Tab>
156+
</Tabs>
119157
</Accordion>
120158
<Accordion title="Getting logs from Claude for Desktop">
121-
Claude.app logging related to MCP is written to log files in `~/Library/Logs/Claude`:
159+
Claude.app logging related to MCP is written to log files in:
160+
- macOS: `~/Library/Logs/Claude`
161+
- Windows: `%APPDATA%\Claude\logs`
122162

123163
- `mcp.log` will contain general logging about MCP connections and connection failures.
124164
- Files named `mcp-server-SERVERNAME.log` will contain error (stderr) logging from the named server.
125165

126-
You can run the following command to list recent logs and follow along with any new ones:
127-
```bash
128-
# Check Claude's logs for errors
129-
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
130-
```
166+
You can run the following command to list recent logs and follow along with any new ones (on Windows, it will only show recent logs):
167+
<Tabs>
168+
<Tab title="MacOS/Linux">
169+
```bash
170+
# Check Claude's logs for errors
171+
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
172+
```
173+
</Tab>
174+
<Tab title="Windows">
175+
```bash
176+
type "%APPDATA%\Claude\logs\mcp*.log"
177+
```
178+
</Tab>
179+
</Tabs>
131180
</Accordion>
132181
<Accordion title="Tool calls failing silently">
133182
If Claude attempts to use the tools but they fail:

0 commit comments

Comments
 (0)