# Instrucciones para el agente: Codebase Memory MCP: consulta relaciones de código y documentación

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: principiante
- Proyecto: https://github.com/DeusData/codebase-memory-mcp (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/codebase-memory-mcp

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

Comprueba macOS o Linux, Bash, curl y tar, y un cliente MCP instalado. El [instalador](https://github.com/DeusData/codebase-memory-mcp/blob/main/install.sh) selecciona la arquitectura y en Linux descarga la variante estática portable; no apliques a esta ruta los requisitos glibc del binario dinámico. Consulta Windows por separado en el [README](https://github.com/DeusData/codebase-memory-mcp).

El instalador para sistemas Unix está documentado así; revisa el script antes de ejecutarlo:

```bash
curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash
```

El instalador deja el ejecutable `codebase-memory-mcp` y detecta clientes para registrar MCP, instrucciones y las integraciones compatibles. Revisa el resumen de cambios, reinicia el agente desde la raíz de un proyecto pequeño y pide «Indexa este proyecto», como indica el inicio rápido. Si usas Codex, revisa y confía los hooks instalados desde `/hooks`; el registro MCP y la confianza de hooks son pasos distintos. Para inspeccionar el grafo en navegador puedes ejecutar `codebase-memory-mcp daemon start --open --port=9749`.

## Comprobación

Elige una función conocida con al menos un llamador. Pide al agente localizarla y llamar a `trace_path` con `function_name` igual al nombre real y `direction="inbound"`, el recorrido del README. Compara el llamador y su archivo con el código; no basta con que termine la indexación.

## Si algo falla

Comprueba la arquitectura del binario, permisos de lectura y estado de la conexión MCP.