# Guía de instalación

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

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

Ponte en marcha en menos de 5 minutos. Esta guía incluye la configuración para 23 clientes MCP, entre ellos Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex CLI, GitHub Copilot CLI, Gemini CLI, Cline, Goose, Continue, LM Studio, Kiro CLI, JetBrains, Zed, Trae, OpenCode, BoltAI, LibreChat, Antigravity, Claude Cowork, ChatGPT, y Warp, y más.

**Requisitos previos**: necesitarás una clave de API de [app.maguyva.ai](https://app.maguyva.ai) y un repositorio de GitHub conectado.

## Configuración del entorno

Primero, configura la clave de API en una variable de entorno. Omite `repository` cuando el cliente MCP proporcione un valor predeterminado para la solicitud o la clave pueda acceder exactamente a un repositorio; de lo contrario, pásalo explícitamente.

### macOS/Linux (Bash/Zsh)

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

### Windows (PowerShell)

```powershell
'$Env:MAGUYVA_API_KEY="mgv_xxxx"' | Out-File -Append $PROFILE
. $PROFILE
```

Reemplaza `mgv_xxxx` con tu clave de API real de [app.maguyva.ai](https://app.maguyva.ai).

## Configuración del cliente

Elige tu cliente MCP abajo para ver instrucciones de configuración específicas.

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

Maguyva usa el estándar MCP. Cualquier cliente que soporte el protocolo puede conectarse, incluso si no hay una guía propia arriba. 23 clientes documentados, y se agregan más con regularidad.

## Valida tu configuración

Después de conectar, prueba a hacerle a tu agente algunas preguntas:

- "¿Qué repositorios tengo conectados?" — verifica que la conexión funcione
- "¿Cómo se maneja la autenticación en este código?" — pone a prueba la búsqueda semántica
- "Encuentra todas las funciones que llaman a la base de datos" — pone a prueba la búsqueda de dependencias
- "¿De qué depende la clase UserService?" — pone a prueba la búsqueda de símbolos

Deberías ver resultados con rutas de archivo y números de línea de tu repositorio conectado. Si no es así, revisa la sección de [troubleshooting](https://maguyva.ai/es/docs/troubleshooting) más abajo.

## Formato del repositorio

Al especificar repositorios:

- Con rama: `"owner/repo:branch"` (e.g. `"owner/repository:develop"`)
- Rama predeterminada: `"owner/repo"`

**Consejo**: usa `repository_context(action="info", repository="...")` para comprobar la resolución del repositorio. Una selección explícita que sustituye al repositorio predeterminado solo afecta a la llamada actual.

## Solución de problemas

### Problemas con la clave de API

- Verifica que tu clave empiece con el prefijo mgv_
- Comprueba que la clave esté correctamente configurada en tu entorno
- Asegúrate de que la clave no haya expirado

### Repositorio no encontrado

- Verifica que el repositorio esté conectado en app.maguyva.ai
- Comprueba que el formato owner/repo sea correcto
- Asegúrate de tener acceso al repositorio

### Problemas de conexión MCP

- Si tu cliente utiliza el bridge @maguyva/mcp, comprueba que npx esté disponible en tu PATH
- Comprueba que tu token de API sea válido y no haya expirado
- Prueba la conectividad con https://maguyva.tools/mcp
- Revisa la sintaxis de configuración MCP de tu cliente

## Próximos pasos

- Referencia de la API MCP: Documentación completa de la API
- Cómo funciona: Entiende la optimización de contexto
- Solución de problemas: Resuelve problemas de instalación y conexión