Configuración de MCP

La mayoría de los usuarios no necesitará esta página. Todos los clientes de IA modernos (Claude, Cursor, ChatGPT, VS Code, Windsurf, Zed) incluyen una interfaz gráfica que añade Engram en pocos clics. Consulta Integraciones de IA para ver la guía de cada cliente.

Si prefieres editar un archivo de configuración (o tu cliente no tiene interfaz gráfica), hay tres caminos, del más fácil al más manual: dejar la configuración en manos de tu IA, seguir las pestañas de cada cliente o prescindir de OAuth con una clave de API.

Deja que tu IA lo configure

El camino más rápido: pega el prompt de abajo en tu asistente de IA. Detectará en qué cliente se ejecuta, editará el archivo de configuración correcto (o ejecutará el comando de CLI adecuado) y te dirá qué hacer a continuación.

Add Engram as an MCP server in this AI client, then teach the AI to use it.

URL: https://mcp.engram.page
Transport: HTTP
Auth: OAuth — a browser opens on first connect.

First, pick the right path for this client (CLI like `claude mcp add`, editing an mcp.json, etc.), do the setup, and tell me how to restart so the new server registers.

After that's done, add the text below to my long-lived system / global prompt for this client (e.g. ~/.claude/CLAUDE.md for Claude Code, Cursor Rules for Cursor, the personal preferences field at claude.ai/settings/general for Claude Desktop). If it's a web UI you can't edit, just tell me where to paste it:

Engram holds my personal notes — treat it as your long-term memory of me. Search it when a question depends on context I might have shared before. Before saving or updating a note, ask first.

Reference: https://engram.page/docs/mcp/manual-config/

Si algo sale mal (o prefieres hacerlo tú mismo), las pestañas de cada cliente de abajo incluyen la receta manual completa.

Endpoint MCP de Engram

https://mcp.engram.page

Engram habla MCP sobre HTTPS. Hay dos formas de autenticarse:

• OAuth (predeterminado). La primera vez que tu cliente se conecta a la URL de arriba, se abre una ventana del navegador para iniciar sesión. Después, el cliente guarda un token y se reconecta sin intervención. No hay claves que copiar.
• Clave de API para configuraciones sin interfaz, automatizadas o con bóvedas compartidas. Envía la clave como token Bearer en un encabezado Authorization. Consulta Autenticación con clave de API más abajo.

En ambos casos, sin variables de entorno ni proceso de servidor local.

Configura tu cliente

Elige tu cliente en las pestañas de abajo. Cada pestaña es una receta completa: configuración, recarga, autenticación en el primer uso y dónde enseñar a la IA a usar Engram de verdad.

Para self-host, sustituye la URL de la nube por la URL /api/mcp de tu propio backend en cualquiera de los fragmentos de abajo. Consulta la sección de endpoints de arriba para ver los marcadores de posición canónicos.

Claude Code

1. Añade Engram. Usa la CLI de Claude Code, que se encarga de editar la configuración por ti:

claude mcp add --transport http --scope user engram https://mcp.engram.page

La opción --scope user hace que Engram esté disponible en todos los proyectos. Quítala (o usa --scope project) para limitar Engram al .mcp.json del proyecto actual.

¿Prefieres hacerlo a mano? Añade esto a ~/.claude.json (ámbito de usuario) o a .mcp.json en la raíz del proyecto:

{
  "mcpServers": {
    "engram": {
      "url": "https://mcp.engram.page"
    }
  }
}

2. Recarga. Sal de tu sesión actual de Claude Code y vuelve a ejecutar claude. Ejecuta claude mcp list para confirmar que Engram está registrado.

3. Autenticación en el primer uso. Claude Code no la solicita automáticamente. En la nueva sesión, ejecuta /mcp, selecciona engram (aparece como △ needs authentication) y elige Authenticate. Se abre tu navegador para OAuth. Inicia sesión en Engram, aprueba la conexión y Claude Code guarda el token y lo reutiliza a partir de entonces. Hoy la concesión es el scope completo mcp; los scopes granulares por acción están en la hoja de ruta.

4. Dile a Claude que lo use. Añade el fragmento de abajo a ~/.claude/CLAUDE.md, tu archivo de instrucciones a nivel de usuario, que se aplica a todos los proyectos.

Engram holds my personal notes — treat it as your long-term memory of me. Search it when a question depends on context I might have shared before. Before saving or updating a note, ask first.

Cursor

1. Edita la configuración. Añade Engram a ~/.cursor/mcp.json (ámbito de usuario) o a .cursor/mcp.json en la raíz de tu proyecto (ámbito de proyecto):

{
  "mcpServers": {
    "engram": {
      "url": "https://mcp.engram.page"
    }
  }
}

2. Recarga. Cierra Cursor por completo (Cmd+Q / File → Exit) y vuelve a abrirlo. Recargar la ventana no basta; los servidores MCP se registran al iniciar la aplicación.

3. Autenticación en el primer uso.

La primera vez que Cursor llama a Engram, tu navegador se abre para OAuth. Inicia sesión en Engram, aprueba la conexión y listo. Cursor guarda el token y lo reutiliza a partir de entonces. Hoy la concesión es el scope completo mcp; los scopes granulares por acción están en la hoja de ruta.

4. Dile a Cursor que lo use. Añade el fragmento de abajo a tus Cursor Rules: ~/.cursor/rules (ámbito de usuario) o .cursor/rules en un proyecto.

Engram holds my personal notes — treat it as your long-term memory of me. Search it when a question depends on context I might have shared before. Before saving or updating a note, ask first.

VS Code

1. Edita la configuración. Añade Engram a .vscode/mcp.json en tu espacio de trabajo. VS Code usa servers en lugar de mcpServers y requiere "type": "http":

{
  "servers": {
    "engram": {
      "type": "http",
      "url": "https://mcp.engram.page"
    }
  }
}

2. Recarga. Ejecuta Developer: Reload Window desde la paleta de comandos (Cmd+Shift+P / Ctrl+Shift+P). No hace falta reiniciar VS Code por completo.

3. Autenticación en el primer uso.

La primera vez que Copilot Chat (o tu extensión compatible con MCP) llama a Engram, tu navegador se abre para OAuth. Inicia sesión en Engram, aprueba la conexión y listo. Copilot Chat (o tu extensión compatible con MCP) guarda el token y lo reutiliza a partir de entonces. Hoy la concesión es el scope completo mcp; los scopes granulares por acción están en la hoja de ruta.

4. Dile a VS Code que lo use. Añade el fragmento de abajo a las instrucciones personalizadas de tu espacio de trabajo (Copilot Chat → ajustes → Custom Instructions, o el equivalente de tu extensión).

Engram holds my personal notes — treat it as your long-term memory of me. Search it when a question depends on context I might have shared before. Before saving or updating a note, ask first.

Windsurf

1. Edita la configuración. Añade Engram a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "engram": {
      "url": "https://mcp.engram.page"
    }
  }
}

2. Recarga. Cierra Windsurf por completo y vuelve a abrirlo. Es posible que recargar la ventana no active el registro del servidor MCP.

3. Autenticación en el primer uso.

La primera vez que Windsurf llama a Engram, tu navegador se abre para OAuth. Inicia sesión en Engram, aprueba la conexión y listo. Windsurf guarda el token y lo reutiliza a partir de entonces. Hoy la concesión es el scope completo mcp; los scopes granulares por acción están en la hoja de ruta.

4. Dile a Windsurf que lo use. Añade el fragmento de abajo al panel AI Rules de Windsurf (Workspace → AI Rules) o a ~/.codeium/windsurf/global_rules.md para reglas válidas en todo tu usuario.

Engram holds my personal notes — treat it as your long-term memory of me. Search it when a question depends on context I might have shared before. Before saving or updating a note, ask first.

Zed

1. Edita la configuración. Abre ~/.config/zed/settings.json y añade Engram bajo context_servers (la clave contenedora de Zed, no el estándar mcpServers):

{
  "context_servers": {
    "engram": {
      "url": "https://mcp.engram.page"
    }
  }
}

2. Recarga. Ejecuta zed: reload settings desde la paleta de comandos (Cmd+Shift+P). En casos rebeldes, cierra Zed por completo y vuelve a abrirlo.

3. Autenticación en el primer uso.

La primera vez que el asistente de Zed llama a Engram, tu navegador se abre para OAuth. Inicia sesión en Engram, aprueba la conexión y listo. el asistente de Zed guarda el token y lo reutiliza a partir de entonces. Hoy la concesión es el scope completo mcp; los scopes granulares por acción están en la hoja de ruta.

4. Dile a Zed que lo use. Añade el fragmento de abajo al prompt predeterminado de tu asistente en settings.json (bajo assistant.default_prompt) o desde la interfaz de ajustes del asistente.

Engram holds my personal notes — treat it as your long-term memory of me. Search it when a question depends on context I might have shared before. Before saving or updating a note, ask first.

Otro / Personalizado

1. Edita la configuración. La mayoría de los clientes MCP aceptan el contenedor estándar mcpServers:

{
  "mcpServers": {
    "engram": {
      "url": "https://mcp.engram.page"
    }
  }
}

Si tu cliente no reconoce esta estructura, consulta su documentación para saber qué clave contenedora espera (VS Code usa servers, Zed usa context_servers).

2. Recarga. La mayoría de los clientes necesitan un reinicio completo, no solo recargar la ventana, para registrar servidores MCP nuevos.

3. Autenticación en el primer uso.

La primera vez que el cliente llama a Engram, tu navegador se abre para OAuth. Inicia sesión en Engram, aprueba la conexión y listo. el cliente guarda el token y lo reutiliza a partir de entonces. Hoy la concesión es el scope completo mcp; los scopes granulares por acción están en la hoja de ruta.

4. Dile a tu IA que lo use. Pega el fragmento de abajo donde tu cliente admita instrucciones de sistema o globales persistentes.

Engram holds my personal notes — treat it as your long-term memory of me. Search it when a question depends on context I might have shared before. Before saving or updating a note, ask first.

Autenticación con clave de API

OAuth es la opción predeterminada. Usa una clave de API para acceso sin interfaz o automatizado, para controlar cada conexión por separado (un bot con permiso de escritura frente a un agente de solo lectura) o para compartir una bóveda sin conceder el inicio de sesión completo. Una sola clave autentica tanto MCP como la API REST. Hoy cada clave tiene el acceso completo de tu cuenta; los scopes detallados por clave están en la hoja de ruta.

Obtén una clave

Genera una en app.engram.page/settings/api-keys. Engram muestra la clave completa una sola vez, al crearla, y después solo su prefijo. Trátala como una contraseña y guárdala en un lugar seguro.

Añádela a tu configuración

Añade un bloque headers que envíe la clave como token Bearer. La clave contenedora (mcpServers / servers / context_servers) depende del cliente que estés configurando, así que usa la misma estructura que mostraba tu pestaña de arriba. Para los clientes con el contenedor estándar mcpServers:

{
  "mcpServers": {
    "engram": {
      "type": "http",
      "url": "https://mcp.engram.page",
      "headers": {
        "Authorization": "Bearer engram_YOUR_KEY_HERE"
      }
    }
  }
}

Con una clave de API configurada, no se abre ningún navegador en la primera conexión; la clave autentica de inmediato. Para rotarla, genera una clave nueva en los ajustes y sustituye el valor en tu configuración.

Precaución

Trata la clave como una contraseña. No la subas al control de versiones; mantén las claves de API fuera de los archivos mcp.json que se registran en el repositorio. Usa la sustitución de variables de entorno si tu cliente la admite, o limita la configuración a un archivo a nivel de usuario (no de proyecto).

Solución de problemas

• El cliente no ve Engram tras la edición. Reinicia el cliente por completo, no solo la ventana.
• El navegador nunca se abre para la autenticación. Comprueba que ningún bloqueador de ventanas emergentes lo impida; algunos clientes canalizan la ventana de OAuth mediante su propia lógica de navegador, que falla en silencio si se bloquea.
• Failed to connect. Comprueba que la URL es accesible. Consulta Solución de problemas para ver los problemas comunes a todos los clientes.

Para los flujos con interfaz gráfica de cada cliente, consulta Integraciones de IA.