diff --git a/quickstart.mdx b/quickstart.mdx index 6dc01f3..65a2097 100644 --- a/quickstart.mdx +++ b/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): @@ -19,10 +19,10 @@ We'll build a server that exposes two tools: `get-alerts` and `get-forecast`. Th -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) - + Because servers are locally run, MCP currently only supports desktop hosts. Remote hosts are in active development. @@ -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 -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. 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): -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**. ### 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): -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**. ### 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 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 icon: @@ -993,9 +993,9 @@ After clicking on the hammer icon, you should see two tools listed: -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. - + **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 diff --git a/tutorials/building-a-client.mdx b/tutorials/building-a-client.mdx index 81af005..d432f38 100644 --- a/tutorials/building-a-client.mdx +++ b/tutorials/building-a-client.mdx @@ -306,7 +306,7 @@ uv run client.py path/to/build/index.js # node server ``` -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` The client will: