El concepto de "segundo cerebro" — popularizado por Tiago Forte y el método PARA — describe un sistema externo donde almacenás tu conocimiento, ideas y metodología de trabajo. Obsidian se convirtió en la herramienta preferida de muchos developers para este fin: notas en Markdown, vault local, sin dependencias de cloud, con enlaces bidireccionales.

El problema: ese conocimiento queda completamente silenciado para Claude Code. Cada sesión empieza de cero, sin acceso a tus convenciones, tus decisiones de arquitectura documentadas ni tus checklists acumulados con el tiempo.

Cerebro MCP resuelve exactamente eso.

Qué es un "segundo cerebro" para un developer

Para un developer, el segundo cerebro no son apuntes de clases ni ideas de proyectos — es conocimiento metodológico operativo:

  • Convenciones de código que decidiste después de varios proyectos
  • Checklists de seguridad que construiste tras encontrar una vulnerabilidad
  • Decisiones de arquitectura con su contexto (por qué elegiste X sobre Y)
  • Prompts que sabés que funcionan para tareas específicas
  • Anti-patrones documentados después de ver fallar algo

Este conocimiento existe en tu vault de Obsidian. El problema es que Claude Code no lo ve. Cada vez que abrís una sesión, tenés que reexplicar todo o conformarte con respuestas genéricas que no conocen tu stack ni tus decisiones.

Cómo Cerebro MCP indexa el vault

Cerebro MCP funciona como un puente entre tu vault de Markdown y Claude Code. El proceso es:

  1. El vault del Cerebro (un repositorio git de ~300 notas en Markdown) se sincroniza al servidor vía git pull cada 6 horas.
  2. Un proceso de indexación convierte las notas en embeddings vectoriales usando all-MiniLM-L6-v2 y los almacena en PostgreSQL con pgvector.
  3. Cuando Claude Code llama a search_knowledge("CSRF PHP", "Seguridad"), el servidor hace una búsqueda por similitud semántica y retorna los fragmentos más relevantes.
  4. Claude usa esos fragmentos como contexto para la respuesta — sin que vos hayas pegado nada.

El flujo real de trabajo

Así se ve una sesión de trabajo con Cerebro MCP comparada con una sesión sin él:

Sin Cerebro — sesión sobre un proyecto PHP nuevo:

Vos: "Revisá la seguridad de este módulo de autenticación"
Claude: "Aquí hay algunas consideraciones generales de seguridad para autenticación PHP:
- Usar password_hash() para contraseñas
- Implementar CSRF tokens
- Validar input..."

Con Cerebro — misma sesión:

Claude llama: get_context("security-audit")
Claude llama: get_checklist("security")

Claude: "Revisé el módulo contra el checklist OWASP para PHP vanilla:

1. password_hash(PASSWORD_BCRYPT) ✅ — línea 47
2. CSRF token en formulario POST ❌ — falta en login.php:23
3. Rate limiting en /login ❌ — no implementado
4. session_set_cookie_params() con samesite/httponly ⚠️ — solo httponly, falta samesite
5. Prepared statements PDO ✅ — todas las queries

Prioridad: agregar CSRF token y rate limiting antes de deploy."

La diferencia es que Claude aplicó el checklist de tu metodología al código real, no una lista genérica de internet.

Qué tipo de notas se indexan mejor

No todas las notas de Obsidian son iguales de útiles para un MCP. Las que tienen mayor impacto en la calidad de las respuestas de Claude son:

  • Checklists operativos: "Pre-deploy PHP en Hostinger: 1. Verificar .env en producción. 2. Correr migraciones. 3..."
  • Decisiones de arquitectura: "Por qué usamos PDO con named parameters en lugar de positional — razón: debugging más claro en logs"
  • Anti-patrones documentados: "No usar md5() para passwords — encontré esto en el proyecto X, ver commit abc123"
  • Prompts especializados: plantillas de análisis que funcionaron bien y querés reutilizar

Las notas más largas con contexto narrativo se indexan bien semánticamente. Las notas muy cortas (1-2 líneas) o muy genéricas aportan poco valor al contexto de Claude.

Estructura de vault recomendada para developers

Si estás empezando a construir tu segundo cerebro técnico, una estructura que funciona bien con el indexado vectorial:

vault/
├── Seguridad/
│   ├── OWASP-Top-10-PHP.md
│   ├── CSRF-Patrones.md
│   └── Uploads-Validacion.md
├── PHP/
│   ├── PDO-Prepared-Statements.md
│   ├── Hostinger-Deploy-Checklist.md
│   └── Session-Configuration.md
├── SEO/
│   ├── Schema-Org-Tipos.md
│   └── GA4-Eventos-Conversion.md
└── Prompts/
    ├── Project-Analysis.md
    └── Security-Audit.md

Las categorías en el nombre de carpeta mejoran la relevancia de las búsquedas filtradas por categoría en search_knowledge(query, category).

El ciclo virtuoso: usar + documentar + mejorar

La ventaja real del sistema aparece con el tiempo. Cada vez que encontrás algo nuevo — un patrón de seguridad, una solución a un problema recurrente, un anti-patrón que quemó un proyecto — lo agregás al vault. En la próxima reindexación (máximo 6 horas), ese conocimiento está disponible para Claude en todas las sesiones futuras.

Es la diferencia entre un developer que aprende de sus errores en privado y uno que tiene ese aprendizaje disponible en cada tarea futura — automáticamente, sin tener que recordar que existe.