Para usuarios de Claude Desktop

Claude Desktop no ve tu repo. Dale uno.

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.

Empieza gratis Leer la configuración de Claude Desktop

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

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

Lo que necesitas saber de Claude Desktop

Cuatro datos propios de Claude Desktop.

// archivo de configuración

claude_desktop_config.json

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

// transporte

El bridge local

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

// clave

Una entrada env

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

// reinicio

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.

// workflow 01

Explicar una ruta de código durante una revisión

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.

// workflow 02

Dimensionar un cambio antes de planearlo

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.

// step 01

Indexa un repo en maguyva.ai

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

// step 02

Agrega Maguyva a claude_desktop_config.json

claude_desktop_config.json

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

// step 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).