Skip to content

Commit 4ff2993

Browse files
committed
Docs: recommend user-level setup for claude code by default
Also added a note on startup timeouts
1 parent ece96a1 commit 4ff2993

File tree

1 file changed

+17
-8
lines changed

1 file changed

+17
-8
lines changed

docs/02-usage/030_clients.md

Lines changed: 17 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -75,8 +75,23 @@ object, e.g.
7575

7676
Serena is a great way to make Claude Code both cheaper and more powerful!
7777

78-
**Per-Project Configuration.** To add the Serena MCP server to the current project in the current directory,
79-
use this command:
78+
:::{note}
79+
Serena might take some time to start up, especially on the first run.
80+
To make sure that enough time is available for the server to start,
81+
set `MCP_TIMEOUT` to a sufficiently high value (e.g. by adding `export MCP_TIMEOUT=60000` to your shell profile)
82+
before starting Claude Code.
83+
84+
Confirm that Claude Code is connected to Serena by running the `/mcp` command and by reconnecting, if necessary.
85+
:::
86+
87+
**Global Configuration**. To add the Serena MCP server for all your projects, use the user-level configuration of claude code and the `--project-from-cwd` flag:
88+
89+
```shell
90+
claude mcp add --scope user serena -- uvx --python 3.13 --from git+https://github.com/oraios/serena serena start-mcp-server --context=claude-code --project-from-cwd
91+
```
92+
93+
**Per-Project Configuration.** Alternatively, to add Serena only for the current project in the current directory,
94+
use the command:
8095

8196
```shell
8297
claude mcp add serena -- uvx --python 3.13 --from git+https://github.com/oraios/serena serena start-mcp-server --context claude-code --project "$(pwd)"
@@ -89,12 +104,6 @@ Note:
89104
that Serena is configured to work on the current project from the get-go, following
90105
Claude Code's mode of operation.
91106

92-
**Global Configuration**. Alternatively, use `--project-from-cwd` for user-level configuration that works across all projects:
93-
94-
```shell
95-
claude mcp add --scope user serena -- uvx -p 3.13 --from git+https://github.com/oraios/serena serena start-mcp-server --context=claude-code --project-from-cwd
96-
```
97-
98107
Whenever you start Claude Code, Serena will search up from the current directory for `.serena/project.yml` or `.git` markers,
99108
activating the containing directory as the project (if any).
100109
This mechanism makes it suitable for a single global MCP configuration.

0 commit comments

Comments
 (0)