# Preguntas frecuentes de Graph Indexer

> Respuestas sobre Graph Indexer: qué es, en qué se diferencia de grep, privacidad, coste, velocidad, lenguajes, monorepos y agentes, Node 22.5+ y MIT.

Esta página responde a las preguntas que más se hacen los desarrolladores sobre Graph Indexer, un grafo de código y buscador local al que los agentes de IA llaman por MCP. Cada respuesta se entiende por sí sola y enlaza a la página con el detalle completo.

Para empezar, mira [Instalar Graph Indexer](/es/install/); para la mecánica, [Cómo funciona Graph Indexer](/es/how-it-works/); y para las mediciones, los [benchmarks](/es/benchmarks/) y la comparativa [Graph Indexer vs grep](/es/graph-indexer-vs-grep/). Las ocho herramientas están en la [página de herramientas](/es/tools/) y los lenguajes soportados en la [página de lenguajes](/es/languages/).

## Preguntas frecuentes

### ¿Qué es Graph Indexer?

Graph Indexer es un grafo de código y buscador gratuito, con licencia MIT, para agentes de IA que programan, servido en local por MCP. Analiza tu repositorio con tree-sitter y responde con exactitud sobre referencias, llamadores, impacto de cambios y ediciones, en respuestas pequeñas.

### ¿Qué es MCP y por qué lo usa Graph Indexer?

MCP, el Model Context Protocol, es el estándar abierto con el que los agentes de IA llaman a herramientas externas. Graph Indexer funciona como servidor MCP por stdio, así que cualquier agente compatible puede llamar a sus ocho herramientas de solo lectura sin un plugin propio.

### ¿En qué se diferencia Graph Indexer de grep?

Grep compara texto; Graph Indexer enlaza cada referencia con la definición a la que apunta. Con 400 símbolos de nestjs contrastados con el compilador de TypeScript, find_references logró un 99,7 % de precisión y un 96,2 % de recall, y grep del nombre un 12,8 % de precisión.

### ¿Graph Indexer usa embeddings o un modelo de lenguaje?

No. La búsqueda es léxica más grafo: BM25 sobre nombres, firmas, documentación y cuerpos, un pequeño tesauro de conceptos y centralidad PageRank. No necesita modelo, embeddings, descargas ni red.

### ¿Qué lenguajes de programación soporta Graph Indexer?

Dieciséis gramáticas tree-sitter incluidas: JavaScript, TypeScript, TSX, Python, Go, Java, Kotlin, Scala, C#, Rust, C, C++, Ruby, PHP, Bash y CSS. El enlace es más profundo en TypeScript, JavaScript, Python, Go, Java, C# y Rust. Los detalles están en la página de lenguajes.

### ¿Graph Indexer envía mi código a algún sitio?

El propio Graph Indexer no hace llamadas de red ni envía telemetría; habla con el agente solo por stdio y nunca lee fuera del repositorio. El agente sigue enviando lo que lee, incluidas las respuestas de Graph Indexer, a su proveedor de modelo.

### ¿Graph Indexer es gratis? ¿Cuánto cuesta?

Graph Indexer es gratuito y de código abierto con licencia MIT, sin cuenta ni clave de API. El único coste es el uso de modelo de tu agente, que tiende a bajar: en sesiones reales de Claude Code, las preguntas sobre código cuestan un 16 % menos.

### ¿Qué velocidad tiene Graph Indexer?

Indexar entero nestjs, con 1.641 archivos y 96.000 líneas, tarda 3,7 segundos. Después solo se vuelven a analizar los archivos cambiados. Las llamadas en caliente a las herramientas de grafo tardan de 1 a 4 ms, la búsqueda unos 30 ms y los hooks o la CLI responden en unos 0,1 segundos.

### ¿Graph Indexer funciona en monorepos grandes?

Sí. Indexó el monorepo del CRM Twenty, con 28.512 archivos y unos 2,3 millones de líneas, en 51 segundos, y lo resincronizó sin cambios en 1,8 segundos. Contra el compilador de TypeScript, en su paquete de servidor, la precisión fue del 99,9 % y el recall del 92,4 %.

### ¿Dónde se guarda el índice y debo subirlo al repositorio?

El índice es un archivo SQLite en .graph-indexer/index.db dentro de tu repositorio. El comando init añade la carpeta a .gitignore. No lo subas ni lo compartas: contiene fragmentos de tu código, así que trátalo como el propio repositorio. Borrarlo es seguro.

### ¿Puede el índice quedarse desactualizado?

No en el momento de responder. Graph Indexer se resincroniza con los archivos del disco antes de cada llamada a una herramienta, con un vigilante de archivos y barridos periódicos, y revalida los archivos justo antes de citar sus líneas, así que incluye ediciones de hace un segundo.

### ¿Cómo instalo el plugin de Graph Indexer para Claude Code?

Ejecuta /plugin marketplace add MaquinaTech/graph-indexer y después /plugin install graph-indexer@graph-indexer. El plugin incluye el servidor MCP, tres hooks y un subagente de solo lectura, code-structure. También puedes ejecutar npx graph-indexer init en el repositorio.

### ¿Con qué agentes de IA para programar funciona Graph Indexer?

El comando init configura Claude Code, Cursor, VS Code Copilot, Codex, Gemini CLI, OpenCode, Kilo Code, Junie, Zed y Devin. Cualquier otro cliente que pueda ejecutar un servidor MCP por stdio puede usarlo con una configuración manual.

### ¿Qué versión de Node.js necesita Graph Indexer?

Node.js 22.5 o superior, porque el índice usa el módulo integrado node:sqlite. No hay dependencias npm, ni compilaciones nativas, ni nada que compilar. Instala y conecta tus agentes con npx graph-indexer init.

### ¿Cuáles son los límites de Graph Indexer?

No es un type checker: los genéricos, la reflexión, any y la inyección de dependencias por token de texto solo se ven en parte, y Java fue el lenguaje más débil de los medidos. Arreglar incidencias reales no mostró un ahorro medible, y los benchmarks con agentes usan muestras pequeñas.

---

Actualizado: 2026-10-08 · Graph Indexer 3.0.0 · https://graph-indexer.vercel.app/es/faq/
