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

Canonical source: https://maguyva.ai/it/for-cline

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

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.

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

## Cosa sapere su Cline

Quattro fatti specifici di Cline.

### cline_mcp_settings.json

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

### Remoto, via URL

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

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

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

```text
# .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.

### 01. Pianificare una modifica dai punti di chiamata reali

```text
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.

### 02. Trovare l’implementazione reale, non la fixture di test

```text
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.

### 01. Indicizza un repo su maguyva.ai

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

### 02. Aggiungi Maguyva alle impostazioni MCP di Cline

`cline_mcp_settings.json`

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

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

La [documentazione MCP](https://docs.cline.bot/mcp/mcp-overview) di Cline copre server remoti, timeout e approvazione automatica.

## Indicizza un repo che già conosci.

Collega Cline via MCP, poi fai una domanda che puoi verificare.