Serena MCP: cómo darle navegación semántica al agente en VS Code

La documentación del proyecto describe operaciones de búsqueda y edición por símbolos, además del soporte a más de 40 lenguajes mediante servidores de lenguaje. Serena no es un modelo de IA ni trabaja sola: el agente sigue siendo responsable de interpretar la solicitud y decidir qué herramientas usar.

Como Serena se conecta ao agente

Serena puede exponer sus herramientas a clientes compatibles con MCP, incluyendo VS Code y otros entornos de programación. En el backend estándar, usa servidores de lenguaje para entender símbolos y relaciones en el código. También existe un backend basado en plugin para JetBrains, con recursos propios; consulta la visión general de las opciones antes de elegir.

Esto es distinto a simplemente agregar otro servidor genérico. Serena ofrece operaciones como localizar símbolos y referencias, consultar la estructura de archivos y realizar algunas ediciones simbólicas. Las capacidades varían según el lenguaje y el backend configurado; no toda operación existe para todos los servidores de lenguaje.

Instalar Serena

La documentación oficial de instalación usa uv como gestor. Instala el paquete e inicializa la herramienta:

$ uv tool install -p 3.13 serena-agent
$ serena init

El parámetro -p 3.13 selecciona Python 3.13 para la instalación. serena init configura el backend estándar de servidores de lenguaje; algunos lenguajes pueden requerir dependencias adicionales, listadas en la página de soporte de lenguajes.

Conectar ao VS Code

En VS Code, abre la Paleta de Comandos y elige MCP: Add Server. Selecciona Command (stdio) y configura Serena para el workspace actual con:

serena start-mcp-server --context=vscode --project ${workspaceFolder}

Esta es la opción por workspace descrita en la guía oficial para clientes MCP. Limita la configuración al proyecto abierto y permite que Serena lo reconozca automáticamente.

También es posible configurar Serena de forma global con serena start-mcp-server --context=vscode. La documentación indica que, por una limitación de VS Code, esta opción puede no activar el proyecto por sí sola. En ese caso, pide al agente al inicio de la sesión: “Activa el directorio actual como proyecto usando Serena”. Luego, verifica que el servidor y las herramientas aparezcan en el área de chat.

Para entender las opciones generales de configuración en el editor, consulta nuestra guía de MCP en VS Code. Y combina la navegación semántica con instrucciones de proyecto bien delimitadas usando el artículo sobre AGENTS.md.

Limites de segurança e licença

Serena puede ofrecer al agente herramientas que modifican archivos y ejecutan comandos. El mantenedor afirma que los proyectos no confiables no quedan automáticamente en sandbox: las reglas de confianza limitan algunas influencias del repositorio, pero no son una frontera de contención. Para código de origen dudoso, usa un entorno aislado y revisa cada acción. Consulta las consideraciones oficiales de seguridad.

También es importante revisar la licencia antes de redistribuir o integrar el software. La licencia es por componente: SolidLSP, base del backend de inteligencia de código, está bajo MIT; la aplicación Serena, incluyendo servidor MCP y herramientas, está bajo GPL-3.0-or-later a partir de la transición de la versión 2. La distribución que combina los componentes, como el paquete serena-agent, queda bajo GPL-3.0-or-later. Consulta la explicación oficial de las licencias.