Memlane

@memlane/mcp

Conecte o Memlane, sua biblioteca pessoal de links e notas salvos, a assistentes de IA que suportam servidores MCP locais.

Pré-requisitos

1. Uma conta no Memlane
2. Uma chave de API em Gerenciar → Conexões → Chaves de API no aplicativo
3. Node.js 18+ (para npx)

Configuração

Este servidor roda localmente via stdio. A maioria dos hosts compatíveis usa o mesmo formato JSON:

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

Variável	Obrigatória	Padrão
MEMLANE_API_KEY	Sim	n/a
MEMLANE_API_URL	Não	https://api.memlane.io

Após npm install -g @memlane/mcp, você pode usar "command": "memlane-mcp" em vez de npx.

Hosts suportados

Host	Onde adicionar a configuração
Cursor	Configurações → MCP, ou .cursor/mcp.json em um projeto
Claude Code	claude mcp add memlane -- npx -y @memlane/mcp (passe -e MEMLANE_API_KEY=…)
Windsurf	~/.codeium/windsurf/mcp_config.json
VS Code + Copilot	.vscode/mcp.json — veja abaixo
Gemini CLI	~/.gemini/settings.json

Para ChatGPT e Claude Desktop, use o endpoint MCP remoto (OAuth, sem chave de API).

Reinicie o aplicativo host após editar os arquivos de configuração.

VS Code

O VS Code usa "servers" como chave raiz (não "mcpServers"):

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

Habilite o MCP nas configurações do VS Code: "chat.mcp.enabled": true.

ChatGPT e hosts MCP remotos

ChatGPT, Claude Desktop, Claude na web e outros clientes MCP remotos não podem executar npx. Use o endpoint hospedado do Memlane:

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

1. No seu aplicativo de IA, adicione um conector MCP personalizado com essa URL.
2. Conclua o fluxo de login OAuth (conta Memlane: link mágico ou futuros provedores sociais).
3. Aprove o acesso na tela de consentimento.

Nenhuma chave de API é necessária. Desconecte removendo o conector nas configurações do seu aplicativo de IA.

Ferramentas

O servidor local expõe 10 ferramentas MCP. Referência completa das funções:

• docs/TOOLS.md — o que cada ferramenta faz, parâmetros, formatos de retorno e dicas de fluxo de trabalho
• docs/API.md — mapeamentos REST, escopos de autenticação e exemplos com curl

Ferramenta	Descrição
search_saves	Busca semântica na sua biblioteca
list_saves	Navegue pelos salvos com filtros (projeto, tópico, tipo, status)
get_save	Busca metadados; corpo markdown completo opcional
capture_url	Salva uma URL (o enriquecimento roda em segundo plano)
create_note / update_note	Cria ou edita notas em markdown
list_projects / list_topics	Lista projetos e tópicos
add_topic_to_save / remove_topic_from_save	Adiciona ou remove etiquetas de um salvo

Segurança

Chaves de API são segredos. Armazene-as na configuração de ambiente do seu host MCP. Nunca as envie para o controle de versão. Revogue uma chave vazada em Gerenciar → Conexões → Chaves de API.

Licença

MIT