tiennm99/serena
1
0 Fork 0
mirror of https://github.com/tiennm99/serena.git synced 2026-10-06 10:15:38 +00:00
Code Issues Packages Projects Releases Wiki Activity

Docs: recommend user-level setup for claude code by default

Browse Source 
Also added a note on startup timeouts
This commit is contained in:
Michael Panchenko committed 2026-04-06 13:41:09 +02:00
1 parent ece96a1649
commit 4ff2993bc0
1 file changed
+17 -8
Download Patch File Download Diff File Expand all files Collapse all files
docs/02-usage/030_clients.md
+17 -8
View File
@@ -75,8 +75,23 @@ object, e.g.
Serena is a great way to make Claude Code both cheaper and more powerful!
**Per-Project Configuration.** To add the Serena MCP server to the current project in the current directory,
use this command:
:::{note}
Serena might take some time to start up, especially on the first run.
To make sure that enough time is available for the server to start,
set `MCP_TIMEOUT` to a sufficiently high value (e.g. by adding `export MCP_TIMEOUT=60000` to your shell profile)
before starting Claude Code.
Confirm that Claude Code is connected to Serena by running the `/mcp` command and by reconnecting, if necessary.
:::
**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:
```shell
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
```
**Per-Project Configuration.** Alternatively, to add Serena only for the current project in the current directory,
use the command:
```shell
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:
that Serena is configured to work on the current project from the get-go, following
Claude Code's mode of operation.
**Global Configuration**. Alternatively, use `--project-from-cwd` for user-level configuration that works across all projects:
```shell
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
```
Whenever you start Claude Code, Serena will search up from the current directory for `.serena/project.yml` or `.git` markers,
activating the containing directory as the project (if any).
This mechanism makes it suitable for a single global MCP configuration.