Saltar al contenido
Capítulo 03 · 10 min

Cablear Brave Search + Filesystem MCP

Este es el montaje interactivo. Añades dos servidores MCP a Claude Desktop: uno que permite a Claude buscar en la web (Brave) y otro que le permite leer y escribir una carpeta (Filesystem). Después de esto, puedes pedirle a Claude "investiga las noticias de hoy sobre X y guarda el brief en mi vault" y de verdad puede hacer ambas cosas. También es la forma más barata de probar que tu clave de Brave y la ruta del vault funcionan antes de automatizar.

Un carnet de biblioteca y una llave de tu archivador son dos permisos distintos. MCP le da a Claude ambos, un servidor cada vez, limitados a exactamente lo que tú permitas.

exposed viaused byBrave APIMCP serverClaude

Dónde vive la configuración

Claude Desktop lee sus servidores MCP de un fichero JSON. En macOS es `~/Library/Application Support/Claude/claude_desktop_config.json`. Edítalo (Claude Desktop → Settings → Developer → Edit Config abre el mismo fichero) y reinicia Claude Desktop por completo, porque solo carga los servidores al arrancar.

Los dos servidores

Ambos servidores se ejecutan bajo demanda vía `npx`, así que no hay nada que instalar antes. El servidor de Brave necesita tu clave de Brave en su `env`; el servidor Filesystem recibe los directorios que puede tocar como argumentos normales.

jsonCopiar el 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"
      ]
    }
  }
}

Alcance: el servidor Filesystem solo puede tocar lo que listes

Las rutas en los `args` del servidor Filesystem son los *únicos* directorios que puede leer o escribir. Apúntalo a tu subcarpeta de briefs, no a tu directorio personal: el alcance estrecho es toda la historia de seguridad aquí. El servidor corre con los permisos de tu usuario, así que todo lo que tú puedas hacer en esa carpeta, él también puede.

Verifica que funciona

Reinicia Claude Desktop y busca el indicador de herramientas (los servidores aparecen como herramientas disponibles). Después, ejecuta una única prueba de extremo a extremo en un chat:

  • Pide: "Usa Brave para encontrar los 5 avances más significativos sobre [tu tema] de las últimas 24 horas y escribe un brief corto en un fichero llamado test-brief.md en mi carpeta Briefings."
  • Claude debería pedir usar la herramienta de búsqueda de Brave y luego la de escritura del filesystem. Aprueba cada una.
  • Comprueba la carpeta: `test-brief.md` debería estar ahí, y debería abrirse en Obsidian como una nota normal.

Si la búsqueda falla, la causa habitual es la clave de Brave o el nombre del paquete; si falla la escritura, la ruta en `args` no coincide con tu carpeta real. Arregla lo que toque, reinicia, reintenta. Cuando este viaje de ida y vuelta funciona, has validado todas las piezas de las que depende la construcción automatizada. El capítulo 4 solo te saca a ti del bucle.

Una línea por cada uno

  • Edita `~/Library/Application Support/Claude/claude_desktop_config.json`, añade los dos servidores y reinicia Claude Desktop por completo.
  • Usa @brave/brave-search-mcp-server (el actual), no el archivado @modelcontextprotocol/server-brave-search.
  • El servidor Filesystem solo puede tocar los directorios de sus args; limítalo a la carpeta de briefs, nunca a tu directorio personal.
  • Prueba una vez el ciclo completo búsqueda → escritura; valida la clave de Brave y la ruta del vault antes de automatizar.
Cablear Brave Search + Filesystem MCP · Cours d'IA · SDEN