{"title":"MCP no Cursor","slug":"cursor","category":"mcp","summary":"Conecte o Synapse ao IDE Cursor para memória persistente de projeto entre sessões de codificação.","audience":["human"],"tags":["mcp","cursor","ide","coding"],"difficulty":"intermediate","updated":"2026-06-27","word_count":322,"read_minutes":2,"lang":"pt","translated":true,"requested_lang":"pt","content_markdown":"\n# MCP no Cursor\n\nCursor é uma IDE com IA baseada no VS Code. Com o MCP do Synapse, o Cursor\nganha memória persistente entre sessões — ele lembra suas decisões de projeto,\npadrões de codebase e sessões de depuração passadas.\n\n## Pré-requisitos\n\n- IDE Cursor instalada ()\n- Node.js 18+\n- Sua Mind Key do Synapse\n\n## Configuração\n\n### Passo 1: abra as configurações do Cursor\n\nNo Cursor:\n\n1. Abra Settings (Cmd+, no macOS, Ctrl+, no Windows/Linux)\n2. Busque por \"MCP\" ou navegue até `Cursor Settings → MCP Servers`\n\n### Passo 2: adicione o servidor MCP do Synapse\n\nClique em \"Add MCP Server\" e configure:\n\n| Campo | Valor |\n|-------|-------|\n| Name | `synapse` |\n| Type | `stdio` |\n| Command | `npx -y synapse-mcp-api@latest` |\n| Env | `SYNAPSE_MIND_KEY=mk_YOUR_KEY, SYNAPSE_URL=https://synapse.schaefer.zone` |\n\n### Passo 3: edite config.json diretamente (alternativa)\n\nO Cursor armazena a config MCP em `~/.cursor/config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"synapse\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"synapse-mcp-api@latest\"],\n \"env\": {\n \"SYNAPSE_MIND_KEY\": \"mk_YOUR_MIND_KEY_HERE\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\"\n }\n }\n }\n}\n```\n\n### Passo 4: reinicie o Cursor\n\nReinicie totalmente o Cursor (Cmd+Q e reabra no macOS).\n\n## Verifique se funciona\n\nNo painel de chat do Cursor (Cmd+L):\n\n```\nrecall all my memories\n```\n\nCursor deve chamar `memory_recall` e responder com suas memórias armazenadas.\n\n## Padrões comuns\n\n### Onboarding de projeto\n\nAo abrir um novo projeto:\n\n```\nrecalling project context — what do I know about this codebase?\n```\n\nCursor chama `memory_recall` e continua o trabalho de onde você parou.\n\n### Decisões de arquitetura\n\n```\nstore this decision: \"Using Fastify instead of Express for this project\nbecause of schema validation. Date: 2026-06-27.\"\n```\n\nCursor armazena como uma memória `project` com prioridade `high`.\n\n### Histórico de depuração\n\n```\nwhat bugs have I hit in this codebase?\n```\n\nCursor busca memórias `mistake` e o lembra de correções passadas.\n\n### Padrões de código cross-sessão\n\n```\nsearch memories: \"authentication pattern\"\n```\n\nCursor encontra memórias sobre implementações de auth que você fez antes.\n\n## Troubleshooting\n\n### Servidor MCP não conecta\n\n1. Verifique o Node.js: `node --version` (≥ 18)\n2. Teste o servidor MCP: `npx -y synapse-mcp-api@latest` (deve iniciar sem erros)\n3. Confira os logs MCP do Cursor (View → Output → MCP)\n4. Reinicie totalmente o Cursor\n\n### Ferramentas não aparecem\n\n- Confira se `~/.cursor/config.json` é JSON válido\n- Verifique se a env var `SYNAPSE_MIND_KEY` está definida\n- Confira se a versão do Cursor suporta MCP (≥ 0.42)\n\n### Mind Key inválida\n\n```bash\n# Test your Mind Key directly\ncurl -H \"Authorization: Bearer mk_YOUR_KEY\" \\\n https://synapse.schaefer.zone/memory/recall\n```\n\n## Próximos passos\n\n- [Configuração do Claude Desktop](/docs/mcp/claude-desktop)\n- [Configuração do Continue.dev](/docs/mcp/continue)\n- [Guia de agente LLM persistente](/docs/guides/persistent-llm-agent)\n","content_html":"

MCP no Cursor

\n

Cursor é uma IDE com IA baseada no VS Code. Com o MCP do Synapse, o Cursor\nganha memória persistente entre sessões — ele lembra suas decisões de projeto,\npadrões de codebase e sessões de depuração passadas.

\n

Pré-requisitos

\n\n

Configuração

\n

Passo 1: abra as configurações do Cursor

\n

No Cursor:

\n
    \n
  1. Abra Settings (Cmd+, no macOS, Ctrl+, no Windows/Linux)
    2. \n
  2. Busque por "MCP" ou navegue até Cursor Settings → MCP Servers
    3. \n
\n

Passo 2: adicione o servidor MCP do Synapse

\n

Clique em "Add MCP Server" e configure:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
CampoValor
Namesynapse
Typestdio
Commandnpx -y synapse-mcp-api@latest
EnvSYNAPSE_MIND_KEY=mk_YOUR_KEY, SYNAPSE_URL=https://synapse.schaefer.zone
\n

Passo 3: edite config.json diretamente (alternativa)

\n

O Cursor armazena a config MCP em ~/.cursor/config.json:

\n
{\n  "mcpServers": {\n    "synapse": {\n      "command": "npx",\n      "args": ["-y", "synapse-mcp-api@latest"],\n      "env": {\n        "SYNAPSE_MIND_KEY": "mk_YOUR_MIND_KEY_HERE",\n        "SYNAPSE_URL": "https://synapse.schaefer.zone"\n      }\n    }\n  }\n}

Passo 4: reinicie o Cursor

\n

Reinicie totalmente o Cursor (Cmd+Q e reabra no macOS).

\n

Verifique se funciona

\n

No painel de chat do Cursor (Cmd+L):

\n
recall all my memories

Cursor deve chamar memory_recall e responder com suas memórias armazenadas.

\n

Padrões comuns

\n

Onboarding de projeto

\n

Ao abrir um novo projeto:

\n
recalling project context — what do I know about this codebase?

Cursor chama memory_recall e continua o trabalho de onde você parou.

\n

Decisões de arquitetura

\n
store this decision: "Using Fastify instead of Express for this project\nbecause of schema validation. Date: 2026-06-27."

Cursor armazena como uma memória project com prioridade high.

\n

Histórico de depuração

\n
what bugs have I hit in this codebase?

Cursor busca memórias mistake e o lembra de correções passadas.

\n

Padrões de código cross-sessão

\n
search memories: "authentication pattern"

Cursor encontra memórias sobre implementações de auth que você fez antes.

\n

Troubleshooting

\n

Servidor MCP não conecta

\n
    \n
  1. Verifique o Node.js: node --version (≥ 18)
    2. \n
  2. Teste o servidor MCP: npx -y synapse-mcp-api@latest (deve iniciar sem erros)
    3. \n
  3. Confira os logs MCP do Cursor (View → Output → MCP)
    4. \n
  4. Reinicie totalmente o Cursor
    5. \n
\n

Ferramentas não aparecem

\n\n

Mind Key inválida

\n
# Test your Mind Key directly\ncurl -H "Authorization: Bearer mk_YOUR_KEY" \\\n     https://synapse.schaefer.zone/memory/recall

Próximos passos

\n\n","urls":{"html":"/docs/mcp/cursor","text":"/docs/mcp/cursor?format=text","json":"/docs/mcp/cursor?format=json","llm":"/docs/mcp/cursor?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}