# MCP Memoria de Código

> Servidor MCP remoto que convierte los repositorios del usuario (GitHub/GitLab) en un grafo de conocimiento (símbolos, llamadas, imports) para que una IA entienda y modifique código gastando muchos menos tokens que leyendo archivos.

- Endpoint MCP (Streamable HTTP, OAuth 2.1 + PKCE): https://mcp-codebase.ecortes.cl/mcp
- Panel web: https://mcp-codebase.ecortes.cl/login
- Guía completa para IA: https://mcp-codebase.ecortes.cl/llms-full.txt

## Herramientas
- `codigo_listar_proyectos`: Lista tus proyectos (repositorios indexados) con estado, commit, tamaño del grafo y lenguajes.
- `codigo_indexar` (escribe en el índice): Clona el repositorio en el servidor y reconstruye su grafo de conocimiento (símbolos, llamadas, imports).
- `codigo_estado_indexado`: Estado del indexado de un proyecto: pendiente / indexando / listo / error, commit indexado, cuándo y tamaño del grafo.
- `codigo_arquitectura`: Resumen de arquitectura en una sola llamada: conteos, directorios principales, símbolos más usados (fan-in), más complejos (fan-out), puntos de entrada probables, archivos más importados y dependencias entre directorios.
- `codigo_arbol`: Lista archivos bajo un prefijo de ruta con su lenguaje, líneas y número de símbolos.
- `codigo_buscar_simbolos`: Búsqueda estructural en el grafo: por nombre (parcial, con comodín `*`, o palabras), etiqueta (Function, Method, Class, Interface, Struct, Enum, Type), archivo y grado (in = cuántos lo llaman, out = a cuántos llama).
- `codigo_buscar_texto`: Busca texto o regex en el código indexado (sin clonar).
- `codigo_obtener_simbolo`: Devuelve el código fuente de UN símbolo (función, método, clase…) con su firma, quién lo llama y a quién llama.
- `codigo_leer_archivo`: Lee un rango de líneas de un archivo del índice (sin clonar).
- `codigo_trazar_llamadas`: Recorre el grafo de llamadas desde un símbolo: `entrantes` = quién lo llama (transitivo), `salientes` = a quién llama.
- `codigo_impacto`: Radio de impacto de un cambio: dado un símbolo o una lista de archivos modificados, devuelve los símbolos que los llaman (transitivo) y los archivos que los importan.
- `codigo_adr` (escribe en el índice): Notas de arquitectura (ADR) por proyecto: decisiones, convenciones y hallazgos para no redescubrirlos en cada sesión.
- `codigo_webhook` (escribe en el índice): Gestiona el webhook de push de un proyecto en GitHub/GitLab usando el token de su fuente: `configurar` lo crea o lo actualiza (idempotente) para que el repo se reindexe solo en cada push; `estado` comprueba si existe; `quitar` lo elimina.
- `codigo_repositorios_disponibles`: Lista los repositorios a los que tienen acceso tus fuentes git (GitHub/GitLab enlazadas en el panel) y marca cuáles ya están indexados.
- `codigo_asegurar_proyecto` (escribe en el índice): PUNTO DE ENTRADA AUTOMÁTICO.

## Configuración y skills (públicos, sin iniciar sesión)
- [Guía de configuración por cliente](https://mcp-codebase.ecortes.cl/llms-setup.txt): cómo conectar este MCP en Claude, ChatGPT, Cursor, VS Code o Claude Code, y cómo verificarlo.
- [Guía completa](https://mcp-codebase.ecortes.cl/llms-full.txt): cada herramienta con sus parámetros, recetas, errores y límites.
- [Skill principal (SKILL.md)](https://mcp-codebase.ecortes.cl/skills/memoria-de-codigo/SKILL.md): instalable en Claude Code.
- [Índice de skills (JSON)](https://mcp-codebase.ecortes.cl/skills/index.json): todas las recetas, cada una instalable por separado.
- [Bloque para CLAUDE.md / AGENTS.md / reglas de Cursor](https://mcp-codebase.ecortes.cl/agents.md): hace que la IA use el grafo sola.

## Reglas esenciales
- Empieza con codigo_asegurar_proyecto {repo: <git remote get-url origin>} (agrega e indexa solo) → codigo_arquitectura.
- Antes de abrir un archivo entero usa codigo_buscar_simbolos y codigo_obtener_simbolo.
- El grafo es estático y aproximado (confianza 0–1 por arista): confirma lo crítico leyendo el símbolo.
- Nunca pidas tokens de GitHub/GitLab por el chat: el usuario los enlaza en el panel.