🔌Serveurs MCP
Un serveur MCP donne à Claude les outils d'un service : lire votre compte publicitaire, chercher dans un espace Notion, interroger une base de données... Réglages -> MCP liste tous les serveurs MCP que Claude Code utilise dans votre espace de travail, l'endroit où chacun s'applique, et s'il fonctionne.
Où s'applique un serveur
| Où | Signification |
|---|---|
| Toutes les sessions | disponible dans tous les sujets (un outil que vous utilisez partout) |
un sujet (acme / ads) |
uniquement dans les sessions de ce sujet - le choix habituel : le compte publicitaire dans le sujet ads, pas dans les autres |
Cliquez sur un sujet pour l'ouvrir. Quand un sujet est renommé, ses serveurs le suivent ; un sujet supprimé laisse ses serveurs en Erreur (supprimez-les).
États
| État | Que faire |
|---|---|
| Connecté | rien, Claude a les outils |
| À connecter | le service demande une connexion : cliquez sur Connecter (voir plus bas) |
| Erreur | survolez-le pour voir la raison (mauvaise adresse, programme manquant, clé refusée...) |
| À approuver | un fichier .mcp.json trouvé dans un dossier de projet auquel Claude Code ne fait pas encore confiance |
| Non vérifié | cliquez sur Vérifier |
Les états sont vérifiés en arrière-plan quand vous ouvrez la page et avec Vérifier (quelques secondes par sujet).
Ajouter un serveur
Le plus simple : demandez à Claude dans le sujet qui en a besoin - « connecte le MCP de <service>, voici son adresse ». Ou Ajouter un serveur :
- Nom : court, lettres, chiffres,
-(par ex.google-ads). - Où : toutes les sessions, ou un sujet.
- Adresse (URL) donnée par le service (souvent terminée par
/mcp), ou Programme local : la commande qui le lance (par ex.npx -y @acme/mcp-server). - En-têtes (adresse) ou variables d'environnement (programme), uniquement quand le service demande une clé. Ne collez jamais la clé elle-même : rangez-la dans Réglages -> Clés et écrivez
${KEY_NAME}(le bouton de clé l'insère). Les clés utilisées de cette façon sont transmises automatiquement aux sessions. Une valeur écrite en clair (un jeton, un mot de passe) affiche un avertissement jeton en clair et est masquée sous la forme•••dans la liste, tout comme un mot de passe et les valeurs de requête d'une adresse (?key=•••) ; seules les références${KEY_NAME}et les en-têtes sans danger commeContent-Typerestent lisibles.
Le serveur est disponible dès le message suivant d'une session.
Connecter (connexion)
De nombreux services (état À connecter) utilisent une connexion au lieu d'une clé :
- Cliquez sur Connecter, puis sur Ouvrir la page de connexion.
- Connectez-vous au service et acceptez.
- Le navigateur affiche alors « Impossible d'accéder à ce site » sur
localhost: c'est normal. Le service vous renvoie vers une adresse qui n'existe que sur le serveur Harness ; le code de connexion se trouve dans cette adresse. Copiez l'adresse entière depuis la barre d'adresse (elle contientcode=). - De retour dans Harness, collez-la (bouton Coller, ou Ctrl+V) et cliquez sur Terminer.
Faites-le en quelques minutes : le code expire (cliquez alors sur Réessayer). Cela fonctionne quel que soit l'accès à Harness (domaine ou Tailscale) : Claude Code, sur le serveur, termine la connexion avec le code que vous avez collé.
La connexion est conservée pour toutes les sessions (Claude Code la renouvelle tout seul). À faire une seule fois par serveur.
Supprimer
... -> Supprimer. Les clés du coffre-fort restent.
Navigateur de mon PC
Réglages -> MCP -> Navigateur de mon PC permet à Claude d'utiliser un navigateur sur votre propre ordinateur (Windows, Mac ou Linux) : ouvrir un site sur lequel vous êtes connecté, remplir un formulaire, lire une page, faire une capture d'écran... Il utilise un profil distinct de votre navigateur (Brave, Chrome, Edge, Vivaldi, Opera ou Chromium) : vos onglets habituels, mots de passe et historique ne sont jamais touchés. Connectez-vous une seule fois aux sites dont Claude a besoin, dans la fenêtre qu'il ouvre. (La carte apparaît dès que Harness PC peut être téléchargé depuis votre serveur.)
- Choisissez votre ordinateur et votre navigateur (Harness les devine à partir du navigateur que vous utilisez), puis Obtenir Harness PC.
- Téléchargez Harness PC (déjà lié à ce serveur, valable 15 minutes) et ouvrez-le - ou collez la commande affichée dans PowerShell / un terminal. Sous Windows, SmartScreen peut afficher « Windows a protégé votre ordinateur » : Informations complémentaires -> Exécuter quand même (Harness PC n'est pas encore signé par un éditeur). Aucun droit d'administrateur n'est nécessaire.
- La carte demande alors «
<votre PC>veut se connecter », avec l'adresse depuis laquelle il s'est connecté : cliquez sur Oui, c'est mon PC. Jusque-là, rien n'atteint cet ordinateur - si vous ne reconnaissez pas le nom (quelqu'un d'autre a utilisé votre lien de téléchargement), cliquez sur Refuser : il est déconnecté et oublie votre serveur. Toutes les sessions peuvent alors utiliser les outils du navigateur (harness-pc).
Seulement pendant que Claude l'utilise. Harness PC attend en arrière-plan (sans fenêtre, presque aucun processeur ni mémoire utilisé) et ouvre la fenêtre du navigateur à la première action de Claude dans le navigateur ; après 10 minutes sans action (Réglages : de 5 à 60 min), le navigateur et ses outils s'arrêtent. Arrêter maintenant le ferme aussitôt. Quand le PC est éteint, en veille ou que Harness PC ne tourne pas, Claude reçoit le message « le PC est hors ligne » et continue.
Démarrer avec l'ordinateur (activé par défaut) ajoute Harness PC au démarrage de votre session (Windows : clé Run, Mac : élément de connexion, Linux : fichier de démarrage automatique), sans droits d'administrateur. Déconnecter l'arrête et le retire du démarrage sur le PC ; Effacer le profil supprime les cookies et les connexions du profil de Claude ; Réinstaller / autre PC refait l'appairage (un seul PC à la fois). Les dernières actions (outil, page) sont listées sur la carte.
Sécurité : Harness PC se connecte uniquement vers l'extérieur, à votre Harness (rien n'écoute sur votre réseau) ; le port de contrôle du navigateur reste sur 127.0.0.1 du PC et les pages web ne peuvent pas l'atteindre. Harness PC vérifie lui-même chaque commande qu'il relaie, si bien que même un serveur piraté ne pourrait pas s'en servir pour accéder à vos fichiers : seules les pages web (http, https) peuvent être ouvertes - pas de pages file:, chrome: ni de réglages, et Claude ne peut pas ouvrir les adresses de votre PC ou de votre réseau domestique (localhost, 192.168.x.x, votre box, un NAS) -, les téléchargements ne peuvent pas être envoyés vers un autre dossier, aucun fichier du PC ne peut être donné à une page, et aucune autorisation ni application ne peut être installée. Claude ne peut pas téléverser de fichiers depuis le PC ni enregistrer son écran. La liste des actions récentes conserve les adresses sans leur partie requête (les codes de connexion ne sont pas conservés).
Sauvegarde et nouveau serveur
La sauvegarde de la mémoire conserve la liste des serveurs (les valeurs qui ressemblent à des secrets sont effacées - jetons, mots de passe, noms de type API_KEY : utilisez ${KEY_NAME} pour eux afin qu'une restauration fonctionne telle quelle ; les réglages simples comme LOG_LEVEL=debug sont conservés) ; une restauration ajoute de nouveau ceux qui manquent. Les connexions doivent être refaites sur un nouveau serveur.
Depuis un terminal : maxxing mcp list|add|remove (voir la référence de la CLI).