How to Set Up Serena MCP with Qoder on Windows
1. Prerequisites
- Windows 10/11
- Qoder is installed
- uv is installed via WinGet or another method (
uvx.exeis available) - Git for Windows is installed, and
git --versioncan be run in PowerShell
2. Problem Overview
While Serena MCP runs correctly in a WSL environment, the following issues occur on native Windows:
- When launched with a
stdioconnection, Qoder does not communicate with Serena after startup. - With a
streamable-httpconnection, Qoder accesses the root (/) and receives a 404 error.
This results in a state where "Qoder cannot connect to Serena."
3. Verified Solution
3.1 Manually Start Serena as an HTTP Server
First, run the following command in PowerShell to start Serena MCP in streamable-http mode.
uvx --from git+https://github.com/oraios/serena serena start-mcp-server --context ide-assistant --transport streamable-http
- By default, the server starts at
http://127.0.0.1:8000. - A "StreamableHTTP session manager started" message in the log indicates a successful launch.
3.2 Configure mcp.json in Qoder
Configure Qoder to use Serena MCP via an HTTP connection.
The key is to set the URL to /mcp, as the root (/) will result in a 404 error.
"serena": {
"type": "streamableHttp",
"url": "http://127.0.0.1:8000/mcp"
}
After this, enabling "MCP" in Qoder will establish the connection from Qoder to Serena.
4. Important Notes
- This requires the manual step of starting Serena.
- If you want Serena to run persistently, you can use the Windows Task Scheduler to launch it automatically on logon.
5. Summary
- Start Serena MCP with
--transport streamable-httpin PowerShell. - Set the
urlin Qoder'smcp.jsontohttp://127.0.0.1:8000/mcp. - Optionally, use Task Scheduler to automate the launch.
Related Articles
Connecting AI Tools to Obsidian with MCP Server - Gemini CLI & Kiro Guide
Learn how to set up Obsidian MCP server to control your notes from Gemini CLI and Kiro. Complete guide including Windows and WSL environment setup.
How to Restore 'Open with Code' in VSCode Right-Click Menu
Learn how to restore the missing 'Open with Code' option in Windows right-click context menu with two effective methods: VSCode reinstallation and manual registry file configuration.
A Minimal Setup Guide for Building an MCP Server Development Environment with TypeScript
This article explains the minimum environment construction procedure for developing an MCP (Model Context Protocol) server using TypeScript. We have compiled practical know-how, including how to configure Biome and Husky and how to publish with npm.