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 :
| Type | Où il s’exécute | Où est-il configuré ? |
|---|---|---|
| Hébergé | En dehors de votre machine ; se connecteCHAMPREP à celle-ci via HTTPS | Votre compteCHAMPREP AI, partagé avec les applications Web, de bureau et mobiles |
| Local | Un programme lancé sur votre ordinateur, communiquant via MCP par le biais des entrées et sorties standard | Un 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.
La fenêtre /mcp
Section intitulée « La fenêtre /mcp »/mcpLa 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 |
|---|---|
Enter | Afficher les actions relatives au serveur. |
e | Activez ou désactivez le serveur. |
r | Actualiser : se reconnecter et recharger ses outils. |
a | Réauthentification : remplacez ses identifiants. |
t | Répertoriez ses outils. |
x | Supprimez le serveur. |
n | Ajoutez 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.
Serveurs hébergés
Section intitulée « Serveurs hébergés »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.
Serveurs locaux
Section intitulée « Serveurs locaux »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.
Serveurs de projet et confiance
Section intitulée « Serveurs de projet et confiance »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.
Validation des appels à l’outil MCP
Section intitulée « Validation des appels à l’outil MCP »- 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 lagithubserveur. 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.