Claude Code

La CLI claude mcp add de Claude Code se encarga de editar la configuración por ti y mantiene el registro limitado a un proyecto o a un usuario. OAuth se ejecuta en tu navegador la primera vez que llamas a una herramienta de Engram. Para conocer el protocolo, consulta MCP.

Requisitos previos

Antes de empezar, confirma que:

• Tienes una cuenta de Engram en app.engram.page.
• Al menos una bóveda está sincronizada. Abre el plugin de Obsidian o la aplicación web y confirma que las notas se han sincronizado en el último día.
• Puedes iniciar sesión desde el navegador. El flujo de autenticación de MCP abre una ventana del navegador.
• Si piensas usar una clave de API en lugar de OAuth: las claves de API requieren Pro. El inicio de sesión con OAuth funciona en todos los planes, incluido Free, y es el camino recomendado. Free y Starter no pueden crear ni usar claves de API.

Endpoint

https://mcp.engram.page

Configuración

1. Registra Engram con la CLI de Claude Code.

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

--scope user hace que Engram esté disponible en todos los proyectos. Usa --scope project en su lugar para limitar Engram al .mcp.json del repositorio actual.

¿Prefieres editarlo a mano? Añade el bloque de abajo 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. Debería aparecer con el estado △ needs authentication.

Autenticación en el primer uso

Claude Code no solicita OAuth automáticamente. En una sesión nueva, ejecuta /mcp, selecciona engram y elige Authenticate. Tu navegador se abre para que inicies sesión en Engram y apruebes la conexión. Claude Code guarda el token y lo reutiliza a partir de entonces. La concesión es el scope completo mcp. Los scopes granulares por acción están en la hoja de ruta.

Dile a Claude cómo usarlo

Añade el fragmento de abajo a ~/.claude/CLAUDE.md, el archivo de instrucciones a nivel de usuario de Claude Code. Se aplica a todos los proyectos. Los ajustes específicos de un repositorio van en un CLAUDE.md a nivel de proyecto en la raíz del repositorio.

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.

Pruébalo

Una vez registrado y autenticado, pregunta a Claude:

• Busca en mi bóveda notas sobre el proceso de entrevistas de ingeniería y resume las tres más relevantes.
• Encuentra todo lo que escribí sobre embeddings en el último mes.

Claude llama a la herramienta search de Engram (o get_note, write_note, etc.), trae los resultados y responde en contexto. Si la herramienta se activa, todo está listo.

Clave de API en lugar de OAuth

Para equipos sin interfaz, CI o una bóveda compartida, omite OAuth y fija la conexión a una clave de API de Engram. Genera una en app.engram.page/settings/api-keys y envíala como encabezado Bearer.

La versión rápida escribe la clave directamente en el archivo de configuración:

claude mcp add --transport http --scope user engram https://mcp.engram.page \
  --header "Authorization: Bearer engram_YOUR_KEY_HERE"

Eso está bien con --scope user (~/.claude.json se queda en tu equipo). No está bien con --scope project, porque .mcp.json está pensado para subirse al repositorio. Carga la clave desde el entorno.

Carga la clave desde una variable de entorno

Claude Code expande ${VAR} y ${VAR:-default} al leer .mcp.json. En los servidores HTTP, la expansión cubre los campos url y headers, que es justo donde va una clave de API. Sube esto al repositorio:

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

En el repositorio solo está el nombre de la variable. Cada colaborador aporta su propia clave y Engram limita cada una a su propia cuenta, de modo que un .mcp.json compartido nunca implica una bóveda compartida.

Claude Code lee el entorno con el que se lanzó, así que exporta la clave antes de iniciar claude:

export ENGRAM_API_KEY="engram_YOUR_KEY_HERE"

Para una clave por repositorio, usa direnv y guarda el valor en un .envrc ignorado por git:

export ENGRAM_API_KEY="engram_YOUR_KEY_HERE"

Ejecuta direnv allow una vez y luego lanza claude desde ese directorio.

Precaución

Si la variable no está definida, la configuración se carga igualmente y Claude Code envía la cadena literal Bearer ${ENGRAM_API_KEY}, que Engram rechaza con un 401. claude mcp list lo señala:

[Warning] [engram] mcpServers.engram: Missing environment variables: ENGRAM_API_KEY

Busca esa línea primero cuando una configuración con clave no conecte.

Con una clave en uso cambian dos cosas. No se abre ningún navegador en la primera conexión y /mcp deja de ofrecer Authenticate: definir un encabezado Authorization desactiva por completo la alternativa OAuth. Consulta Configuración de MCP → Autenticación con clave de API para saber qué cubre una clave y cómo rotarla.

Solución de problemas (específica de Claude Code)

• claude mcp list no muestra engram. El comando se ejecutó en un ámbito distinto del esperado. Busca la entrada tanto en ~/.claude.json (usuario) como en .mcp.json (proyecto) y vuelve a ejecutar claude mcp add con la opción --scope correcta.
• /mcp no muestra engram en el selector. No saliste ni volviste a iniciar la CLI después de claude mcp add. Reinicia claude.
• La opción Authenticate no hace nada, o el navegador nunca se abre. Una sesión sin interfaz o remota no puede abrir un navegador. Ejecuta Claude Code en un equipo con navegador de escritorio, o usa una clave de API.

Para fallos comunes a todos los clientes, consulta Solución de problemas.

Revocación

Para desconectar Claude Code de Engram:

1. En Claude Code, busca la entrada del conector o del servidor MCP y elimínala.
2. En Engram, abre tu cuenta → API Keys & Sessions y revoca la sesión correspondiente.
3. El token OAuth se invalida en el servidor. Claude Code tendrá que volver a autenticarse para reconectarse.

También puedes quitar el registro en local con claude mcp remove engram. Eso elimina la entrada de configuración, pero deja activo el token del servidor hasta que lo revoques en Engram.

Siguientes pasos

MCPResumen del protocolo.

ScopesQué cubre la concesión.

Todas las integracionesElige otro cliente.