Vai al contenuto

Avvio rapido

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 — nessuna carta di credito richiesta. La tua chiave API (inizia con mgv_) si trova in 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: 

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

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:

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:

.cursor/mcp.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.

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». Se la configurazione usa il bridge, verifica anche che npx sia disponibile.

Prossimi passi

#

Correlati

Da leggere