Como Conectar o LMCP ao Cursor (Configuração MCP)

O Passo que a Maioria dos Usuários do Cursor Ignora

Quando você executa npx -y local-mcp@latest setup, o instalador grava a configuração do LMCP em ~/.cursor/mcp.json automaticamente. Mas, diferentemente do Claude Desktop, o Cursor não ativa novos servidores MCP por padrão — você precisa habilitá-los nas Configurações.

Esse único passo ausente é o motivo pelo qual a maioria dos usuários do Cursor instala o LMCP, mas nunca o vê funcionando.

Passo 1: Instale o LMCP

Execute isto no seu terminal:

npx -y local-mcp@latest setup

O instalador detectará o Cursor e gravará a configuração do MCP. Você deverá ver ✓ Cursor configured na saída.

Passo 2: Encerre o Cursor Completamente

Pressione Cmd+Q para encerrar o Cursor (não apenas fechar a janela). O Cursor só lê sua configuração do MCP na inicialização, então uma reinicialização completa é necessária.

Passo 3: Reabra o Cursor

Inicie o Cursor novamente a partir do Applications ou do Spotlight.

Passo 4: Habilite o LMCP nas Configurações do Cursor

1. Abra as Cursor Settings — clique no ícone de engrenagem (⚙) no canto inferior esquerdo, ou pressione Cmd+Shift+J
2. Vá em Features → MCP Servers (ou pesquise por “MCP” na barra de busca das configurações)
3. Encontre local-mcp na lista
4. Habilite-o em ON se ainda não estiver ativado

Uma vez habilitado, você deverá ver um indicador de status verde ao lado de “local-mcp”. As 100 ferramentas do LMCP agora estão disponíveis no seu chat do Cursor.

Passo 5: Teste

Abra uma janela de chat do Cursor e digite:

Summarize my unread emails

O Cursor solicitará permissões do macOS no primeiro uso (Calendar, Contacts, Mail) — aprove cada uma. Depois disso, as ferramentas funcionam instantaneamente, sem precisar autorizar novamente.

Configuração Manual (se a configuração automática não funcionou)

Se o instalador não configurou o Cursor automaticamente, adicione isto a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "local-mcp": {
      "command": "npx",
      "args": ["-y", "local-mcp@latest"]
    }
  }
}

Em seguida, siga os Passos 2–5 acima.

Solução de Problemas

Ferramentas não aparecem no chat

• Confirme que o botão em Cursor Settings → MCP Servers está ON
• Encerre e reabra o Cursor após habilitar o botão
• Execute npx -y local-mcp@latest status no seu terminal para verificar se o servidor está em execução

Erro de permissão na primeira chamada de ferramenta

• O macOS solicitará acesso a Calendar, Contacts ou Mail — clique em Allow
• Se você negou uma permissão, vá em System Settings → Privacy & Security e reative-a

O servidor aparece como “failed” nas Configurações do Cursor

• Certifique-se de que o Node.js 18 ou posterior está instalado: node --version
• Execute npx -y local-mcp@latest setup novamente para baixar o runtime de novo

O Que Você Pode Fazer Agora

Com o LMCP conectado, experimente estes comandos no chat do Cursor:

• E-mail: “Read my last 10 emails”
• Calendário: “What’s on my calendar today?”
• Teams: “Summarize the last messages in my Teams #engineering channel”
• Arquivos: “Search my Mac for files named design-spec”
• Resumo matinal: “Give me a morning briefing: emails, calendar, and Teams”