Mahesh's suggestions

Author: zckly

quickstart.mdx

@@ -9,7 +9,7 @@ In this tutorial, we'll build a simple MCP weather server and connect it to a ho
 
 Many LLMs (including Claude) do not currently have the ability to fetch the forecast and severe weather alerts. Let's use MCP to solve that!
 
-We'll build a server that exposes two tools: `get-alerts` and `get-forecast`. Then we'll connect the server to an MCP host (in this case, Claude Desktop):
+We'll build a server that exposes two tools: `get-alerts` and `get-forecast`. Then we'll connect the server to an MCP host (in this case, Claude for Desktop):
 
 <Frame>
   <img src="/images/weather-alerts.png" />
@@ -19,10 +19,10 @@ We'll build a server that exposes two tools: `get-alerts` and `get-forecast`. Th
 </Frame>
 
 <Note>
-Servers can connect to any host. We've chosen Claude desktop here for simplicity, but we also have guides on [building your own client](/tutorials/building-a-client)
+Servers can connect to any client. We've chosen Claude desktop here for simplicity, but we also have guides on [building your own client](/tutorials/building-a-client)
 </Note>
 
-<Accordion title="Why Claude Desktop and not Claude.ai?">
+<Accordion title="Why Claude for Desktop and not Claude.ai?">
   Because servers are locally run, MCP currently only supports desktop hosts. Remote hosts are in active development.
 </Accordion>
 
@@ -398,12 +398,12 @@ Let's now test your server from an existing MCP host, Claude for Desktop.
 ## Testing your server with Claude for Desktop
 
 <Note>
-Unfortunately, Claude for Desktop is not yet available on Linux. Linux users can proceed to the [Building a client](/tutorials/building-a-client) tutorial for a workaround.
+Claude for Desktop is not yet available on Linux. Linux users can proceed to the [Building a client](/tutorials/building-a-client) tutorial to build an MCP client that connects to the server we just built.
 </Note>
 
 First, make sure you have Claude for Desktop installed. [You can install the latest version here.](https://claude.ai/download)
 
-Next, open your Claude Desktop App configuration at `~/Library/Application Support/Claude/claude_desktop_config.json` in a text editor.
+Next, open your Claude for Desktop App configuration at `~/Library/Application Support/Claude/claude_desktop_config.json` in a text editor.
 
 For example, if you have [VS Code](https://code.visualstudio.com/) installed:
 
@@ -432,7 +432,7 @@ Add this configuration (replace the parent folder path):
             "command": "uv",
             "args": [
                 "--directory",
-                "/PATH/TO/PARENT/FOLDER/weather",
+                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/weather",
                 "run",
                 "weather"
             ]
@@ -449,7 +449,7 @@ Add this configuration (replace the parent folder path):
             "command": "uv",
             "args": [
                 "--directory",
-                "C:\\PATH\TO\PARENT\FOLDER\weather",
+                "C:\\ABSOLUTE\PATH\TO\PARENT\FOLDER\weather",
                 "run",
                 "weather"
             ]
@@ -460,11 +460,11 @@ Add this configuration (replace the parent folder path):
 </Tab>
 </Tabs>
 
-This tells Claude Desktop:
+This tells Claude for Desktop:
 1. There's an MCP server named "weather"
-2. Launch it by running `uv --directory /PATH/TO/PARENT/FOLDER/weather run weather` 
+2. Launch it by running `uv --directory /ABSOLUTE/PATH/TO/PARENT/FOLDER/weather run weather` 
 
-Save the file, and restart **Claude Desktop**.
+Save the file, and restart **Claude for Desktop**.
 </Tab>
 <Tab title="Node">
 ### Prerequisite knowledge
@@ -916,7 +916,7 @@ Unfortunately, Claude for Desktop is not yet available on Linux. Linux users can
 
 First, make sure you have Claude for Desktop installed. [You can install the latest version here.](https://claude.ai/download)
 
-Next, open your Claude Desktop App configuration at `~/Library/Application Support/Claude/claude_desktop_config.json` in a text editor.
+Next, open your Claude for Desktop App configuration at `~/Library/Application Support/Claude/claude_desktop_config.json` in a text editor.
 
 For example, if you have [VS Code](https://code.visualstudio.com/) installed:
 
@@ -945,7 +945,7 @@ Add this configuration (replace the parent folder path):
         "weather": {
             "command": "node",
             "args": [
-                "/PATH/TO/PARENT/FOLDER/weather/build/index.js"
+                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/weather/build/index.js"
             ]
         }
     }
@@ -971,17 +971,17 @@ Add this configuration (replace the parent folder path):
 </Tab>
 </Tabs>
 
-This tells Claude Desktop:
+This tells Claude for Desktop:
 1. There's an MCP server named "weather"
-2. Launch it by running `node /PATH/TO/PARENT/FOLDER/weather/build/index.js`
+2. Launch it by running `node /ABSOLUTE/PATH/TO/PARENT/FOLDER/weather/build/index.js`
 
-Save the file, and restart **Claude Desktop**.
+Save the file, and restart **Claude for Desktop**.
 </Tab>
 </Tabs>
 
 ### Test with commands
 
-First, make sure Claude Desktop is picking up the two tools we've exposed in our `weather` server. You can do this by looking for the hammer <img src="/images/claude-desktop-mcp-hammer-icon.svg" style={{display: 'inline', margin: 0, height: '1.3em'}} /> icon:
+First, make sure Claude for Desktop is picking up the two tools we've exposed in our `weather` server. You can do this by looking for the hammer <img src="/images/claude-desktop-mcp-hammer-icon.svg" style={{display: 'inline', margin: 0, height: '1.3em'}} /> icon:
 
 <Frame>
   <img src="/images/visual-indicator-mcp-tools.png" />
@@ -993,9 +993,9 @@ After clicking on the hammer icon, you should see two tools listed:
   <img src="/images/available-mcp-tools.png" />
 </Frame>
 
-If your server isn't being picked up by Claude Desktop, proceed to the **Troubleshooting** section for debugging advice.
+If your server isn't being picked up by Claude for Desktop, proceed to the [Troubleshooting](#troubleshooting) section for debugging advice.
 
-You can now test your server by running the following commands in Claude Desktop:
+You can now test your server by running the following commands in Claude for Desktop:
 
 - What's the weather in Sacramento?
 - What are the active weather alerts in Texas?
@@ -1043,11 +1043,11 @@ Fix:
 
 This isn't an error - it just means there are no current weather alerts for that state. Try a different state or check during severe weather.
 </Accordion>
-<Accordion title="Claude Desktop Integration Issues">
+<Accordion title="Claude for Desktop Integration Issues">
 **Server not showing up in Claude**
 1. Check your configuration file syntax
 2. Make sure the path to your project is correct
-3. Restart Claude Desktop completely
+3. Restart Claude for Desktop completely
 
 You can also check Claude's logs for errors like so:
 ```bash
@@ -1061,7 +1061,7 @@ If Claude attempts to use the tools but they fail:
 
 1. Check Claude's logs for errors
 2. Verify your server runs without errors
-3. Try restarting Claude Desktop
+3. Try restarting Claude for Desktop
 </Accordion>
 </AccordionGroup>
 

tutorials/building-a-client.mdx

@@ -306,7 +306,7 @@ uv run client.py path/to/build/index.js # node server
 ```
 
 <Note>
-If you're continuing the weather tutorial from the quickstart, you might have to initialize the server with `uv --directory /PATH/TO/PARENT/weather run weather`
+If you're continuing the weather tutorial from the quickstart, your command might look something like this: `python client.py .../weather/src/weather/server.py`
 </Note>
 
 The client will: