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 sta davvero fondando il modello, invece di 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/claude-code-plugin
/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? Aggiungi --scope project a entrambi i comandi /plugin per fare il commit del plugin nel .claude/settings.json del repository, così i colleghi lo ottengono automaticamente.

La maggior parte degli altri client (Cursor, VS Code, Windsurf, 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 mgv_xxxx"
      }
    }
  }
}

La struttura varia leggermente da client a client (VS Code annida sotto servers con type: "http", Windsurf usa serverUrl, Zed usa context_servers). Sostituisci mgv_xxxx con la tua chiave API, poi riavvia il client. La configurazione esatta per tutti i 24 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? Vai su Risoluzione dei problemi — la maggior parte dei problemi è dovuta a una chiave API non impostata, a un npx mancante, o a un repository che non ha ancora finito l'indicizzazione.

Prossimi passi#