Driver FixRecommendedSound, Wi-Fi or graphics acting up? Check drivers firstFind missing or outdated drivers fast.Check DriversOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PC×
Skip to content
World desk5 min

Guía práctica: conecta Serena y CodeGraph con Claude Code

Serena ayuda a navegar y editar código por símbolos; CodeGraph consulta relaciones estructurales. Guía para conectarlos con Claude Code y comprobar MCP.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Serena y CodeGraph pueden dar a Claude Code dos formas distintas de entender un repositorio: Serena ayuda a navegar y editar código por símbolos y referencias usando LSP; CodeGraph expone relaciones estructurales —como clases, imports y llamadas— mediante un grafo consultable por MCP. Puedes configurar ambos como servidores MCP y comprobar que Claude Code los ve con /mcp.

Qué aporta cada herramienta

Las dos se integran con Claude Code a través del Model Context Protocol (MCP), pero sus funciones no son idénticas. Serena se orienta a operaciones semánticas sobre el código; CodeGraph, a consultas sobre la estructura y las relaciones del repositorio.

Herramienta En qué ayuda Qué declara su editor
Serena Buscar símbolos y referencias, navegar el código y realizar ediciones dirigidas con apoyo de LSP. La ficha de Serena en Claude Marketplace declara compatibilidad con más de 30 lenguajes: Claude Marketplace: Serena.
CodeGraph Consultar relaciones estructurales representadas en un grafo, incluidas funciones, clases, imports y cadenas de llamadas. Su README declara 42 herramientas MCP y análisis de 38 lenguajes mediante tree-sitter; son características publicadas por el proyecto, no resultados de una evaluación independiente: README de CodeGraph.

Como regla práctica, usa Serena cuando la tarea se formule en términos de una entidad del código —por ejemplo, localizar una función y sus referencias— y CodeGraph cuando quieras explorar cómo se relacionan componentes o llamadas en el repositorio. No hay evidencia publicada en las fuentes citadas de que una sustituya a la otra ni de una mejora cuantificada por combinarlas.

Cómo añadir Serena a Claude Code

La documentación de Serena presenta serena setup claude-code como la vía sencilla. Si prefieres configurar el servidor manualmente, elige el alcance según dónde quieras que esté disponible:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Configuración global para tu usuario

claude mcp add --scope user serena -- serena start-mcp-server --context claude-code --project-from-cwd

Con --scope user, la entrada se configura para el usuario, y --project-from-cwd indica a Serena que tome como proyecto el directorio de trabajo actual.

Configuración para el proyecto actual

claude mcp add serena -- serena start-mcp-server --context claude-code --project "$(pwd)"

Esta variante pasa explícitamente la ruta del directorio actual como proyecto. Ejecuta el comando desde la raíz del repositorio que quieres que Serena analice. La guía de Serena documenta ambos métodos y puede consultarse para revisar los comandos vigentes: Connecting Your MCP Client.

  1. Abre Claude Code en el repositorio correspondiente.
  2. Ejecuta uno de los métodos de configuración anteriores, no ambos por defecto.
  3. En Claude Code, escribe /mcp y comprueba si Serena aparece como conectada.
  4. Si no aparece conectada, usa la opción de reconexión disponible en esa pantalla y vuelve a comprobar el estado.

Cómo conectar CodeGraph

CodeGraph documenta una integración MCP para Claude Code y señala que indexa automáticamente el directorio de trabajo actual. Consulta sus instrucciones de instalación y configuración actuales en el README del proyecto, y configura el servidor MCP siguiendo esa guía.

La ruta exacta de instalación puede cambiar con las versiones del proyecto; no conviene sustituir las instrucciones publicadas allí por un comando supuesto. Una vez añadido el servidor, abre Claude Code desde el repositorio que quieres consultar y usa /mcp para verificar que la conexión está activa. La indexación automática descrita por CodeGraph se refiere al directorio de trabajo actual.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

MCP no es lo mismo que una extensión del IDE

CodeGraph también ofrece extensiones para VS Code y JetBrains, pero son superficies de integración distintas. Una extensión se usa desde su IDE; configurar MCP conecta el servidor con Claude Code. Instalar una extensión no demuestra por sí solo que Claude Code tenga el servidor MCP configurado.

Activa Serena para el proyecto y considera la indexación

El README de Serena explica una alternativa de arranque que usa el contexto ide-assistant y pasa la ruta del proyecto actual. También describe la ejecución mediante uvx y señala que el archivo de configuración del proyecto se guarda en .serena/project.yml. Para la configuración específica de Claude Code, sigue el método documentado para ese cliente; los ejemplos y opciones pueden variar entre guías y versiones. El README está disponible en el repositorio de Serena.

En proyectos grandes, Serena recomienda indexar el proyecto para acelerar las operaciones. Según su README, una primera operación puede tardar si el proyecto no se ha indexado. Si el inicio o la respuesta de Serena parece lento, ten en cuenta ese comportamiento antes de concluir que el servidor no está conectado.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Solución de problemas con Serena

La documentación de Serena advierte que algunas versiones o configuraciones de Claude Code pueden no seguir siempre las instrucciones de sus herramientas. El proyecto atribuye parte de la dificultad a la carga dinámica de herramientas y a que las instrucciones pueden perderse en sesiones largas; no presenta esto como un problema verificado en todas las instalaciones.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  • Serena no figura como conectada: abre /mcp, revisa el estado y prueba la opción de reconexión.
  • Serena tarda en iniciar: la documentación sugiere considerar un valor mayor para MCP_TIMEOUT si el arranque excede el límite actual.
  • Claude Code no usa las herramientas de Serena de forma consistente: Serena recomienda hooks de recordatorio, pero identifica esa función como alfa. Evalúa esa advertencia antes de depender de ella en un flujo de trabajo.
  • La primera operación en un repositorio grande es lenta: el README de Serena recomienda indexar el proyecto.

En su guía de conexión para Claude Code, Serena dice: “Recent updates to Claude Code (CC) and to the Opus line of models resulted in drastically reduced adherence to instructions pertaining to Serena’s tools.” Es una advertencia del propio proyecto sobre adherencia a instrucciones, no una medición independiente aplicable a toda instalación: documentación de Serena para clientes MCP.

Qué esperar de la combinación

Serena y CodeGraph ofrecen enfoques complementarios: el primero trabaja con navegación y edición semánticas apoyadas en LSP; el segundo organiza relaciones del código en un grafo que sus herramientas MCP pueden consultar. Las cifras de cobertura y herramientas citadas son declaraciones de sus respectivos editores. Las fuentes no establecen una comparación medida de precisión, productividad o ahorro de tokens, así que elige según el tipo de consulta que necesitas resolver, no por una promesa de rendimiento no demostrada.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
PC Slower Than It Used to Be?Free scan - under a minute
Outdated Drivers Are Slowing You DownFree scan - exact matches

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.