Claude Desktop

La interfaz de Connectors de Claude Desktop es el camino más fluido para conectar Engram. Basta con pegar la URL e iniciar sesión, sin archivos de configuración ni claves de API que copiar. Para saber qué ocurre por debajo, 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.

Configuración

1. Abre la página Add Engram connector. Inicia la configuración de conectores de Claude con el nombre y la URL de Engram ya rellenados. Estos ajustes se aplican tanto a la aplicación de escritorio como a claude.ai.

   ¿Prefieres hacerlo manualmente? Ve a claude.ai/customize/connectors y pulsa el botón + para añadir un conector personalizado.

2. Rellena los dos campos y haz clic en Add. Ambos aparecen ya rellenados si abriste el modal desde el enlace de arriba; si no, escríbelos tú.

   Name: el que quieras, por ejemplo:

   Engram

   Remote MCP server URL:

   https://mcp.engram.page

3. Se abre una ventana de autorización en el navegador. Consulta Autenticación en el primer uso para saber qué esperar.

4. Revisa los permisos solicitados en la pantalla de scope y aprueba.

5. Dile a Claude cómo usarlo para que recurra a Engram automáticamente.

6. Pruébalo para confirmar que el conector funciona.

Autenticación en el primer uso

La primera vez que te conectas, Claude Desktop abre una ventana del navegador en la que se te pide iniciar sesión en Engram. Inicia sesión, marca los permisos que quieras conceder y haz clic en Approve. El navegador te devuelve a Claude Desktop automáticamente. Sin copiar y pegar tokens, sin variables de entorno. Es el mismo tipo de inicio de sesión que usarías para conectar cualquier aplicación a Google, Dropbox o GitHub.

Si prefieres omitir el flujo con navegador (configuraciones sin interfaz, automatizadas o con bóveda compartida), puedes autenticarte con una clave de API. Consulta Configuración de MCP → Autenticación con clave de API.

Dile a Claude cómo usarlo

Añadir el conector es solo la mitad del trabajo. Claude no recurrirá a Engram a menos que se lo indiques. Añade una instrucción breve a las preferencias globales de Claude para que todas las conversaciones sepan usar Engram como memoria.

1. Abre claude.ai/settings/general.
2. Busca el campo What personal preferences should Claude consider in responses? (el cuadro de instrucciones globales).
3. Pega este fragmento. Mantenlo en su propia línea para que siga vigente en todas las conversaciones:

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.

Ahora Claude recurre a Engram automáticamente cuando necesita consultar o guardar algo que hayas compartido.

Pruébalo

Una vez conectado y con el prompt global configurado, el conector aparece en tu barra lateral. Prueba a preguntar:

• 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.
• Lee mi nota titulada 'Planificación del T3' y extrae las tareas pendientes.
• Muéstrame el frontmatter y los enlaces salientes de 'project-ideas.md'.
• Redacta una nota nueva titulada 'Reunión con diseño, 21 de mayo' en mi carpeta 'Notas de reuniones' con las conclusiones de hoy.
• Añade una sección 'Decisiones' a 'roadmap.md' con estos tres puntos.
• Enumera las carpetas de primer nivel de mi bóveda.
• Mueve todo lo que haya en 'inbox' y mencione 'T4' a 'Q4-planning'.

Claude llama a la herramienta search de Engram (o get_note, write_note, etc.), trae los resultados y responde en contexto.

Scopes concedidos

Claude Desktop solicita el scope mcp en la pantalla de aprobación. Es una única concesión que cubre toda la superficie de herramientas MCP sobre tu bóveda. Los scopes granulares por acción (solo lectura, sin borrado, etc.) están en la hoja de ruta. Consulta Scopes para ver los detalles y el flujo de revocación.

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

• La ventana de autorización nunca se abre. Comprueba que Claude Desktop está en la última versión y que no hay ningún bloqueador de ventanas emergentes activo.
• “Connector failed to load.” Confirma que la URL de MCP es accesible. Pégala en una pestaña del navegador. Si ves una página de respuesta estructurada en lugar de un error, la conexión está bien y el problema está en Claude Desktop. Reinícialo y vuelve a intentarlo.

Para fallos comunes a todos los clientes (autenticación rechazada, errores de scope, huecos de sincronización), consulta Solución de problemas.

Revocación

La desconexión surte efecto desde cualquiera de los dos lados. Elige el que te resulte más cómodo:

Desde la aplicación de Claude: abre Settings → Connectors, busca Engram y elige Disconnect.

Desde Claude en la web: ve a claude.ai/customize/connectors, haz clic en el conector de Engram y elige Disconnect.

Desde Engram: ve a app.engram.page/settings/connections y desconecta la sesión.

En cualquier caso, el token OAuth se invalida en el servidor y Claude Desktop tendrá que volver a autenticarse para reconectarse.

Siguientes pasos

MCPResumen del protocolo.

ScopesElige los permisos mínimos.

Todas las integracionesElige otro cliente.