Memlane

@memlane/mcp

Conecta Memlane, tu biblioteca personal de enlaces y notas guardados, a asistentes de IA que admiten servidores MCP locales.

Requisitos previos

1. Una cuenta de Memlane
2. Una clave de API desde Gestionar → Conexiones → Claves de API en la aplicación
3. Node.js 18+ (para npx)

Configuración

Este servidor se ejecuta localmente mediante stdio. La mayoría de los hosts compatibles usan la misma forma JSON:

{
  "mcpServers": {
    "memlane": {
      "command": "npx",
      "args": ["-y", "@memlane/mcp"],
      "env": {
        "MEMLANE_API_KEY": "ml_live_…"
      }
    }
  }
}

Variable	Requerido	Predeterminado
MEMLANE_API_KEY	Sí	n/a
MEMLANE_API_URL	No	https://api.memlane.io

Después de npm install -g @memlane/mcp, puedes usar "command": "memlane-mcp" en lugar de npx.

Hosts compatibles

Host	Dónde agregar la configuración
Cursor	Configuración → MCP, o .cursor/mcp.json en un proyecto
Claude Code	claude mcp add memlane -- npx -y @memlane/mcp (pasa -e MEMLANE_API_KEY=…)
Windsurf	~/.codeium/windsurf/mcp_config.json
VS Code + Copilot	.vscode/mcp.json — ver abajo
Gemini CLI	~/.gemini/settings.json

Para ChatGPT y Claude Desktop, usa el punto de conexión MCP remoto en su lugar (OAuth, sin clave de API).

Reinicia la aplicación host después de editar los archivos de configuración.

VS Code

VS Code usa "servers" como clave raíz (no "mcpServers"):

{
  "servers": {
    "memlane": {
      "command": "npx",
      "args": ["-y", "@memlane/mcp"],
      "env": {
        "MEMLANE_API_KEY": "ml_live_…"
      }
    }
  }
}

Habilita MCP en la configuración de VS Code: "chat.mcp.enabled": true.

ChatGPT y hosts MCP remotos

ChatGPT, Claude Desktop, Claude en la web y otros clientes MCP remotos no pueden ejecutar npx. Usa el punto de conexión alojado de Memlane en su lugar:

URL: https://api.memlane.io/mcp

1. En tu aplicación de IA, agrega un conector MCP personalizado con esa URL.
2. Completa el flujo de inicio de sesión OAuth (cuenta de Memlane: enlace mágico o futuros proveedores sociales).
3. Aprueba el acceso en la pantalla de consentimiento.

No se requiere clave de API. Desconéctate eliminando el conector en la configuración de tu aplicación de IA.

Herramientas

El servidor local expone 10 herramientas MCP. Referencia completa de funciones:

• docs/TOOLS.md — qué hace cada herramienta, parámetros, formas de retorno y consejos de flujo de trabajo
• docs/API.md — asignaciones REST, alcances de autenticación y ejemplos de curl

Herramienta	Descripción
search_saves	Búsqueda semántica en tu biblioteca
list_saves	Explora guardados con filtros (proyecto, tema, tipo, estado)
get_save	Obtener metadatos; cuerpo markdown completo opcional
capture_url	Guardar una URL (el enriquecimiento se ejecuta en segundo plano)
create_note / update_note	Crear o editar notas markdown
list_projects / list_topics	Listar proyectos y temas
add_topic_to_save / remove_topic_from_save	Etiquetar o desetiquetar un guardado

Seguridad

Las claves de API son secretos. Guárdalas en la configuración de entorno de tu host MCP. Nunca las confirmes en el control de versiones. Revoca una clave filtrada en Gestionar → Conexiones → Claves de API.

Licencia

MIT