Passer au contenu

Guide d'installation

Soyez opérationnel en moins de 5 minutes. Ce guide inclut la configuration pour 23 clients MCP, dont Claude Code, Claude Desktop, Cursor, VS Code / GitHub Copilot et Devin Desktop (Windsurf), et plus encore.

Prérequis : Vous aurez besoin d'une clé API depuis app.maguyva.ai et d'un dépôt GitHub connecté.

Configuration de l'environnement

#

Commencez par définir votre clé API dans une variable d’environnement. Omettez repository lorsque votre client MCP fournit une valeur par défaut pour la requête ou lorsque la clé permet d’accéder à un seul dépôt ; sinon, transmettez-le explicitement.

macOS/Linux (Bash/Zsh)

# 
# Add to your shell profile for persistence:
echo 'export MAGUYVA_API_KEY="mgv_xxxx"' >> ~/.zshrc  # or ~/.bashrc
source ~/.zshrc  # reload

Windows (PowerShell)

# 
# Make it persist in your profile:
'$Env:MAGUYVA_API_KEY="mgv_xxxx"' | Out-File -Append $PROFILE
. $PROFILE

Remplacez mgv_xxxx par votre clé API réelle depuis app.maguyva.ai.

Configuration du client

#

Choisissez votre client MCP ci-dessous pour des instructions de configuration spécifiques.

Note de compatibilité : Maguyva utilise le standard MCP. Tout client compatible MCP peut se connecter au même serveur, même si nous n'avons pas encore écrit de guide de configuration officiel pour lui.

Claude Code

Installez le plugin Maguyva depuis la marketplace de Claude Code :

Ajoutez la marketplace Maguyva, puis installez le plugin (lancez chaque commande dans Claude Code) :

/plugin marketplace add maguyva/agent-plugins
/plugin install maguyva@maguyva

/plugin install ouvre les détails du plugin, où vous choisissez la portée d'installation : vous seul (user), toutes les personnes qui travaillent dans ce dépôt (project), ou vous seul dans ce dépôt (local). Ces commandes de session n'acceptent pas d'option --scope.

Le plugin s'authentifie via la variable d'environnement MAGUYVA_API_KEY. Définissez-la dans votre shell :

export MAGUYVA_API_KEY=mgv_xxxx

Le direnv (.envrc) par projet est recommandé — les clés sont scopées par dépôt, donc une valeur par projet correspond à l'accès de chaque projet. Un export shell global fonctionne si une seule clé couvre tout votre travail.

Pour une équipe, vous pouvez aussi exécuter la forme shell des deux commandes depuis la racine du dépôt, en dehors de Claude Code :

claude plugin marketplace add maguyva/agent-plugins --scope project
claude plugin install maguyva@maguyva --scope project

La portée project enregistre le plugin dans le .claude/settings.json du dépôt, que vous commitez. Le plugin est alors activé pour vos coéquipiers, mais pas téléchargé : chaque coéquipier exécute donc la commande d'installation une fois.

Manuel (.mcp.json) — avancé
claude mcp add 
claude mcp add --transport http maguyva https://maguyva.tools/mcp --header 'Authorization: Bearer ${MAGUYVA_API_KEY}'
.mcp.json 
{
  "mcpServers": {
    "maguyva": {
      "type": "http",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${MAGUYVA_API_KEY}"
      }
    }
  }
}

Remplacez mgv_xxxx par votre clé API depuis app.maguyva.ai.

Ce que Maguyva apporte à Claude Code →

Docs MCP Claude Code →

Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %AppData%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Ajoutez à votre fichier de configuration Claude Desktop :

claude_desktop_config.json 
{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "@maguyva/mcp"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

Remplacez mgv_xxxx par votre clé API depuis app.maguyva.ai.

claude_desktop_config.json ne démarre que des serveurs locaux : cette configuration utilise donc le pont @maguyva/mcp (Node.js / npx requis). Claude Desktop peut aussi atteindre Maguyva comme connecteur personnalisé (Customize → Connectors) avec un en-tête de requête authorization, mais les en-têtes de requête sont en bêta pour un nombre limité d’organisations.

Ce que Maguyva apporte à Claude Desktop →

Docs MCP Claude Desktop →

Cursor

macOS: ~/.cursor/mcp.json
Windows: %UserProfile%\.cursor\mcp.json
Linux: ~/.cursor/mcp.json

Ajoutez à .cursor/mcp.json à la racine de votre projet :

.cursor/mcp.json 
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}

Cette config lit votre clé depuis la variable d'environnement MAGUYVA_API_KEY. Définissez-la avec votre clé API obtenue sur app.maguyva.ai, dans l'environnement depuis lequel votre client démarre.

Ce que Maguyva apporte à Cursor →

Docs MCP Cursor →

VS Code / GitHub Copilot

Ajoutez-le à .vscode/mcp.json dans votre projet, ou au mcp.json de votre profil (lancez MCP: Open User Configuration) :

.vscode/mcp.json 
{
  "servers": {
    "maguyva": {
      "type": "http",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}

Cette config lit votre clé depuis la variable d'environnement MAGUYVA_API_KEY. Définissez-la avec votre clé API obtenue sur app.maguyva.ai, dans l'environnement depuis lequel votre client démarre.

C’est le format VS Code (clé servers). VS Code résout la référence à MAGUYVA_API_KEY depuis l’environnement dans lequel il démarre. Son parcours Add Server privilégie désormais le .mcp.json portable (clé mcpServers), que GitHub Copilot CLI lit aussi ; ce fichier ne prend pas en charge les variables d’entrée ni les fichiers d’environnement de VS Code.

Ce que Maguyva apporte à VS Code / GitHub Copilot →

Docs MCP VS Code / GitHub Copilot →

Devin Desktop (Windsurf)

macOS: ~/.config/devin/mcp_config.json
Windows: %APPDATA%\devin\mcp_config.json
Linux: ~/.config/devin/mcp_config.json

Windsurf s’appelle désormais Devin Desktop. Ajoutez-le à son fichier de configuration MCP :

mcp_config.json 
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}

Cette config lit votre clé depuis la variable d'environnement MAGUYVA_API_KEY. Définissez-la avec votre clé API obtenue sur app.maguyva.ai, dans l'environnement depuis lequel votre client démarre.

Devin Local, l’agent par défaut, lit ce fichier depuis la version 3.6 ; les versions antérieures gardaient les serveurs dans le fichier de configuration principal et les déplacent ici au démarrage. L’ancien agent Cascade, sur lequel les nouvelles conversations ne démarrent pas, lit le même fichier. Devin Desktop résout la référence à MAGUYVA_API_KEY depuis l’environnement dans lequel il démarre.

Ce que Maguyva apporte à Devin Desktop (Windsurf) →

Docs MCP Devin Desktop (Windsurf) →

Codex

macOS: ~/.codex/config.toml
Windows: %UserProfile%\.codex\config.toml
Linux: ~/.codex/config.toml

Ajoutez à votre config Codex CLI (~/.codex/config.toml) :

.codex/config.toml 
[mcp_servers.maguyva]
url = "https://maguyva.tools/mcp"
bearer_token_env_var = "MAGUYVA_API_KEY"

Cette config lit votre clé depuis la variable d'environnement MAGUYVA_API_KEY. Définissez-la avec votre clé API obtenue sur app.maguyva.ai, dans l'environnement depuis lequel votre client démarre.

Ce que Maguyva apporte à Codex →

Docs MCP Codex →

GitHub Copilot CLI

Ajoutez à ~/.copilot/mcp-config.json :

~/.copilot/mcp-config.json 
{
  "mcpServers": {
    "maguyva": {
      "type": "http",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}
copilot mcp add 
copilot mcp add --transport http --header "Authorization: Bearer mgv_xxxx" maguyva https://maguyva.tools/mcp

Remplacez mgv_xxxx par votre clé API depuis app.maguyva.ai.

Ce que Maguyva apporte à GitHub Copilot CLI →

Docs MCP GitHub Copilot CLI →

Gemini CLI

macOS: ~/.gemini/settings.json
Windows: %UserProfile%\.gemini\settings.json
Linux: ~/.gemini/settings.json

Ajoutez à vos paramètres Gemini CLI (~/.gemini/settings.json) :

settings.json 
{
  "mcpServers": {
    "maguyva": {
      "httpUrl": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${MAGUYVA_API_KEY}"
      }
    }
  }
}

Cette config lit votre clé depuis la variable d'environnement MAGUYVA_API_KEY. Définissez-la avec votre clé API obtenue sur app.maguyva.ai, dans l'environnement depuis lequel votre client démarre.

Ce que Maguyva apporte à Gemini CLI →

Docs MCP Gemini CLI →

Cline

macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
Windows: %AppData%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

Ajoutez à vos paramètres MCP Cline :

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

Remplacez mgv_xxxx par votre clé API depuis app.maguyva.ai.

Ce que Maguyva apporte à Cline →

Docs MCP Cline →

Goose

macOS: ~/.config/goose/config.yaml
Windows: %APPDATA%\Block\goose\config\config.yaml
Linux: ~/.config/goose/config.yaml

Ajoutez à votre config Goose :

config.yaml 
extensions:
  maguyva:
    name: maguyva
    type: streamable_http
    uri: https://maguyva.tools/mcp
    enabled: true
    headers:
      Authorization: Bearer mgv_xxxx
    timeout: 300

Remplacez mgv_xxxx par votre clé API depuis app.maguyva.ai.

Ce que Maguyva apporte à Goose →

Docs MCP Goose →

LM Studio

Dans LM Studio, ouvrez l’onglet Program dans la barre latérale droite, choisissez Install → Edit mcp.json, puis ajoutez :

mcp.json 
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

Remplacez mgv_xxxx par votre clé API depuis app.maguyva.ai.

Docs MCP LM Studio →

Continue

Enregistrez-le sous .continue/mcpServers/maguyva.yaml dans votre espace de travail (ou ajoutez l’entrée mcpServers à ~/.continue/config.yaml), puis définissez MAGUYVA_API_KEY dans ~/.continue/.env :

.continue/mcpServers/maguyva.yaml 
name: Maguyva
version: 0.0.1
schema: v1
mcpServers:
  - name: maguyva
    type: streamable-http
    url: https://maguyva.tools/mcp
    requestOptions:
      headers:
        Authorization: Bearer ${{ secrets.MAGUYVA_API_KEY }}

Cette config lit votre clé depuis la variable d'environnement MAGUYVA_API_KEY. Définissez-la avec votre clé API obtenue sur app.maguyva.ai, dans l'environnement depuis lequel votre client démarre.

Continue n’utilise les serveurs MCP qu’en mode agent. Il cherche le secret dans ~/.continue/.env, puis dans .continue/.env et .env de l’espace de travail, puis dans l’environnement du processus.

Ce que Maguyva apporte à Continue →

Docs MCP Continue →

Kiro CLI (Amazon Q Developer CLI)

macOS: ~/.kiro/settings/mcp.json
Windows: %USERPROFILE%\.kiro\settings\mcp.json
Linux: ~/.kiro/settings/mcp.json

Ajoutez-le à la configuration MCP de Kiro CLI (~/.kiro/settings/mcp.json, ou .kiro/settings/mcp.json dans un projet) :

mcp.json 
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

Remplacez mgv_xxxx par votre clé API depuis app.maguyva.ai.

Kiro CLI remplace Amazon Q Developer CLI. À l'installation, il copie une seule fois vos serveurs de ~/.aws/amazonq/mcp.json vers ~/.kiro/settings/mcp.json, et le fichier .kiro/settings/mcp.json d'un projet prime sur le fichier utilisateur.

Docs MCP Kiro CLI (Amazon Q Developer CLI) →

PyCharm

Collez-le dans Settings | Tools | AI Assistant | Model Context Protocol (MCP) → Add, en tant que configuration JSON : 

{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "@maguyva/mcp"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

Remplacez mgv_xxxx par votre clé API depuis app.maguyva.ai.

Cette configuration utilise le pont @maguyva/mcp (nécessite Node.js / npx). Aucune configuration de connexion distante native pour ce client n’a été vérifiée dans le cadre de ce guide ; cela ne signifie pas que le client ne prend pas en charge les connexions distantes de manière native. Maguyva s’exécute entièrement à distance — seul le pont s’exécute en local.

Docs MCP PyCharm →

Zed

macOS: ~/.config/zed/settings.json
Windows: %AppData%\Zed\settings.json
Linux: ~/.config/zed/settings.json

Ajoutez à vos paramètres Zed (~/.config/zed/settings.json) :

settings.json 
{
  "context_servers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

Remplacez mgv_xxxx par votre clé API depuis app.maguyva.ai.

Ce que Maguyva apporte à Zed →

Docs MCP Zed →

Trae

Activez Enable Project MCP dans Settings → MCP, puis ajoutez-le à .trae/mcp.json à la racine du projet :

.trae/mcp.json 
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

Remplacez mgv_xxxx par votre clé API depuis app.maguyva.ai.

Docs MCP Trae →

OpenCode

Ajoutez à opencode.json à la racine de votre projet :

opencode.json 
{
  "mcp": {
    "maguyva": {
      "type": "remote",
      "url": "https://maguyva.tools/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:MAGUYVA_API_KEY}"
      }
    }
  }
}

Cette config lit votre clé depuis la variable d'environnement MAGUYVA_API_KEY. Définissez-la avec votre clé API obtenue sur app.maguyva.ai, dans l'environnement depuis lequel votre client démarre.

Ce que Maguyva apporte à OpenCode →

Docs MCP OpenCode →

BoltAI

macOS: ~/.boltai/mcp.json

Ajoutez à votre configuration MCP BoltAI :

mcp.json 
{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "@maguyva/mcp"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

Remplacez mgv_xxxx par votre clé API depuis app.maguyva.ai.

Cette configuration utilise le pont @maguyva/mcp (nécessite Node.js / npx). Aucune configuration de connexion distante native pour ce client n’a été vérifiée dans le cadre de ce guide ; cela ne signifie pas que le client ne prend pas en charge les connexions distantes de manière native. Maguyva s’exécute entièrement à distance — seul le pont s’exécute en local.

Docs MCP BoltAI →

LibreChat

Ajoutez-le à librechat.yaml et définissez MAGUYVA_API_KEY dans l’environnement du serveur LibreChat :

librechat.yaml 
mcpServers:
  maguyva:
    type: streamable-http
    url: https://maguyva.tools/mcp
    headers:
      Authorization: Bearer ${MAGUYVA_API_KEY}
    requiresOAuth: false

Cette config lit votre clé depuis la variable d'environnement MAGUYVA_API_KEY. Définissez-la avec votre clé API obtenue sur app.maguyva.ai, dans l'environnement depuis lequel votre client démarre.

Docs MCP LibreChat →

Antigravity

macOS: ~/.gemini/config/mcp_config.json
Windows: %UserProfile%\.gemini\config\mcp_config.json
Linux: ~/.gemini/config/mcp_config.json

Ajoutez à votre configuration MCP Antigravity :

mcp_config.json 
{
  "mcpServers": {
    "maguyva": {
      "serverUrl": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

Remplacez mgv_xxxx par votre clé API depuis app.maguyva.ai.

Ce que Maguyva apporte à Antigravity →

Docs MCP Antigravity →

Claude Cowork

Claude Cowork ne charge pas les serveurs de claude_desktop_config.json ; il atteint les serveurs distants sous forme de connecteurs personnalisés. Dans Customize → Connectors, ajoutez un connecteur personnalisé avec l’URL https://maguyva.tools/mcp, choisissez No sign-in et ajoutez un en-tête de requête authorization dont la valeur est Bearer suivi de votre clé API. Les en-têtes de requête sont en bêta pour un nombre limité d’organisations ; si la boîte de dialogue n’a pas de section Request headers, Cowork ne peut pas encore s’authentifier auprès de Maguyva. Voir la doc →

ChatGPT

ChatGPT supporte les serveurs MCP distants sur les plans Business, Enterprise et Edu via Settings → Apps → Create. Un point de terminaison HTTPS distant est requis — ChatGPT ne supporte pas les serveurs stdio locaux. Voir le guide MCP d'OpenAI pour la configuration. Voir la doc →

Warp

Ajoutez-le à ~/.warp/.mcp.json (ou à .warp/.mcp.json dans un projet), ou collez-le dans Settings → Agents → MCP servers → + Add :

~/.warp/.mcp.json 
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

Remplacez mgv_xxxx par votre clé API depuis app.maguyva.ai.

Ce que Maguyva apporte à Warp →

Docs MCP Warp →

Maguyva utilise le standard MCP. N'importe quel client qui prend en charge le protocole peut se connecter — même sans guide officiel ci-dessus. 23 clients documentés, d'autres ajoutés régulièrement.

Validez votre configuration

#

Une fois connecté, essayez de poser quelques questions à votre agent :

  • « Quels dépôts ai-je connectés ? » — vérifie que la connexion fonctionne
  • « Comment l'authentification est-elle gérée dans cette base de code ? » — teste la recherche sémantique
  • « Trouve toutes les fonctions qui appellent la base de données » — teste la recherche de dépendances
  • « De quoi dépend la classe UserService ? » — teste la recherche de symboles

Vous devriez voir des résultats avec les chemins de fichiers et numéros de ligne de votre dépôt connecté. Sinon, consultez la section troubleshooting section ci-dessous.

Format du dépôt

#

Lorsque vous spécifiez des dépôts :

  • Avec branche: "owner/repo:branch" (e.g., "owner/repository:develop")
  • Branche par défaut: "owner/repo"

Conseil : utilisez repository_context(action="info", repository="...") pour vérifier la résolution du dépôt. Un remplacement explicite du dépôt s’applique uniquement à l’appel en cours.

Dépannage

#

Problèmes de clé API

#
  • Vérifiez que votre clé commence par le préfixe mgv_
  • Vérifiez que la clé est correctement définie dans votre environnement
  • Assurez-vous que la clé n'a pas expiré

Dépôt introuvable

#
  • Vérifiez que le dépôt est connecté dans app.maguyva.ai
  • Vérifiez que le format owner/repo est correct
  • Assurez-vous d'avoir accès au dépôt

Problèmes de connexion MCP

#
  • Si votre client utilise le pont @maguyva/mcp, vérifiez que npx est disponible dans votre PATH
  • Vérifiez que votre jeton API est valide et non expiré
  • Testez la connectivité vers https://maguyva.tools/mcp
  • Vérifiez la syntaxe de configuration MCP de votre client

Étapes suivantes

#

À voir aussi

À lire ensuite