Pour les utilisateurs de Cline

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

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.

Commencer gratuitement Voir la configuration Cline

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

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

// fichier de config

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.

// transport

Distant, par URL

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

// clé

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.

// type

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.

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

// workflow 01

Planifier un changement à partir des vrais sites d’appel

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.

// workflow 02

Trouver la vraie implémentation, pas la fixture de test

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.

// step 01

Indexez un dépôt sur maguyva.ai

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

// step 02

Ajoutez Maguyva aux paramètres MCP de Cline

cline_mcp_settings.json

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

// step 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é.