# Claude Desktop no ve tu repo. Dale uno.

Canonical source: https://maguyva.ai/es/for-claude-desktop

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

En Claude Desktop mucha gente pregunta por código que no está editando en ese momento: revisiones, onboarding, llamadas de incidentes. Maguyva indexa el repo y lo sirve vía MCP, así las respuestas citan archivos y líneas en lugar de memoria.

> No hace falta checkout. Pregúntale al índice.

## Lo que necesitas saber de Claude Desktop

Cuatro datos propios de Claude Desktop.

### claude_desktop_config.json

Settings → Developer → Edit Config lo abre. En macOS está en `~/Library/Application Support/Claude/`; en Windows, en `%APPDATA%\Claude\`.

### El bridge local

Este archivo inicia procesos locales, así que esta guía ejecuta `@maguyva/mcp` con `npx`. Necesitas Node.js instalado.

### Una entrada env

El bridge lee `MAGUYVA_API_KEY` del bloque `env` del servidor, en el mismo archivo.

### Cierra y vuelve a abrir

Claude Desktop lee el archivo al arrancar. Cierra la app por completo después de editarlo; el servidor arranca en el siguiente inicio.

## Las instrucciones del proyecto marcan el encargo. Úsalas.

Los Projects de Claude guardan instrucciones y archivos con los que empieza cada chat del proyecto. Son el lugar indicado para:

- Para quién son las respuestas: un revisor, alguien recién llegado, un ingeniero de guardia.
- El estilo de la casa para explicaciones y resúmenes.
- Algunos documentos que quieres que se citen, como una visión general de la arquitectura.

Los archivos subidos son una instantánea. El repo ya avanzó al día siguiente de que los subiste.

## Donde el código pegado se queda corto

Tres formas en que una conversación sobre código sale mal sin el código.

### // los fragmentos pegados envejecen

Un archivo pegado en el chat la semana pasada describe el código de la semana pasada. Claude responde con seguridad a partir de la versión que le dieron.

### // el fragmento no es el sistema

Un solo archivo rara vez responde “¿qué pasa cuando esto falla?” El handler, el reintento y la alerta suelen vivir en tres paquetes distintos.

### // sin checkout no hay grep

Claude Desktop no tiene una copia de trabajo de tu repo. Sin una herramienta, cada respuesta sobre la estructura depende de lo que recordaste pegar.

## Maguyva como servidor MCP en Claude Desktop

Una entrada en mcpServers le da a Claude:

- **11 herramientas sobre tu repo indexado**: búsqueda semántica, estructural (AST), de grafo y de texto, además de búsqueda de símbolos, dependientes y recuperación de archivos.
- **Respuestas con rutas de archivo y números de línea**: en 285+ lenguajes, así puedes comprobar cada afirmación.
- **Resultados que tienen en cuenta la rama**: así Claude responde sobre la rama que indicas, no sobre un archivo que alguien subió el mes pasado.

> Las instrucciones del proyecto le dicen a Claude *cómo responder*.
> Maguyva le da a Claude *el código del que sacar la respuesta*.

## Dos flujos de trabajo

Preguntas que de otro modo responderías abriendo un IDE.

### 01. Explicar una ruta de código durante una revisión

```text
claude> ¿qué pasa cuando un webhook de pago no pasa la verificación de firma?

semantic_search("webhook signature verification failure")
  src/payments/webhooks.ts:64   verifySignature()
  src/payments/webhooks.ts:91   rejectAndAlert()

→ Claude responde citando ambas líneas.
[exit 0]
```

Cada paso de la respuesta apunta a un archivo y una línea que puedes abrir.

### 02. Dimensionar un cambio antes de planearlo

```text
claude> ¿cuántos lugares leen el campo heredado plan_code?

text_pattern_search("plan_code")
  14 coincidencias en 9 archivos
dependency_search("getPlanCode", dependents)
  6 llamadores

→ La estimación parte de un número, no de una suposición.
[exit 0]
```

Útil en una reunión de planificación, cuando nadie tiene el repo abierto.

## Configuración en Claude Desktop

Tres pasos. Nivel Free: 3 repositorios, Hasta 50 mil líneas de repo indexadas, sin tarjeta.

### 01. Indexa un repo en maguyva.ai

Elige uno que ya conozcas, así puedes evaluar las respuestas.

### 02. Agrega Maguyva a claude_desktop_config.json

`claude_desktop_config.json`

```json
{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "@maguyva/mcp"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}
```

### 03. Reemplaza el marcador, reinicia y haz una pregunta

Cambia `mgv_xxxx` por tu clave de API, cierra Claude Desktop por completo y vuelve a abrirlo. Si el servidor no aparece, revisa `mcp-server-maguyva.log` en la carpeta de logs de Claude (`~/Library/Logs/Claude` en macOS).

La [guía de MCP sobre servidores locales](https://modelcontextprotocol.io/docs/develop/connect-local-servers) explica con más detalle el archivo de configuración y sus logs.

## Indexa un repo que ya conozcas.

Conecta Claude Desktop vía MCP y haz una pregunta que puedas comprobar.