Aller au contenu
Chapitre 03 · 10 min

Brancher Brave Search + Filesystem MCP

Voici l'assemblage interactif. Vous ajoutez deux serveurs MCP à Claude Desktop : un qui permet à Claude de chercher sur le web (Brave) et un qui lui permet de lire et d'écrire dans un dossier (Filesystem). Ensuite, vous pouvez demander à Claude « recherche les actualités du jour sur X et enregistre le brief dans mon coffre » et il peut réellement faire les deux. C'est aussi la façon la moins coûteuse de prouver que votre clé Brave et le chemin de votre coffre fonctionnent avant d'automatiser.

Une carte de bibliothèque et une clé de votre classeur sont deux permissions différentes. MCP donne les deux à Claude, un serveur à la fois, limité à exactement ce que vous autorisez.

exposed viaused byBrave APIMCP serverClaude

Où vit la configuration

Claude Desktop lit ses serveurs MCP depuis un fichier JSON. Sur macOS, il s'agit de `~/Library/Application Support/Claude/claude_desktop_config.json`. Éditez-le (Claude Desktop → Settings → Developer → Edit Config ouvre le même fichier), puis redémarrez complètement Claude Desktop, car il ne charge les serveurs qu'au lancement.

Les deux serveurs

Les deux serveurs tournent à la demande via `npx`, il n'y a donc rien à installer au préalable. Le serveur Brave a besoin de votre clé Brave dans son `env` ; le serveur Filesystem prend en arguments simples les répertoires qu'il a le droit de toucher.

jsonCopier le prompt
{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@brave/brave-search-mcp-server", "--transport", "stdio"],
      "env": { "BRAVE_API_KEY": "YOUR_BRAVE_KEY" }
    },
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/you/ObsidianVault/Briefings"
      ]
    }
  }
}

Périmètre : le serveur Filesystem ne peut toucher que ce que vous listez

Les chemins dans les `args` du serveur Filesystem sont les *seuls* répertoires qu'il peut lire ou écrire. Pointez-le vers votre sous-dossier de briefs, pas vers votre répertoire personnel : le périmètre étroit est toute l'histoire de sécurité ici. Le serveur tourne avec les permissions de votre utilisateur, donc tout ce que vous pouvez faire dans ce dossier, il peut le faire.

Vérifiez que ça marche

Redémarrez Claude Desktop et cherchez l'indicateur d'outils (les serveurs apparaissent comme des outils disponibles). Puis lancez un seul test de bout en bout dans une conversation :

  • Demandez : « Utilise Brave pour trouver les 5 développements les plus significatifs sur [votre sujet] des dernières 24 heures, puis écris un court brief dans un fichier nommé test-brief.md dans mon dossier Briefings. »
  • Claude devrait demander à utiliser l'outil de recherche Brave, puis l'outil d'écriture filesystem. Approuvez chacun.
  • Vérifiez le dossier : `test-brief.md` devrait s'y trouver, et il devrait s'ouvrir dans Obsidian comme une note normale.

Si la recherche échoue, la clé Brave ou le nom du package est la cause habituelle ; si l'écriture échoue, le chemin dans `args` ne correspond pas à votre vrai dossier. Corrigez l'un ou l'autre, redémarrez, réessayez. Une fois cet aller-retour fonctionnel, vous avez validé toutes les pièces dont dépend la version automatisée. Le chapitre 4 ne fait que vous retirer de la boucle.

En une ligne chacun

  • Éditez `~/Library/Application Support/Claude/claude_desktop_config.json`, ajoutez les deux serveurs, et redémarrez complètement Claude Desktop.
  • Utilisez @brave/brave-search-mcp-server (actuel), pas @modelcontextprotocol/server-brave-search, archivé.
  • Le serveur Filesystem ne peut toucher que les répertoires de ses args ; limitez-le au dossier de briefs, jamais à votre répertoire personnel.
  • Testez une fois l'aller-retour complet recherche → écriture ; il valide la clé Brave et le chemin du coffre avant d'automatiser.
Brancher Brave Search + Filesystem MCP · Cours d'IA · SDEN