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.

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

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.

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

/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):

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:

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:

{
  "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.

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.

• 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