Skip to content

Commit 2192b0f

Browse files
committed
Improve Quick Start
1 parent fc8503f commit 2192b0f

File tree

1 file changed

+15
-8
lines changed

1 file changed

+15
-8
lines changed

README.md

Lines changed: 15 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -75,22 +75,29 @@ AL, Bash, C#, C/C++, Clojure, Dart, Elixir, Elm, Erlang, Fortran, Go, Haskell, J
7575
7676
## Quick Start
7777

78-
Serena is managed with **uv**. If you don’t already have it installed, you will need to [install it](https://docs.astral.sh/uv/getting-started/installation/).
78+
**Prerequisites**. Serena is managed by *uv*. If you don’t already have it, you need to [install uv](https://docs.astral.sh/uv/getting-started/installation/) before proceeding.
7979

80-
To get started as quickly as possible, you can directly enable the Serena MCP server in your client of choice (by following the links provided):
80+
**Starting the MCP Server**. The easiest way to start the Serena MCP server is by running the latest version from GitHub using uvx.
81+
Issue this command to see available options:
8182

82-
* For coding with Claude, we recommend using Serena through [Claude Code](https://oraios.github.io/serena/02-usage/030_clients.html#claude-code) or [Claude Desktop](#claude-desktop). You can also use Serena in [Codex](https://oraios.github.io/serena/02-usage/030_clients.html#codex) and a wide variety of [other clients](https://oraios.github.io/serena/02-usage/030_clients.html#other-clients).
83-
* If you want a GUI experience outside an IDE, you can use one of the many [local GUIs](https://oraios.github.io/serena/02-usage/030_clients.html#local-guis-and-agent-frameworks) that support MCP servers.
84-
You can also connect Serena to many web clients (including ChatGPT) using [mcpo](https://oraios.github.io/serena/03-special-guides/serena_on_chatgpt.html).
85-
* If you want to integrate Serena with your IDE, see the section on [other MCP clients](https://oraios.github.io/serena/02-usage/030_clients.html#mcp-enabled-ides-and-coding-clients-cline-roo-code-cursor-windsurf-etc).
83+
```bash
84+
uvx --from git+https://github.com/oraios/serena serena start-mcp-server --help
85+
```
86+
87+
**Configuring Your Client**. To connect Serena to your preferred MCP client, you typically need to [configure a launch command in your client](https://oraios.github.io/serena/02-usage/030_clients.html).
88+
Follow the link for specific instructions on how to set up Serena for Claude Code, Codex, Claude Desktop, MCP-enabled IDEs and other clients (such as local and web-based GUIs).
8689

8790
> [!TIP]
8891
> While getting started quickly is easy, Serena is a powerful toolkit with many configuration options.
89-
> We highly recommend reading through the [user guide](https://oraios.github.io/serena/) to get the most out of Serena.
92+
> We highly recommend reading through the [user guide](https://oraios.github.io/serena/02-usage) to get the most out of Serena.
93+
>
94+
> Specifically, we recommend to read about ...
95+
> * [Serena's project-based workflow](https://oraios.github.io/serena/02-usage/040_workflow.html) and
96+
> * [configuring Serena](https://oraios.github.io/serena/02-usage/050_configuration.html).
9097
9198
## User Guide
9299

93-
Please refer to the [user guide](https://oraios.github.io/serena/) for detailed instructions on how to use Serena effectively.
100+
Please refer to the [user guide](https://oraios.github.io/serena/02-usage) for detailed instructions on how to use Serena effectively.
94101

95102
## Community Feedback
96103

0 commit comments

Comments
 (0)