Saltar al contenido

Guía rápida

El camino más rápido de cero a una respuesta verificada: consigue una clave, indexa un repositorio que ya conozcas, conecta tu cliente y haz una pregunta que ya puedas evaluar tú mismo.

1. Consigue una clave de API#

Empieza gratis — no se requiere tarjeta de crédito. Tu clave de API (empieza con mgv_) está en app.maguyva.ai.

2. Indexa un repositorio que ya conozcas#

Conecta un repositorio de GitHub desde el portal y déjalo indexar. Elige un repo pequeño que puedas verificar rápido — así queda claro si Maguyva está fundamentando al modelo, en lugar de intentar indexar toda tu empresa el primer día.

3. Conecta tu cliente#

Para Claude Code, instala el plugin de Maguyva desde el marketplace — ejecuta cada comando dentro de Claude Code:

/plugin marketplace add maguyva/claude-code-plugin
/plugin install maguyva@maguyva

El plugin se autentica con tu clave desde la variable de entorno MAGUYVA_API_KEY. Configúrala en tu shell (se recomienda direnv por proyecto, ya que las claves tienen alcance por repositorio):

export MAGUYVA_API_KEY=mgv_xxxx

¿Trabajas en equipo? Agrega --scope project a ambos comandos /plugin para confirmar el plugin en el .claude/settings.json del repositorio, así tus compañeros lo reciben automáticamente.

La mayoría de los demás clientes (Cursor, VS Code, Windsurf, Zed y compañía) se conectan directo al servidor remoto — apúntalos al endpoint con un encabezado Bearer, sin necesidad de puente. Por ejemplo, el .cursor/mcp.json de Cursor:

.cursor/mcp.json
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

La estructura varía un poco según el cliente (VS Code anida bajo servers con type: "http", Windsurf usa serverUrl, Zed usa context_servers). Reemplaza mgv_xxxx con tu clave de API y reinicia tu cliente. La configuración exacta para los 24 clientes documentados está en la Guía de instalación.

4. Haz una pregunta que ya puedas evaluar#

Empieza con "¿Qué repositorios tengo conectados?" para confirmar la conexión, y luego haz una pregunta real sobre tu repo cuya respuesta ya conozcas — algo como "¿Cómo se maneja la autenticación en este codebase?"

Deberías recibir respuestas con rutas de archivo y números de línea. Abre los archivos citados y comprueba que la respuesta sobrevive al contacto con el repo real. Esa única respuesta evaluada te dice más que cualquier lista de funciones — haz que la herramienta se gane tu confianza antes de sumarla a tu flujo por defecto.

¿Sin resultados o errores de conexión? Ve a Solución de problemas — la mayoría de las fallas son una clave de API sin configurar, un npx faltante o un repositorio que todavía no terminó de indexarse.

Próximos pasos#