# Guía rápida

Canonical source: https://maguyva.ai/es/docs/quickstart

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

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](https://app.maguyva.ai) — no se requiere tarjeta de crédito. Tu clave de API (empieza con `mgv_`) está en [app.maguyva.ai](https://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:

```text
/plugin marketplace add maguyva/agent-plugins
/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):

```bash
export MAGUYVA_API_KEY="mgv_xxxx"
```

¿Trabajas en equipo? Elige el alcance project en el panel que abre `/plugin install maguyva@maguyva`. Así el plugin queda registrado en el `.claude/settings.json` del repositorio, al que haces commit; cada compañero igual ejecuta la instalación una vez. Los comandos `/plugin` dentro de la sesión no aceptan el flag `--scope`, así que para automatizarlo, ejecuta la forma de shell desde la raíz del repositorio:

```bash
claude plugin marketplace add maguyva/agent-plugins --scope project
claude plugin install maguyva@maguyva --scope project
```

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

```json
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}
```

La estructura varía un poco según el cliente (VS Code anida bajo `servers` con `type: "http"`, Antigravity usa `serverUrl`, Zed usa `context_servers`). Este ejemplo de Cursor lee tu clave desde la variable de entorno `MAGUYVA_API_KEY` que se muestra arriba; si la configuración de un cliente muestra en su lugar el marcador `mgv_xxxx`, reemplázalo con tu clave de API. Luego reinicia tu cliente. La configuración exacta para los 23 clientes documentados está en la [Guía de instalación](https://maguyva.ai/es/docs/installation).

## 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 con errores de conexión? Revisa la clave de API, la configuración del cliente y el estado de indexación del repositorio en [Solución de problemas](https://maguyva.ai/es/docs/troubleshooting). Si usas el bridge, comprueba también que `npx` esté disponible.

## Próximos pasos

- Guía de instalación: configuración por cliente para los 23 clientes documentados
- Cómo funciona: qué pasa entre tu pregunta y la respuesta
- Referencia de la API de MCP: cada herramienta, parámetro por parámetro