Comment installer et utiliser Augment Context Engine MCP

Environ 4 min

Comment installer et utiliser Augment Context Engine MCP

Le Context Engine MCP d’Augment connecte une recherche de code de qualité entreprise aux agents IA modernes. Une fois le serveur Model Context Protocol (MCP) lancé localement, des outils tels que Cursor, Claude Code, Zed ou GitHub Copilot peuvent interroger Augment pour une récupération précise du code, maintenant ainsi votre assistant ancré dans le projet réel. Ce guide détaille l’installation, la configuration et l’utilisation quotidienne afin que vous puissiez commencer à livrer des fonctionnalités plus rapidement.

Pourquoi choisir Augment Context Engine MCP ?

Connaissance approfondie du projet – Augment construit un index de recherche multi-dépôts, donc des requêtes comme « Où initialisons-nous Stripe ? » retournent instantanément les bons fichiers.
Compatibilité MCP – Tout client compatible MCP (Cursor, Claude Desktop, Gemini CLI, etc.) peut appeler le même serveur. Aucune extension supplémentaire requise.
Flux d’authentification sécurisé – Vous pouvez vous fier à la session login du CLI Auggie ou injecter un token d’accès scoped via AUGMENT_SESSION_AUTH.
Outils multiplateformes – Fonctionne sur macOS, Windows et Linux. Le serveur communique via stdio, ce qui le rend indépendant de l’éditeur.

Prérequis

Node.js 18+ pour pouvoir installer le CLI Auggie (npm ou npx).
Compte Augment avec accès à Context Engine. Inscrivez-vous sur Augment et vérifiez votre espace de travail.
Client MCP supporté tel que Cursor, Claude Code/Desktop, Zed, ou GitHub Copilot.

Étape 1 : Installer le CLI Auggie

Augment fournit le serveur MCP dans le CLI Auggie. Installez le package pré-release globalement :

npm install -g @augmentcode/auggie@prerelease

Vérifiez l’installation :

auggie --version

Garder le CLI à jour vous garantit de recevoir les améliorations du protocole et les nouveaux outils de récupération.

Étape 2 : Authentifiez-vous auprès d’Augment

Connectez-vous via votre navigateur pour que le CLI puisse émettre des requêtes signées :

auggie login

Cette commande ouvre une fenêtre OAuth Augment. Une fois authentifié, le CLI stocke une session locale que le serveur MCP réutilisera. Pour un usage CI, exportez plutôt un token :

auggie token print
export AUGMENT_SESSION_AUTH='{"accessToken":"...","tenantURL":"https://tenant.augmentcode.com","scopes":["read","write"]}'

Astuce : Ne validez jamais vos tokens dans git. Préférez les exports dans le terminal, fichiers .env ajoutés à .gitignore, ou des gestionnaires de secrets.

Étape 3 : Démarrez le serveur MCP

Le CLI Auggie dispose d’un mode context engine :

auggie --mcp -m default -w "${WORKSPACE_FOLDER_PATHS%%,*}"

-m default sélectionne votre profil modèle Augment.
-w pointe vers le premier dossier de workspace pour que le serveur puisse refléter l’arborescence de votre projet.

Quand un client se connecte via MCP, Auggie indexe les fichiers de façon incrémentale et propose des outils comme codebase-retrieval ou query_codebase.

Étape 4 : Configurez votre client MCP

Cursor IDE

Ouvrez Settings › Tools & MCP → New MCP Server.
Collez l’extrait JSON correspondant à votre OS :

macOS / Linux (bash) :

{
  "mcpServers": {
    "augment-context-engine": {
      "type": "local",
      "command": "bash",
      "args": ["-c", "auggie --mcp -m default -w \"${WORKSPACE_FOLDER_PATHS%%,*}\""] ,
      "enabled": true
    }
  }
}

Windows (PowerShell) :

{
  "mcpServers": {
    "augment-context-engine": {
      "type": "local",
      "command": "powershell",
      "args": ["-Command", "auggie --mcp -m default -w \"($env:WORKSPACE_FOLDER_PATHS -split ',')[0]\""],
      "enabled": true
    }
  }
}

Redémarrez Cursor. Vous devriez maintenant voir codebase-retrieval dans la palette d’outils MCP.

Claude Code / Claude Desktop

Modifiez la config de Claude (macOS : ~/Library/Application Support/Claude/claude_desktop_config.json, Windows : %APPDATA%/Claude/claude_desktop_config.json).
Ajoutez l’entrée serveur Augment :

{
  "mcpServers": {
    "augment-context-engine": {
      "command": "npx",
      "args": ["-y", "auggie-context-mcp@latest"],
      "env": {
        "AUGMENT_SESSION_AUTH": "{\"accessToken\":\"your-token\",\"tenantURL\":\"https://...\"}"
      }
    }
  }
}

Redémarrez Claude Desktop pour charger le nouveau jeu d’outils MCP.

Racine workspace : Claude Code a besoin du chemin racine du dépôt pour que le serveur indexe les bons fichiers. Configurez-le sous Claude Code Settings › Workspace Root dans l’IDE.

Étape 5 : Testez l’intégration

Dans votre IDE compatible MCP, lancez une simple requête de récupération :

"Que fait ce projet ? Merci d’utiliser l’outil codebase retrieval."

L’agent devrait invoquer codebase-retrieval, diffuser des extraits riches en contexte, et répondre avec des citations. Si l’outil manque, vérifiez la sortie CLI pour des erreurs telles que :

Auggie CLI not found → assurez-vous que le binaire est dans le PATH.
Authentication required → relancez auggie login ou rafraîchissez votre token.
Query timed out → la première indexation peut prendre plus de temps sur les gros monorepos ; retentez une fois indexation terminée.

Astuces pour l’usage quotidien

Posez des questions précises. Plutôt que « Où est l’auth ? », demandez « Montre-moi le middleware qui valide les JWT » pour limiter le bruit.
Chaînez les outils. Cursor et Claude peuvent invoquer successivement codebase-retrieval, codebase-search et d’autres outils MCP, vous donnant une réponse itérative.
Projets multi-dépôts. Utilisez plusieurs flags -w ou dossiers workspace quand vous développez des microservices pour que Augment cartographie les références inter-services.
Mode hors-ligne. En cas de perte de connexion, le CLI sert toujours les index en cache, mais les réponses peuvent ne pas inclure les changements récents distants. Lancez git pull et redémarrez le serveur quand vous retrouvez le réseau.

Quelle est la qualité d’Augment Context Engine MCP ?

Précision : Augment se concentre sur les workflows développeur, donc le classement favorise les graphes d’appel, tests et docs pertinents à votre requête.
Rapidité : Le serveur MCP stream les tokens au client quasi instantanément, et les requêtes suivantes réutilisent le cache chaud.
Sécurité : Les tokens d’auth restent locaux, et le transport stdio signifie que vous contrôlez l’environnement d’exécution. Pour les équipes, Augment Enterprise propose politiques organisationnelles et logs d’audit.
Limites : Le moteur dépend du backend managé Augment, vous nécessitez donc un abonnement actif et un accès réseau. De plus, comme il indexe localement, le premier lancement sur de très grands monorepos peut prendre plusieurs minutes.

Comparé aux embeddings DIY ou récupérateurs open-source, Augment fait gagner du temps d’installation et s’intègre d’emblée aux agents IDE majeurs. Si vous utilisez déjà Cursor ou Claude, la voie MCP paraît naturelle.

Liste de vérification dépannage

Symptôme	Cause probable	Solution
Serveur MCP non visible	JSON mal configuré	Validez les virgules/guillemets, redémarrez le client
`Auggie CLI not found`	Problème PATH	Réinstallez le CLI ou ajoutez le bin npm global au PATH
Erreur d’authentification	Session expirée	`auggie login` ou rafraîchissez `AUGMENT_SESSION_AUTH`
Outil manquant dans l’IDE	Workspace incorrect	Confirmez que `-w` pointe vers le dépôt actif
Requêtes lentes	Indexation initiale	Laissez le CLI tourner jusqu'à la fin de l’indexation

Conclusion

Le Context Engine MCP d’Augment offre aux agents IA en codage un accès fiable à votre base de code réelle. En quelques commandes terminal—installation d’Auggie, connexion, collage de la config MCP—vous bénéficiez d’une récupération précise, de revues plus rapides, et de code moins hallucinatoire. Gardez le serveur actif à côté de votre IDE et traitez-le comme tout autre service de développement : mettez à jour régulièrement, surveillez les logs, et sécurisez vos tokens.

Besoin d’une infrastructure fiable pour héberger vos expérimentations MCP, services auxiliaires ou environnements de démo ? Découvrez les noeuds globaux abordables LightNode via ce lien et déployez un VPS en quelques minutes.