Build an MCP server changeddocs/2026-07-28/develop/build-server
Nearest release: v2.1.233, published under an hour after this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Recorded here
Lines+48added
Lines−42removed
From line
253
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits6to this page, all time
The whole hunk
from line 253, old and new numbered
/
from line 253
253253
254254 ## Testing your server with Claude for Desktop
255255
256 <Note>
257 Claude for Desktop is not yet available on Linux. Linux users can proceed to the [Building a client](/docs/2026-07-28/develop/build-client) tutorial to build an MCP client that connects to the server we just built.
258 </Note>
259
260256 First, make sure you have Claude for Desktop installed. [You can install the latest version
261257 here.](https://claude.ai/download) If you already have Claude for Desktop, **make sure it's updated to the latest version.**
262258
from line 261
265261 For example, if you have [VS Code](https://code.visualstudio.com/) installed:
266262
267263 <CodeGroup>
268 ```bash macOS/Linux theme={null}
264 ```bash Linux theme={null}
265 code ~/.config/Claude/claude_desktop_config.json
266 ```
267
268 ```bash macOS theme={null}
269269 code ~/Library/Application\ Support/Claude/claude_desktop_config.json
270270 ```
271271
from line 724
724724
725725 ## Testing your server with Claude for Desktop
726726
727 <Note>
728 Claude for Desktop is not yet available on Linux. Linux users can proceed to the [Building a client](/docs/2026-07-28/develop/build-client) tutorial to build an MCP client that connects to the server we just built.
729 </Note>
730
731727 First, make sure you have Claude for Desktop installed. [You can install the latest version
732728 here.](https://claude.ai/download) If you already have Claude for Desktop, **make sure it's updated to the latest version.**
733729
from line 732
736732 For example, if you have [VS Code](https://code.visualstudio.com/) installed:
737733
738734 <CodeGroup>
739 ```bash macOS/Linux theme={null}
735 ```bash Linux theme={null}
736 code ~/.config/Claude/claude_desktop_config.json
737 ```
738
739 ```bash macOS theme={null}
740740 code ~/Library/Application\ Support/Claude/claude_desktop_config.json
741741 ```
742742
from line 947
947947
948948 ## Testing your server with Claude for Desktop
949949
950 <Note>
951 Claude for Desktop is not yet available on Linux.
952 </Note>
953
954950 First, make sure you have Claude for Desktop installed.
955951 [You can install the latest version here.](https://claude.ai/download) If you already have Claude for Desktop, **make sure it's updated to the latest version.**
956952
from line 957
961957 For example, if you have [VS Code](https://code.visualstudio.com/) installed:
962958
963959 <CodeGroup>
964 ```bash macOS/Linux theme={null}
960 ```bash Linux theme={null}
961 code ~/.config/Claude/claude_desktop_config.json
962 ```
963
964 ```bash macOS theme={null}
965965 code ~/Library/Application\ Support/Claude/claude_desktop_config.json
966966 ```
967967
from line 1380
13801380
13811381 ## Testing your server with Claude for Desktop
13821382
1383 <Note>
1384 Claude for Desktop is not yet available on Linux. Linux users can proceed to the [Building a client](/docs/2026-07-28/develop/build-client) tutorial to build an MCP client that connects to the server we just built.
1385 </Note>
1386
13871383 First, make sure you have Claude for Desktop installed. [You can install the latest version
13881384 here.](https://claude.ai/download) If you already have Claude for Desktop, **make sure it's updated to the latest version.**
13891385
from line 1390
13941390 For example, if you have [VS Code](https://code.visualstudio.com/) installed:
13951391
13961392 <CodeGroup>
1397 ```bash macOS/Linux theme={null}
1393 ```bash Linux theme={null}
1394 code ~/.config/Claude/claude_desktop_config.json
1395 ```
1396
1397 ```bash macOS theme={null}
13981398 code ~/Library/Application\ Support/Claude/claude_desktop_config.json
13991399 ```
14001400
from line 1643
16431643
16441644 ## Testing your server with Claude for Desktop
16451645
1646 <Note>
1647 Claude for Desktop is not yet available on Linux. Linux users can proceed to the [Building a client](/docs/2026-07-28/develop/build-client) tutorial to build an MCP client that connects to the server we just built.
1648 </Note>
1649
16501646 First, make sure you have Claude for Desktop installed. [You can install the latest version
16511647 here.](https://claude.ai/download) If you already have Claude for Desktop, **make sure it's updated to the latest version.**
16521648 We'll need to configure Claude for Desktop for whichever MCP servers you want to use. To do this, open your Claude for Desktop App configuration at `~/Library/Application Support/Claude/claude_desktop_config.json` in a text editor. Make sure to create the file if it doesn't exist.
from line 1649
16531649 For example, if you have [VS Code](https://code.visualstudio.com/) installed:
16541650
16551651 <CodeGroup>
1656 ```bash macOS/Linux theme={null}
1652 ```bash Linux theme={null}
1653 code ~/.config/Claude/claude_desktop_config.json
1654 ```
1655
1656 ```bash macOS theme={null}
16571657 code ~/Library/Application\ Support/Claude/claude_desktop_config.json
16581658 ```
16591659
from line 1943
19431943
19441944 ## Testing your server with Claude for Desktop
19451945
1946 <Note>
1947 Claude for Desktop is not yet available on Linux. Linux users can proceed to the [Building a client](/docs/2026-07-28/develop/build-client) tutorial to build an MCP client that connects to the server we just built.
1948 </Note>
1949
19501946 First, make sure you have Claude for Desktop installed. [You can install the latest version here.](https://claude.ai/download) If you already have Claude for Desktop, **make sure it's updated to the latest version.**
19511947
19521948 We'll need to configure Claude for Desktop for whichever MCP servers you want to use. To do this, open your Claude for Desktop App configuration at `~/Library/Application Support/Claude/claude_desktop_config.json` in a text editor. Make sure to create the file if it doesn't exist.
from line 1950
19541950 For example, if you have [VS Code](https://code.visualstudio.com/) installed:
19551951
19561952 <CodeGroup>
1957 ```bash macOS/Linux theme={null}
1953 ```bash Linux theme={null}
1954 code ~/.config/Claude/claude_desktop_config.json
1955 ```
1956
1957 ```bash macOS theme={null}
19581958 code ~/Library/Application\ Support/Claude/claude_desktop_config.json
19591959 ```
19601960
from line 2367
23672367
23682368 ## Testing your server with Claude for Desktop
23692369
2370 <Note>
2371 Claude for Desktop is not yet available on Linux. Linux users can proceed to the [Building a client](/docs/2026-07-28/develop/build-client) tutorial to build an MCP client that connects to the server we just built.
2372 </Note>
2373
23742370 First, make sure you have Claude for Desktop installed. [You can install the latest version here.](https://claude.ai/download) If you already have Claude for Desktop, **make sure it's updated to the latest version.**
23752371
23762372 We'll need to configure Claude for Desktop for whichever MCP servers you want to use. To do this, open your Claude for Desktop App configuration at `~/Library/Application Support/Claude/claude_desktop_config.json` in a text editor. Make sure to create the file if it doesn't exist.
from line 2374
23782374 For example, if you have [VS Code](https://code.visualstudio.com/) installed:
23792375
23802376 <CodeGroup>
2381 ```bash macOS/Linux theme={null}
2377 ```bash Linux theme={null}
2378 code ~/.config/Claude/claude_desktop_config.json
2379 ```
2380
2381 ```bash macOS theme={null}
23822382 code ~/Library/Application\ Support/Claude/claude_desktop_config.json
23832383 ```
23842384
from line 2800
28002800
28012801 ## Testing your server with Claude for Desktop
28022802
2803 <Note>
2804 Claude for Desktop is not yet available on Linux. Linux users can proceed to the [Building a client](/docs/2026-07-28/develop/build-client) tutorial to build an MCP client that connects to the server we just built.
2805 </Note>
2806
28072803 First, make sure you have Claude for Desktop installed. [You can install the latest version here.](https://claude.ai/download) If you already have Claude for Desktop, **make sure it's updated to the latest version.**
28082804
28092805 We'll need to configure Claude for Desktop for whichever MCP servers you want to use. To do this, open your Claude for Desktop App configuration at `~/Library/Application Support/Claude/claude_desktop_config.json` in a text editor. Make sure to create the file if it doesn't exist.
from line 2807
28112807 For example, if you have [VS Code](https://code.visualstudio.com/) installed:
28122808
28132809 <CodeGroup>
2814 ```bash macOS/Linux theme={null}
2810 ```bash Linux theme={null}
2811 code ~/.config/Claude/claude_desktop_config.json
2812 ```
2813
2814 ```bash macOS theme={null}
28152815 code ~/Library/Application\ Support/Claude/claude_desktop_config.json
28162816 ```
28172817
from line 2909
29092909 <Accordion title="Claude for Desktop Integration Issues">
29102910 **Getting logs from Claude for Desktop**
29112911
2912 Claude.app logging related to MCP is written to log files in `~/Library/Logs/Claude`:
2912 Claude.app logging related to MCP is written to log files in `~/Library/Logs/Claude` (macOS) or `~/.config/Claude/logs/` (Linux):
29132913
29142914 * `mcp.log` will contain general logging about MCP connections and connection failures.
29152915 * Files named `mcp-server-SERVERNAME.log` will contain the stderr output from the named server. Stdio servers may use stderr for all their logging, so these files are not limited to errors.
from line 2916
29162916
29172917 You can run the following command to list recent logs and follow along with any new ones:
29182918
2919 ```bash theme={null}
2919 ```bash macOS theme={null}
29202920 # Check Claude's logs for errors
29212921 tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
29222922 ```
29232923
2924 ```bash Linux theme={null}
2925 # Check Claude's logs for errors
2926 tail -n 20 -f ~/.config/Claude/logs/mcp*.log
2927 ```
2928
29242929 **Server not showing up in Claude**
29252930
29262931 1. Check your `claude_desktop_config.json` file syntax
from line 2937
29322937
29332938 * **Windows**: Right-click the Claude icon in the system tray (which may be hidden in the "hidden icons" menu) and select "Quit" or "Exit".
29342939 * **macOS**: Use Cmd+Q or select "Quit Claude" from the menu bar.
2940 * **Linux**: Right-click the Claude icon in the system tray and select "Quit", or run `pkill -f claude-desktop` from a terminal.
29352941
29362942 Simply closing the window does not fully quit the application, and your MCP server configuration changes will not take effect.
29372943 </Warning>
No line in this hunk matches that.