Collegare Brave Search + Filesystem MCP

“Una tessera della biblioteca e una chiave del tuo schedario sono due permessi diversi. MCP consegna a Claude entrambi, un server alla volta, limitati esattamente a ciò che autorizzi.”

Dove vive la configurazione

Claude Desktop legge i suoi server MCP da un file JSON. Su macOS è `~/Library/Application Support/Claude/claude_desktop_config.json`. Modificalo (Claude Desktop → Settings → Developer → Edit Config apre lo stesso file), poi riavvia completamente Claude Desktop, perché carica i server solo all'avvio.

I due server

Entrambi i server girano su richiesta tramite `npx`, quindi non c'è niente da installare prima. Il server Brave ha bisogno della tua chiave Brave nel suo `env`; il server Filesystem prende le directory che può toccare come semplici argomenti.

{
  "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"
      ]
    }
  }
}

Ambito: il server Filesystem può toccare solo ciò che elenchi

I percorsi negli `args` del server Filesystem sono le *uniche* directory che può leggere o scrivere. Puntalo alla tua sottocartella dei brief, non alla tua home directory: l'ambito ristretto è tutta la storia della sicurezza qui. Il server gira con i permessi del tuo utente, quindi qualsiasi cosa tu possa fare in quella cartella, la può fare anche lui.

Verifica che funzioni

Riavvia Claude Desktop e cerca l'indicatore degli strumenti (i server compaiono come strumenti disponibili). Poi esegui un singolo test end-to-end in una chat:

• Chiedi: "Usa Brave per trovare i 5 sviluppi più significativi su [il tuo argomento] delle ultime 24 ore, poi scrivi un breve brief in un file chiamato test-brief.md nella mia cartella Briefings."
• Claude dovrebbe chiedere di usare lo strumento di ricerca Brave, poi lo strumento di scrittura filesystem. Approva entrambi.
• Controlla la cartella: `test-brief.md` dovrebbe essere lì, e dovrebbe aprirsi in Obsidian come una nota normale.

Se la ricerca fallisce, la causa abituale è la chiave Brave o il nome del pacchetto; se la scrittura fallisce, il percorso negli `args` non corrisponde alla tua cartella reale. Correggi quello che serve, riavvia, riprova. Una volta che questo giro completo funziona, hai validato ogni pezzo da cui dipende la build automatizzata. Il Capitolo 4 si limita a toglierti dal circuito.