Guide for setup Serena MCP server for semantic code retrieval and editing capabilities

User Input: Guide for setup Serena MCP server 1. Determine setup context Ask the user where they want to store the configuration: Options: 1. Project level (shared via git) Configuration tracked in version control, shared with team CLAUDE.md updates go to: ./CLAUDE.md 2. Project level (personal preferences) Configuration stays local, not tracked in git CLAUDE.md updates go to: ./CLAUDE.local.md Verify these files are listed in .gitignore , add them if not 3. User level (global) Configuration applies to all projects for this user CLAUDE.md updates go to: ~/.claude/CLAUDE.md Store the user's choice and use the appropriate paths in subsequent steps. 2. Check if Serena MCP server is already setup Check whether you have access to Serena MCP server by attempting to use one of its tools (e.g., find symbol or get symbols overview ). If no access, proceed with setup. 3. Load Serena documentation Read the following documentation to understand Serena's capabilities and setup process: Load <https://raw.githubusercontent.com/oraios/serena/refs/heads/main/README.md to understand what Serena is and its capabilities Load <https://oraios.github.io/serena/02 usage/020 running.html to learn how to run Serena Load <https://oraios.github.io/serena/02 usage/030 clients.html to learn how to configure your MCP client Load <https://oraios.github.io/serena/02 usage/040 workflow.html to learn how to setup Serena for your project 4. Guide user through setup process Based on the loaded documentation: 1. Check prerequisites : Verify that uv is installed (required for running Serena) 2. Identify client type : Determine which MCP client the user is using (Claude Code, Claude Desktop, Cursor, VSCode, etc.) 3. Provide setup instructions : Guide through the configuration specific to their client if it not already configured 4. Setup project : Guide through the project setup process if it not already setup 5. Start indexing project : Guide through the project indexing process if it was just setup 6. If MCP was just setup, ask user to restart Claude Code to load the new MCP server, write to user explisit instructions, including "exit claude code console, then run 'claude continue' and then write "continue" to continue setup process" 7. Test connection : Verify that Serena tools are accessible after setup 1. If not yet, run initial instructions 2. Check if onboarding was performered, if not then run it. 3. Then try to read any file After adding MCP server, but before testings connection write to user this message EXACTLY: 5. Update CLAUDE.md file Use the path determined in step 1. Once Serena is successfully set up, update the appropriate CLAUDE.md file with the following content EXACTLY: Add this section, if server setup at user level (global): 6. Project initialization (if needed) If this is a new project or Serena hasn't been initialized: 1. Guide user to run project initialization commands 2. Explain project based workflow and indexing 3. Configure project specific settings if needed

setup-serena-mcp