# Cline planifie avant d’agir. Donnez une carte au plan.

Canonical source: https://maguyva.ai/fr/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 lit des fichiers, lance des commandes et demande avant de changer quoi que ce soit. Maguyva indexe tout le dépôt et le restitue via MCP : le mode Plan part de vrais sites d’appel plutôt que d’un listing de répertoires.

> .clinerules pour la façon de travailler. Maguyva pour ce que dit le code aujourd’hui.

## Ce qu’il faut savoir sur Cline

Quatre faits propres à Cline.

### cline_mcp_settings.json

Ouvrez-le depuis l’icône MCP Servers du panneau Cline : onglet Configure, puis Configure MCP Servers. Les serveurs se placent sous `mcpServers`.

### Distant, par URL

Cline se connecte au point de terminaison de Maguyva en Streamable HTTP. Aucun processus local, pas de Node.js.

### Un en-tête en clair

La clé va directement dans l’en-tête `Authorization`, comme dans les exemples de Cline. Le fichier de réglages se trouve dans le stockage utilisateur de votre éditeur, pas dans votre dépôt.

### streamableHttp, pas SSE

Gardez `"type": "streamableHttp"` dans l’entrée : sans type, Cline suppose l’ancien SSE. Listez dans `autoApprove` les outils de confiance pour sauter leur demande d’approbation.

## Les règles Cline sont un accord de travail. Utilisez-les.

```text
# .clinerules/testing.md
- Lance la suite de tests avant de marquer une tâche comme terminée.
- Demande avant d’ajouter une dépendance.
```

Les règles d’espace de travail sont des fichiers Markdown dans `.clinerules/` ou `.cline/rules/` ; Cline lit aussi `AGENTS.md`, `.cursorrules` et `.windsurfrules`. Les règles sont le bon endroit pour :

- Les commandes que Cline doit lancer.
- Les garde-fous limités à un chemin par un glob dans le frontmatter.
- Les conventions d’équipe que vous en avez assez de répéter.

Les règles disent à Cline comment se comporter. Elles ne lui disent pas quels services lisent la table qu’il s’apprête à migrer.

## Là où les règles et la lecture de fichiers ne suffisent plus

Trois lacunes que Cline comble en lisant plus de fichiers, une requête à la fois.

### // un plan construit sur un listing

Le mode Plan raisonne à partir de ce que Cline a lu jusque-là. Sur un gros dépôt, c’est une arborescence et une poignée de fichiers, et le plan hérite des lacunes.

### // chaque lecture est un aller-retour

Chaque fichier que Cline ouvre pour s’orienter coûte des tokens et une requête au modèle. S’orienter dans un paquet inconnu peut consommer une bonne partie de la fenêtre de contexte avant la première modification.

### // la recherche textuelle trouve des chaînes, pas des appelants

“Qui d’autre appelle ça ?” est une question de graphe. Une recherche textuelle trouve la chaîne, mais ne distingue pas les vrais appelants d’un commentaire, d’un mock ou d’une méthode homonyme.

## Maguyva comme serveur MCP dans Cline

Une entrée mcpServers donne à Cline :

- **11 outils sur votre dépôt indexé**: recherche sémantique, structurelle (AST), par graphe et textuelle, plus recherche de symboles, dépendants et récupération de fichiers.
- **Des réponses avec chemins de fichiers et numéros de ligne**: sur plus de 285 langages, pour qu’un plan cite de vrais fichiers.
- **Des outils en lecture seule**: Les outils de Maguyva interrogent l’index. Aucun ne modifie vos fichiers.

> Les règles Cline disent à Cline *comment travailler*.
> Maguyva donne à Cline *une carte pour planifier*.

## Deux flux de travail

Planifiez avec la carte, puis agissez.

### 01. Planifier un changement à partir des vrais sites d’appel

```text
cline plan> déplace le rafraîchissement de session dans le paquet auth

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

→ Le plan liste trois sites d’appel avant le passage en mode Act.
[exit 0]
```

Le plan nomme chaque fichier qu’il va toucher : vous approuvez une liste, pas une intuition.

### 02. Trouver la vraie implémentation, pas la fixture de test

```text
cline> comment calcule-t-on le prorata ?

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

→ Cline lit un fichier au lieu de six.
[exit 0]
```

Les résultats classés placent l’implémentation au-dessus de la fixture qui porte le même nom.

## Configuration dans Cline

Trois étapes. Palier Free : 3 dépôts, Jusqu'à 50 000 lignes de dépôt indexées, sans carte bancaire.

### 01. Indexez un dépôt sur maguyva.ai

Choisissez-en un que vous connaissez déjà, pour pouvoir évaluer les réponses.

### 02. Ajoutez Maguyva aux paramètres MCP de Cline

`cline_mcp_settings.json`

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

### 03. Remplacez le placeholder et posez une question

Remplacez `mgv_xxxx` par votre clé API et enregistrez le fichier. Posez une question dont vous connaissez déjà la réponse, puis ouvrez le fichier cité.

La [documentation MCP](https://docs.cline.bot/mcp/mcp-overview) de Cline couvre les serveurs distants, les délais et l’approbation automatique.

## Indexez un dépôt que vous connaissez déjà.

Connectez Cline via MCP, puis posez une question que vous pouvez vérifier.