Aller au contenu
Documentation

Serveurs MCP dans l’agent IA

Les serveurs MCP (Model Context Protocol) fournissent des outils supplémentaires à l’agent. L’agent prend en charge deux types :

TypeOù il s’exécuteOù est-il configuré ?
HébergéEn dehors de votre machine ; se connecteCHAMPREP à celle-ci via HTTPSVotre compteCHAMPREP AI, partagé avec les applications Web, de bureau et mobiles
LocalUn programme lancé sur votre ordinateur, communiquant via MCP par le biais des entrées et sorties standardUn mcp.json Fichier destiné à votre usage personnel ou à celui du projet

Cette page traite de la connexion des serveurs à l’agent. Pour utiliser CHAMPREP CHAMPREPlui-même depuis un autre client MCP, consultez la section CHAMPREP Serveur MCP.

/mcp

La fenêtre répertorie tous les serveurs hébergés et locaux avec leur état et leurs outils. Sélectionnez un serveur à l’aide des touches fléchées, puis appuyez sur :

CléAction
EnterAfficher les actions relatives au serveur.
eActivez ou désactivez le serveur.
rActualiser : se reconnecter et recharger ses outils.
aRéauthentification : remplacez ses identifiants.
tRépertoriez ses outils.
xSupprimez le serveur.
nAjoutez un serveur.

Les raccourcis fonctionnent également sans la fenêtre, par exemple /mcp list, /mcp enable NAME, /mcp disable NAME, /mcp refresh NAME, et, pour les serveurs locaux, /mcp restart NAME et /mcp remove NAME.

Les serveurs hébergés appartiennent à votre CHAMPREP AIcompte ; ainsi, un serveur que vous ajoutez dans le terminal est également disponible sur le Web, et inversement. Leurs outils s’exécutent sur CHAMPREP, et non sur votre machine.

Pour en ajouter un, appuyez sur n dans /mcp, choisissez un serveur hébergé, puis saisissez son URL et ses identifiants, tels qu’un jeton « bearer ». Les identifiants sont saisis dans un champ masqué, envoyés une seule fois à votre CHAMPREP AIcompte et ne sont jamais affichés, enregistrés localement, consignés dans les journaux ni transmis au modèle. Utilisez a pour remplacer un identifiant expiré.

La suppression d’un serveur hébergé le supprime de votre compte sur toutes les interfaces. Si une action relative à un serveur hébergé n’est pas disponible depuis le CLIdans votre environnement, l’ agent vous en informe ; utilisez plutôt vos paramètresCHAMPREP AI sur le Web.

Les serveurs locaux sont des programmes que l’agent lance sur votre machine. Ajoutez-en un avec n dans /mcp et choisissez :

  • le nom du serveur et la commande avec ses arguments ;
  • à votre usage exclusif (votre compte utilisateur mcp.json) ou pour ce projet (.champrep/mcp.json, que vous pouvez valider) ;
  • éventuellement, une variable d’environnement contenant des identifiants. Sa valeur est masquée, stockée uniquement dans votre compte utilisateur mcp.json, et ne sont jamais enregistrées dans un fichier de projet, l’historique, les journaux ou le contexte du modèle.

Vous pouvez également modifier ces fichiers directement. Ils utilisent le format client MCP standard. Conservez vos identifiants dans votre dossier utilisateur, jamais dans un fichier de projet que vous validez :

{
"mcpServers": {
"github": {
"command": "github-mcp-server",
"args": ["stdio"],
"env": { "GITHUB_TOKEN": "YOUR_TOKEN" }
}
}
}

Champs facultatifs par serveur : disabled, include_tools, exclude_tools, startup_timeout_sec (valeur par défaut : 30), tool_timeout_sec (valeur par défaut 120, maximum 600), et priority. Seuls les serveurs locaux (stdio) doivent figurer dans ces fichiers ; ajoutez les serveurs HTTP en tant que serveurs hébergés.

Les serveurs locaux ne reçoivent jamais vos CHAMPREPidentifiants ni aucune CHAMPREP_* variable d’environnement.

Exécuter champrep ai paths pour trouver votre utilisateur mcp.json. Les serveurs MCP locaux constituent une fonctionnalité de votre forfait ; voir Formules et limites.

Un projet .champrep/mcp.json exécute des commandes sur votre machine ; ses serveurs ne démarrent donc qu’après que vous ayez accordé votre confiance au projet .champrep/ configuration. Si le fichier change, vous êtes à nouveau invité à choisir. Voir Confiance du référentiel.

  • Outils du serveur local sont traités comme des commandes : chaque appel sollicite votre autorisation, en affichant le serveur et les arguments, sauf si une règle d’autorisation s’applique à celui-ci. Par exemple, local_mcp__github__* permet d’utiliser tous les outils de la github serveur. Les règles de refus fonctionnent de la même manière.
  • Outils de serveur hébergé Suivez le paramètre d’approbation du serveur de votre CHAMPREP AI compte. Lorsqu’un appel nécessite une approbation, l’agent affiche une fiche d’approbation ; rien n’est approuvé automatiquement.

L’agent peut proposer au maximum 64 outils locaux par tour. Lorsque les serveurs locaux en fournissent davantage, les moins—priority Les serveurs sont d’abord filtrés et l’agent vous en informe. Utilisez include_tools ou exclude_tools pour conserver les outils dont vous avez besoin.