# Avvio rapido

Canonical source: https://maguyva.ai/it/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).

Il percorso più rapido da zero a una risposta verificata: ottieni una chiave, indicizza un repository che già conosci, collega il tuo client e fai una domanda di cui conosci già la risposta.

## 1. Ottieni una chiave API

[Inizia gratis](https://app.maguyva.ai) — nessuna carta di credito richiesta. La tua chiave API (inizia con `mgv_`) si trova in [app.maguyva.ai](https://app.maguyva.ai).

## 2. Indicizza un repository che già conosci

Collega un repository GitHub dal portale e lascia che venga indicizzato. Scegli un repository piccolo che puoi verificare rapidamente: così è subito chiaro se Maguyva aiuta il modello a basarsi sul codice reale, senza provare a indicizzare tutta l'azienda il primo giorno.

## 3. Collega il tuo client

Per Claude Code, installa il plugin Maguyva dal marketplace — esegui ogni comando dentro Claude Code:

```text
/plugin marketplace add maguyva/agent-plugins
/plugin install maguyva@maguyva
```

Il plugin si autentica con la tua chiave dalla variabile d'ambiente `MAGUYVA_API_KEY`. Impostala nella tua shell (`direnv` per-progetto è consigliato, perché le chiavi sono legate al repository):

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

Lavori in team? Scegli l'ambito project nel pannello che apre `/plugin install maguyva@maguyva`. Il plugin viene registrato nel file `.claude/settings.json` del repository, che committi; ogni collega esegue comunque l'installazione una volta. I comandi `/plugin` nella sessione non accettano il flag `--scope`, quindi per automatizzarlo esegui la forma shell dalla root del repository:

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

La maggior parte degli altri client (Cursor, VS Code, Devin Desktop, Zed e affini) si collega direttamente al server remoto — puntali all'endpoint con un header `Bearer`, senza bisogno di un bridge. Ad esempio, il `.cursor/mcp.json` di Cursor:

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

La struttura varia leggermente da client a client (VS Code annida sotto `servers` con `type: "http"`, Antigravity usa `serverUrl`, Zed usa `context_servers`). Questo esempio per Cursor legge la chiave dalla variabile d'ambiente `MAGUYVA_API_KEY` mostrata sopra; se la configurazione di un client mostra invece il segnaposto `mgv_xxxx`, sostituiscilo con la tua chiave API. Poi riavvia il client. La configurazione esatta per tutti i 23 client documentati è nella [Guida all'installazione](https://maguyva.ai/it/docs/installation).

## 4. Fai una domanda di cui conosci già la risposta

Inizia con **"Quali repository ho collegato?"** per confermare la connessione, poi fai una vera domanda sul tuo repository di cui conosci già la risposta — qualcosa come **"Come viene gestita l'autenticazione in questo codebase?"**

Dovresti ricevere risposte con percorsi dei file e numeri di riga. Apri i file citati e verifica che la risposta regga il confronto con il repository reale. Quell'unica risposta verificata ti dice più di qualsiasi elenco di funzionalità — fai in modo che lo strumento si guadagni la fiducia prima di entrare nel tuo flusso di lavoro predefinito.

Nessun risultato o errori di connessione? Controlla la chiave API, la configurazione del client e lo stato dell'indicizzazione del repository seguendo la sezione «[Risoluzione dei problemi](https://maguyva.ai/it/docs/troubleshooting)». Se la configurazione usa il bridge, verifica anche che `npx` sia disponibile.

## Prossimi passi

- Guida all'installazione: configurazione per client, per tutti i 23 client documentati
- Come funziona: cosa succede tra la tua domanda e la risposta
- Riferimento API MCP: ogni strumento, parametro per parametro