Cursor

O Cursor tem suporte de primeira classe a MCP. Crie um arquivo mcp.json, reinicie o Cursor, e o OAuth roda no seu navegador na primeira vez que o agente recorre ao Engram. Para o contexto do protocolo, veja MCP.

Pré-requisitos

Antes de começar, confirme:

• Você tem uma conta do Engram em app.engram.page.
• Pelo menos um cofre está sincronizado. Abra o plugin do Obsidian ou o app web e confirme que as notas foram sincronizadas no último dia.
• Você consegue entrar pelo navegador. O fluxo de autenticação do MCP abre uma janela do navegador.
• Se você pretende usar uma chave de API em vez do OAuth: chaves de API exigem o Pro. O login por OAuth funciona em todos os planos, inclusive o Free, e é o caminho recomendado. Free e Starter não podem criar nem usar chaves de API.

Endpoint

https://mcp.engram.page

Configuração

1. Edite o mcp.json. Crie ou edite o ~/.cursor/mcp.json (global do usuário) ou o .cursor/mcp.json na raiz do projeto (escopo de projeto, sobrepõe o global para o mesmo nome de servidor):

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

2. Reinicie o Cursor. Feche por completo (Cmd+Q / File → Exit) e abra de novo. Recarregar a janela não basta; os servidores MCP são registrados na inicialização do app.

3. Verifique. Abra Settings → Tools & MCP e confirme que o engram aparece na lista de servidores.

Primeira autenticação

O Cursor não pede o OAuth ao conectar. Ele dispara na primeira chamada de ferramenta. Abra um chat novo e peça ao agente que pesquise no seu Engram. Seu navegador abre para você entrar no Engram e aprovar a conexão. O Cursor guarda o token e o reutiliza dali em diante. A concessão é o escopo mcp completo. Escopos granulares por ação estão no roteiro.

Para pular o OAuth (em configurações headless ou de cofre compartilhado), troque o bloco por uma chave de API:

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

Obtenha uma chave em app.engram.page/settings/api-keys.

Diga ao Cursor como usá-lo

Adicione o trecho abaixo às Rules do Cursor: ~/.cursor/rules (escopo de usuário) ou um arquivo .cursor/rules/*.mdc em um projeto.

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.

Experimente

Com tudo conectado, pergunte ao agente do Cursor:

• Pesquise no meu cofre as notas sobre o processo de entrevistas de engenharia e resuma as três principais.
• Encontre tudo o que escrevi sobre embeddings no último mês.

O Cursor chama a ferramenta search do Engram (ou get_note, write_note etc.), traz os resultados e responde no contexto. Se a ferramenta disparar, está tudo certo.

Solução de problemas (específico do Cursor)

• Duas entradas engram em Tools & MCP. O servidor está definido tanto em ~/.cursor/mcp.json quanto em .cursor/mcp.json. Remova uma (a de escopo de projeto prevalece).
• O servidor aparece em Settings, mas o agente nunca o chama. Problema conhecido de injeção da configuração global em algumas versões do Cursor. Contorno: mova a configuração para o .cursor/mcp.json no nível do projeto.
• O OAuth nunca é solicitado. O agente ainda não invocou uma ferramenta. Force: peça ao agente que chame a ferramenta search do engram pelo nome. Se continuar em silêncio, reinicie o Cursor; um estado de conexão obsoleto pode bloquear a primeira chamada.

Para falhas comuns a todos os clientes, veja Solução de problemas.

Revogação

Para desconectar Cursor do Engram:

1. Em Cursor, encontre a entrada do conector ou do servidor MCP e remova-a.
2. No Engram, abra sua conta → API Keys & Sessions e revogue a sessão correspondente.
3. O token OAuth é invalidado no servidor. Cursor precisará se autenticar de novo para reconectar.

Para remover do lado do cliente, apague o bloco engram do seu mcp.json e reinicie o Cursor.

Próximos passos

MCPVisão geral do protocolo.

EscoposO que a concessão cobre.

Todas as integraçõesEscolha outro cliente.