Skip to content

docs:add Linux support to build-server tutorial #3243

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
olaservo merged 3 commits into from
Aug 14, 2026
+100 −116
Merged

docs:add Linux support to build-server tutorial #3243

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
4f58c77
docs:add Linux support to build-server tutorial
miniMagic-beep Aug 14, 2026
20f7d7f
docs:add Linux support to build-server tutorial-draft
miniMagic-beep Aug 14, 2026
58a234e
style: run prettier --write on build-server.mdx files
miniMagic-beep Aug 14, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
106 changes: 48 additions & 58 deletions docs/docs/2026-07-28/develop/build-server.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -261,12 +261,6 @@ Let's now test your server from an existing MCP host, Claude for Desktop.

## Testing your server with Claude for Desktop

<Note>

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.

</Note>

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.**

Expand All @@ -276,7 +270,11 @@ For example, if you have [VS Code](https://code.visualstudio.com/) installed:

<CodeGroup>

```bash macOS/Linux
```bash Linux
code ~/.config/Claude/claude_desktop_config.json
```

```bash macOS
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
```

Expand Down Expand Up @@ -746,12 +744,6 @@ Let's now test your server from an existing MCP host, Claude for Desktop.

## Testing your server with Claude for Desktop

<Note>

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.

</Note>

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.**

Expand All @@ -761,7 +753,11 @@ For example, if you have [VS Code](https://code.visualstudio.com/) installed:

<CodeGroup>

```bash macOS/Linux
```bash Linux
code ~/.config/Claude/claude_desktop_config.json
```

```bash macOS
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
```

Expand Down Expand Up @@ -982,12 +978,6 @@ Let's now test your server from an existing MCP host, Claude for Desktop.

## Testing your server with Claude for Desktop

<Note>

Claude for Desktop is not yet available on Linux.

</Note>

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.**

Expand All @@ -999,7 +989,11 @@ For example, if you have [VS Code](https://code.visualstudio.com/) installed:

<CodeGroup>

```bash macOS/Linux
```bash Linux
code ~/.config/Claude/claude_desktop_config.json
```

```bash macOS
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
```

Expand Down Expand Up @@ -1427,12 +1421,6 @@ Let's now test your server from an existing MCP host, Claude for Desktop.

## Testing your server with Claude for Desktop

<Note>

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.

</Note>

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.**

Expand All @@ -1444,7 +1432,11 @@ For example, if you have [VS Code](https://code.visualstudio.com/) installed:

<CodeGroup>

```bash macOS/Linux
```bash Linux
code ~/.config/Claude/claude_desktop_config.json
```

```bash macOS
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
```

Expand Down Expand Up @@ -1701,20 +1693,18 @@ This will start the server and listen for incoming requests on standard input/ou

## Testing your server with Claude for Desktop

<Note>

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.

</Note>

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.**
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.
For example, if you have [VS Code](https://code.visualstudio.com/) installed:

<CodeGroup>

```bash macOS/Linux
```bash Linux
code ~/.config/Claude/claude_desktop_config.json
```

```bash macOS
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
```

Expand Down Expand Up @@ -2011,12 +2001,6 @@ Let's now test your server from an existing MCP host, Claude for Desktop.

## Testing your server with Claude for Desktop

<Note>

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.

</Note>

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.**

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.
Expand All @@ -2025,7 +2009,11 @@ For example, if you have [VS Code](https://code.visualstudio.com/) installed:

<CodeGroup>

```bash macOS/Linux
```bash Linux
code ~/.config/Claude/claude_desktop_config.json
```

```bash macOS
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
```

Expand Down Expand Up @@ -2449,12 +2437,6 @@ Let's now test your server from an existing MCP host, Claude for Desktop.

## Testing your server with Claude for Desktop

<Note>

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.

</Note>

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.**

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.
Expand All @@ -2463,7 +2445,11 @@ For example, if you have [VS Code](https://code.visualstudio.com/) installed:

<CodeGroup>

```bash macOS/Linux
```bash Linux
code ~/.config/Claude/claude_desktop_config.json
```

```bash macOS
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
```

Expand Down Expand Up @@ -2894,12 +2880,6 @@ Let's now test your server from an existing MCP host, Claude for Desktop.

## Testing your server with Claude for Desktop

<Note>

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.

</Note>

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.**

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.
Expand All @@ -2908,7 +2888,11 @@ For example, if you have [VS Code](https://code.visualstudio.com/) installed:

<CodeGroup>

```bash macOS/Linux
```bash Linux
code ~/.config/Claude/claude_desktop_config.json
```

```bash macOS
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
```

Expand Down Expand Up @@ -3014,18 +2998,23 @@ When you ask a question:

**Getting logs from Claude for Desktop**

Claude.app logging related to MCP is written to log files in `~/Library/Logs/Claude`:
Claude.app logging related to MCP is written to log files in `~/Library/Logs/Claude` (macOS) or `~/.config/Claude/logs/` (Linux):

- `mcp.log` will contain general logging about MCP connections and connection failures.
- 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.

You can run the following command to list recent logs and follow along with any new ones:

```bash
```bash macOS
# Check Claude's logs for errors
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
```

```bash Linux
# Check Claude's logs for errors
tail -n 20 -f ~/.config/Claude/logs/mcp*.log
```

**Server not showing up in Claude**

1. Check your `claude_desktop_config.json` file syntax
Expand All @@ -3038,6 +3027,7 @@ To properly restart Claude for Desktop, you must fully quit the application:

- **Windows**: Right-click the Claude icon in the system tray (which may be hidden in the "hidden icons" menu) and select "Quit" or "Exit".
- **macOS**: Use Cmd+Q or select "Quit Claude" from the menu bar.
- **Linux**: Right-click the Claude icon in the system tray and select "Quit", or run `pkill -f claude-desktop` from a terminal.

Simply closing the window does not fully quit the application, and your MCP server configuration changes will not take effect.

Expand Down
Loading
Loading