Conecta tus asistentes con MCP

Comprobado con las funciones de exportación de los proveedores en octubre de 2026.

El Model Context Protocol (MCP) permite a los asistentes de IA usar herramientas externas. El servidor MCP de AI Vault se ejecuta en tu ordenador, lee una copia de tu vault y permite a un asistente buscar conocimiento, leer fuentes y proponer memorias, nunca confirmarlas.

Qué puede hacer un asistente

  • search_knowledge, list_projects y get_project_history: leer lo que permita el rol del asistente.
  • read_source: leer los mensajes originales que respaldan el conocimiento. Por defecto el texto está seudonimizado; puedes cambiarlo a «nada» o «texto completo» en Ajustes → Miembros.
  • propose_memory: sugerir un elemento nuevo para que lo revises en Revisar.
  • save_memory / update_memory: para roles de editor; los elementos siempre se guardan como «propuestos» y los asistentes nunca pueden confirmarlos.

Configúralo

  1. En AI Vault, abre Ajustes → Miembros y asistentes y añade una identidad de asistente (por ejemplo «Claude Desktop») con el rol que necesite; Colaborador (propone) es un buen comienzo.
  2. Crea un token de acceso MCP para esa identidad y cópialo (se muestra una vez).
  3. En Ajustes → Almacenamiento, descarga una copia cifrada (.aivault).
  4. Instala Node.js 22 o posterior y descarga el archivo del servidor ai-vault-mcp.mjs desde el enlace de abajo.
  5. Añade el servidor a la configuración de tu asistente (ejemplo abajo) con la ruta de la copia, el token y la frase de la copia como variables de entorno.
  6. Reinicia el asistente. Las propuestas que haga se escriben en la copia; restáurala en AI Vault (Ajustes → Almacenamiento) para revisarlas. Restaurar sustituye el vault del navegador, así que hazlo antes de hacer otros cambios allí.

Ejemplo para Claude Desktop (claude_desktop_config.json)

                {
  "mcpServers": {
    "ai-vault": {
      "command": "node",
      "args": ["/ruta/a/ai-vault-mcp.mjs", "--vault", "/ruta/a/mi-vault.aivault"],
      "env": {
        "AI_VAULT_TOKEN": "avt_…",
        "AI_VAULT_PASSPHRASE": "la frase de tu copia"
      }
    }
  }
}
              

Otros clientes locales (Claude Code, Cursor, VS Code, Windsurf, Gemini/Antigravity CLI) usan el mismo comando y variables de entorno en su propia configuración MCP. VS Code puede pedirte el token y la frase en lugar de guardarlos (inputs con "password": true).

Opciones útiles

  • --read-only: la copia nunca se modifica y no se ofrecen las herramientas de escritura.
  • --http: atiende a varios asistentes en http://127.0.0.1:8765/mcp; cada uno envía su propio token como Authorization: Bearer avt_….
  • Para usarlo desde otra máquina, mantenlo en 127.0.0.1 y publícalo con un proxy inverso HTTPS y --allowed-host tu.dominio. Nunca expongas el puerto HTTP sin cifrar.
  • El token y la frase solo se aceptan como variables de entorno, nunca como argumentos, para que otros programas no puedan leerlos en la lista de procesos.

Qué no está soportado (todavía)

Conectores de ChatGPT y claude.ai

ChatGPT y los conectores web/móvil de claude.ai solo se conectan a servidores MCP remotos con inicio de sesión OAuth, y su disponibilidad depende de tu plan. El servidor local no puede usarse desde ellos y cleanchatgpt.com no ofrece un servicio MCP remoto.

Situación a octubre de 2026; los fabricantes de asistentes cambian a menudo su soporte de MCP, así que consulta su documentación.

Cómo se mantiene seguro

  • Cada asistente tiene su propio token revocable y con caducidad, ligado a un espacio de trabajo; solo se guarda su hash.
  • Cada llamada se comprueba contra el rol del asistente y las restricciones de proyecto; lo que queda fuera de su alcance se responde como «no encontrado».
  • Las escrituras requieren una clave de idempotencia, así que repetir una llamada nunca crea duplicados.
  • Cada llamada queda en el registro de auditoría (solo ids y resultados, sin contenido).
  • Recuerda: lo que lee el asistente se envía a su proveedor como parte de tu conversación.

Descargar el servidor MCP

Un solo archivo, requiere Node.js 22 o posterior. SHA-256: c102b617a23661528a43d270163c43a65360716ef2c6401de266bf7484d7f84b · 1109 KB

Guías relacionadas

Abrir AI Vault