# Maguyva

Recettes courtes pour les flux de travail Maguyva MCP courants : installation d'un client, recherche avant de modifier, résultats vides et travail multi-dépôt.

[llms-full.txt — English documentation and MCP schemas](/llms-full.txt)

Markdown representation of any docs page or blog post: append `.md` to its URL (https://maguyva.ai/fr/docs/quickstart.md) or send `Accept: text/markdown`.

Release feeds: [RSS](https://maguyva.ai/fr/changelog.xml), [JSON Feed 1.1](https://maguyva.ai/fr/changelog.json).

## Capacités par langage

Voici les compteurs de capacités qui alimentent la recherche structurelle, la recherche de symboles, l’analyse tenant compte du graphe et l’indexation de base.

Ces indicateurs montrent les capacités activées dans la configuration actuelle des langages, et non des scores de qualité de bout en bout. La disponibilité du graphe nécessite l’activation d’un analyseur, de l’extraction des symboles et de l’extraction du graphe. Les types de relations pris en charge et la profondeur d’extraction varient selon le langage.

- Couverture indexée: **284**. Chaque langage listé est indexé pour le contexte fichier, texte, et dépôt.
- Recherche structurelle AST: **247**. Langages disposant d'une structure basée sur un parseur pour les workflows AST et de recherche structurelle.
- Extraction de symboles: **282**. Langages disposant de métadonnées de symboles pour les définitions et leur recherche.
- Relations du graphe: **151**. Langages dotés d’une extraction opérationnelle des relations pour la recherche tenant compte du graphe. La profondeur varie selon le langage et le type de relation.

- `ast_structural=false`: Indexation prioritairement textuelle avec une prise en compte plus limitée de la structure.
- `symbol_extraction=false`: L'extraction de symboles est limitée, la navigation s'appuie donc davantage sur le contexte de fichier et de structure.
- `relationship_extraction=false`: Ce langage est indexé pour la recherche, mais il n’est pas actuellement persisté dans le graphe de code.

[Trouvez votre langage](/llms-full.txt)

## Recettes

Recettes pratiques pour le travail quotidien Maguyva MCP. Chaque recette nomme les outils et la séquence – et non une référence complète des paramètres. Pour les paramètres d'outil, utilisez la [Référence API MCP](https://maguyva.ai/fr/docs/mcp-api). Pour une première configuration, utilisez le [Démarrage rapide](https://maguyva.ai/fr/docs/quickstart).

### Choisissez le bon outil

La plupart des questions commencent par un seul appel. N'approfondissez la recherche que si la première réponse est trop générale ou manque d'informations.

- `intelligent_search` — commencez ici pour une question en langage naturel sur la base de code. Par défaut, auto/balanced oriente les questions de définition dont l’intention est identifiée avec confiance vers la recherche structurelle, les questions de références ou d’impact vers le graphe et les recherches de correspondance exacte vers le texte. Les autres questions utilisent le sens sémantique et le texte indexé. Utilisez mode=hybrid ou auto avec quality=thorough pour solliciter les quatre modalités de recherche. Un mode explicite prend le pas sur quality.
- `find_symbol` — vous connaissez déjà le nom de la fonction, de la classe ou de la variable.
- `dependency_search` — rayon d'impact : code appelant, code dépendant ou impact avant (et après) une modification.
- `get_task_context` — zone inconnue ; un ensemble limité de fichiers, de symboles et de dépendances pour une description de tâche.
- `repository_context` – répertorie les référentiels accessibles ou inspecte la façon dont un nom de référentiel est résolu.
- `ask_maguyva` avec `operation="guidance"` — aide locale sur la sélection des outils et l'utilisation de Maguyva (pas de mutation de repo).

## Tools -- Search

- [intelligent_search](https://maguyva.ai/fr/docs/mcp-api#intelligent-search): Start here for any codebase question. Default auto/balanced routes confident definition queries to structural search, reference/impact queries to graph, and exact-match queries to text; other queries use semantic plus text.
- [semantic_search](https://maguyva.ai/fr/docs/mcp-api#semantic-search): Find code by meaning, not exact text. Use for conceptual queries like "retry logic" or "user onboarding flow" when you don't know the keyword or symbol name.
- [text_pattern_search](https://maguyva.ai/fr/docs/mcp-api#text-pattern-search): Search indexed content. Exact and regex modes grep the full file/blob corpus; fuzzy content mode searches the bounded semantic chunk corpus.

## Tools -- Structural & Graph

- [structural_search](https://maguyva.ai/fr/docs/mcp-api#structural-search): Prefer preset=functions|classes|methods|imports|variables (or free pattern=). Find code by AST shape (not text).
- [dependency_search](https://maguyva.ai/fr/docs/mcp-api#dependency-search): Primary blast-radius / graph surface. Answer "what calls this?" / "what does this use?" via the real call/import graph.

## Tools -- Code Analysis

- [find_symbol](https://maguyva.ai/fr/docs/mcp-api#find-symbol): Jump to where a function, class, or variable is defined and used. Use when you know the name (e.g. "getCurrentUser") — faster and more precise than Grep, and it spans the whole indexed repo.
- [analyze_dependencies](https://maguyva.ai/fr/docs/mcp-api#analyze-dependencies): Analyze blast radius using the same traversal as dependency_search (dependents/incoming). Prefer dependency_search with analysis_type="dependents" or "impact" for impact analysis.
- [get_task_context](https://maguyva.ai/fr/docs/mcp-api#get-task-context): Starting work in an unfamiliar area? Describe the task (e.g. "add SSO support", "fix the billing webhook") and get a bounded one-call bundle of relevant files, code, symbols, and dependencies.
- [get_file](https://maguyva.ai/fr/docs/mcp-api#get-file): Read a file from the indexed repo by path. Prefer local file tools for files on disk; use this for remote indexed snapshots.

## Tools -- Utility

- [repository_context](https://maguyva.ai/fr/docs/mcp-api#repository-context): List the repositories you can search, or get identity info on one (namespace/branch, indexed_commit_sha / index freshness). Use action:"list" when the repo slug is unknown; searches accept a known slug directly or default to your key's single repo.
- [ask_maguyva](https://maguyva.ai/fr/docs/mcp-api#ask-maguyva): Get Maguyva tool guidance, or submit a bug report / feature request stored for Maguyva's maintainers. Never include secrets or sensitive personal data in feedback.

## Prochaines étapes

- [Démarrage rapide](https://maguyva.ai/fr/docs/quickstart)
- [Guide d'installation](https://maguyva.ai/fr/docs/installation)
- [Référence API MCP](https://maguyva.ai/fr/docs/mcp-api)
- [Dépannage](https://maguyva.ai/fr/docs/troubleshooting)
- [Comment ça marche](https://maguyva.ai/fr/docs/how-it-works)
- [Compatibilité et spécifications techniques](https://maguyva.ai/fr/docs/compatibility)

## Agent integrations

- [Maguyva pour Cursor : le contexte du dépôt via MCP](https://maguyva.ai/fr/for-cursor): Cursor modifie le fichier ouvert ; Maguyva indexe tout le monorepo et le restitue via MCP — recherche sémantique, AST, par graphe et textuelle avec fichier:ligne, pour que l'agent trouve les fichiers que vous n'aviez pas épinglés.
- [Maguyva pour Windsurf : le contexte du dépôt via MCP](https://maguyva.ai/fr/for-windsurf): Windsurf et Cascade modifient le fichier ouvert ; Maguyva indexe tout le monorepo et le restitue via MCP — sémantique, AST, graphe et texte avec fichier:ligne, pour que Cascade trouve les fichiers que vous n'aviez pas mentionnés.
- [Maguyva pour Antigravity : le contexte du dépôt via MCP](https://maguyva.ai/fr/for-antigravity): Antigravity fait tourner des agents autonomes sur l'éditeur, le terminal et le navigateur ; Maguyva leur donne une carte interrogeable du monorepo via MCP — le rayon d'impact en amont, pas après que la CI passe au rouge.
- [Maguyva pour Codex : le contexte du dépôt via MCP](https://maguyva.ai/fr/for-codex): AGENTS.md est l’accord de travail. Maguyva est le serveur MCP qui donne à Codex CLI une carte interrogeable du dépôt, pour que la première modification ne soit pas une supposition.
- [Maguyva pour tout client MCP : le contexte du dépôt via MCP](https://maguyva.ai/fr/for-anything): MCP est un protocole ouvert. Maguyva est un serveur MCP standard, donc les clients compatibles MCP comme Claude Code, Codex CLI, Gemini CLI, Cursor, Windsurf, Antigravity obtiennent le même contexte de base de code ancré.
- [Maguyva pour Gemini CLI : le contexte du dépôt via MCP](https://maguyva.ai/fr/for-gemini): GEMINI.md fixe le contexte de travail ; MCP est le canal. Maguyva est le serveur MCP qui donne à Gemini CLI une carte interrogeable de votre dépôt — recherche sémantique, AST et par graphe, pour que la première modification ne soit pas une supposition.
- [Maguyva pour Claude Code : le contexte du dépôt via MCP](https://maguyva.ai/fr/for-claude-code): CLAUDE.md indique à Claude comment se comporter. Maguyva indexe le dépôt et le sert via MCP pour que Claude Code modifie à partir d’une carte interrogeable.
- [Maguyva pour GitHub Copilot CLI : contexte de code via MCP](https://maguyva.ai/fr/for-copilot): Les instructions personnalisées indiquent à Copilot comment se comporter. Maguyva indexe le dépôt et le sert via MCP pour que GitHub Copilot CLI modifie à partir d’une carte.

## Company

- [À propos de Maguyva : intelligence du code via MCP](https://maguyva.ai/fr/about): Intelligence du code pour les agents de codage : recherche sémantique, AST, par graphe et texte intégral, recherche de symboles, analyse des dépendances et contexte de tâche en un seul appel sur plus de 284 langages.
- [Rencontrez l'équipe : 2 humains + un essaim d'agents IA](https://maguyva.ai/fr/team)
- [Comment on travaille : pas de VC, pas de tarif par siège, pas de fonctionnalités verrouillées](https://maguyva.ai/fr/how): Pas de capital extérieur. Pas de tarif par siège. Vos données ne sont pas le produit. Comment Maguyva est construit et pourquoi il est tarifé comme il l'est.
- [Stack technique : PostgreSQL, Tree-sitter, MCP](https://maguyva.ai/fr/stack): La stack technique qui fait tourner Maguyva. PostgreSQL, embeddings Voyage AI, recherche vectorielle quantifiée, AST tree-sitter, et protocole MCP.
- [Changelog](https://maguyva.ai/fr/changelog): Ce qui a été livré dans Maguyva : changements produit, mises à jour de l’index et des outils MCP, et notes de développement. Les plus récentes en premier.
- [En direct : Maguyva se construit lui-même, en temps réel](https://maguyva.ai/fr/live): Pas de démo en boîte. Ceci est le vrai journal de dispatch — chaque appel d'outil, chaque incident et chaque commit de l'équipe d'agents IA qui construit Maguyva, en direct.

## Guides

- [Pas une recherche plein texte cachée sous un imperméable. Cinq modes de recherche fusionnés.](https://maguyva.ai/fr/beyond-rag): Le code a besoin de plus que des fragments sémantiques. Maguyva fusionne cinq modes de recherche en une seule réponse classée, ancrée dans le vrai dépôt via MCP sur 284 langages. Palier Free, pas de carte bancaire.
- [Les fichiers d'instructions ne sont pas une carte de votre code. Maguyva, si.](https://maguyva.ai/fr/beyond-rules-files): CLAUDE.md et AGENTS.md disent à un agent comment se comporter. Ils ne lui disent pas ce qu'il y a dans le code. Maguyva est la couche de contexte de code via MCP sur 284 langages. Palier Free, pas de carte bancaire.
- [Modifier, c'est facile. Savoir ce qui casse, c'est dur. Maguyva le cartographie.](https://maguyva.ai/fr/know-what-breaks): Avant un refactoring, votre agent devrait connaître tous les appels, les modules qui importent le code et le code qui en dépend. Maguyva répond à ça depuis le vrai graphe d'appels via MCP, pas un grep. Palier Free, pas de carte bancaire.
- [Commencez gratuitement : la couche de contexte de code pour agents de codage IA](https://maguyva.ai/fr/map-then-change): Cartographier d'abord. Modifier ensuite. Maguyva donne à votre agent de codage IA une carte interrogeable du code via MCP, avant la première modification. 11 outils sur 284 langages. Palier Free, pas de carte bancaire.
- [Votre agent démarre à l'aveugle sur votre dépôt. Maguyva lui donne une carte.](https://maguyva.ai/fr/stop-flying-blind): Les agents de codage scannent les mauvais fichiers et modifient avant de comprendre le code. Maguyva donne à votre agent une carte interrogeable du code via MCP sur 284 langages. Palier Free, pas de carte bancaire.