Per gli utenti di Cline

Cline pianifica prima di agire. Dai una mappa al piano.

Cline legge file, esegue comandi e chiede prima di cambiare qualsiasi cosa. Maguyva indicizza l’intero repo e lo restituisce via MCP, così la modalità Plan parte da punti di chiamata reali invece che da un elenco di directory.

Inizia gratis Leggi la configurazione per Cline

Piano Free: 3 repository, Fino a 50K righe di repository indicizzate, senza carta di credito.

.clinerules per come lavorare. Maguyva per ciò che dice il codice adesso.

Cosa sapere su Cline

Quattro fatti specifici di Cline.

// file di configurazione

cline_mcp_settings.json

Aprilo dall’icona MCP Servers nel pannello di Cline: scheda Configure, poi Configure MCP Servers. I server stanno sotto mcpServers.

// trasporto

Remoto, via URL

Cline si collega all’endpoint di Maguyva in Streamable HTTP. Nessun processo locale, niente Node.js.

// chiave

Un header letterale

La chiave va direttamente nell’header Authorization, come negli esempi di Cline stesso. Il file delle impostazioni sta nello storage utente del tuo editor, non nel tuo repo.

// tipo

streamableHttp, non SSE

Lascia "type": "streamableHttp" nella voce: senza tipo, Cline presume il vecchio SSE. Elenca in autoApprove gli strumenti di cui ti fidi per saltare la loro richiesta di approvazione.

Le regole di Cline sono un accordo di lavoro. Usale.

# .clinerules/testing.md
- Esegui la suite di test prima di segnare un’attività come completata.
- Chiedi prima di aggiungere una dipendenza.

Le regole del workspace sono file Markdown in .clinerules/ o .cline/rules/; Cline legge anche AGENTS.md, .cursorrules e .windsurfrules. Le regole sono il posto giusto per:

I comandi che Cline deve eseguire.
Paletti limitati a un percorso con un glob nel frontmatter.
Convenzioni del team che sei stanco di ripetere.

Le regole dicono a Cline come comportarsi. Non gli dicono quali servizi leggono la tabella che sta per migrare.

Dove regole e lettura dei file non bastano

Tre lacune che Cline colma leggendo altri file, una richiesta alla volta.

// un piano costruito su un elenco

La modalità Plan ragiona su ciò che Cline ha letto finora. In un repo grande è un albero di directory e una manciata di file, e il piano ne eredita le lacune.

// ogni lettura è un andata e ritorno

Ogni file che Cline apre per orientarsi costa token e una richiesta al modello. Orientarsi in un pacchetto sconosciuto può consumare buona parte della finestra di contesto prima della prima modifica.

// la ricerca testuale trova stringhe, non chiamanti

“Chi altro chiama questa funzione?” è una domanda da grafo. Una ricerca testuale trova la stringa, ma non distingue i chiamanti reali da un commento, un mock o un metodo con lo stesso nome.

Maguyva come server MCP in Cline

Una voce in mcpServers dà a Cline:

11 strumenti sul tuo repo indicizzato ricerca semantica, strutturale (AST), a grafo e testuale, più ricerca dei simboli, dipendenti e recupero file.
Risposte con percorsi file e numeri di riga su oltre 285 linguaggi, così un piano cita file reali.
Strumenti che leggono e basta Gli strumenti di Maguyva interrogano l’indice. Nessuno modifica i tuoi file.

Le regole di Cline gli dicono come lavorare.
Maguyva dà a Cline una mappa su cui pianificare.

Due flussi di lavoro

Pianifica sulla mappa, poi agisci.

// workflow 01

Pianificare una modifica dai punti di chiamata reali

cline plan> sposta il refresh della sessione nel pacchetto auth

dependency_search("refreshSession", dependents)
  src/api/middleware.ts:58
  src/jobs/renew.ts:12
  src/web/hooks/useSession.ts:30

→ Il piano elenca tre punti di chiamata prima che parta la modalità Act.
[exit 0]

Il piano nomina ogni file che toccherà, così approvi un elenco, non un’intuizione.

// workflow 02

Trovare l’implementazione reale, non la fixture di test

cline> come calcoliamo il pro rata?

semantic_search("proration calculation")
  src/billing/proration.ts:22   prorate()   ← implementazione
  test/billing/proration.spec.ts:7   ← fixture

→ Cline legge un file invece di sei.
[exit 0]

I risultati classificati mettono l’implementazione sopra la fixture che ha lo stesso nome.

Configurazione in Cline

Tre passaggi. Piano Free: 3 repository, Fino a 50K righe di repository indicizzate, senza carta di credito.

// step 01

Indicizza un repo su maguyva.ai

Scegline uno che già conosci, così puoi valutare le risposte.

// step 02

Aggiungi Maguyva alle impostazioni MCP di Cline

cline_mcp_settings.json

{
  "mcpServers": {
    "maguyva": {
      "type": "streamableHttp",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

// step 03

Sostituisci il segnaposto e fai una domanda

Sostituisci mgv_xxxx con la tua chiave API e salva il file. Fai una domanda di cui conosci già la risposta, poi apri il file citato.