{"title":"MCP en Cursor","slug":"cursor","category":"mcp","summary":"Conecte Synapse al IDE Cursor para memoria persistente del proyecto entre sesiones de codificación.","audience":["human"],"tags":["mcp","cursor","ide","coding"],"difficulty":"intermediate","updated":"2026-06-27","word_count":327,"read_minutes":2,"lang":"es","translated":true,"requested_lang":"es","content_markdown":"\n# MCP en Cursor\n\nCursor es un IDE con IA basado en VS Code. Con Synapse MCP, Cursor gana memoria\npersistente entre sesiones — recuerda las decisiones del proyecto, los patrones\ndel codebase y las sesiones de depuración pasadas.\n\n## Requisitos previos\n\n- IDE Cursor instalado (<https://cursor.com>)\n- Node.js 18+\n- Su Mind Key de Synapse\n\n## Configuración\n\n### Paso 1: Abrir la configuración de Cursor\n\nEn Cursor:\n\n1. Abra Settings (Cmd+, en macOS, Ctrl+, en Windows/Linux)\n2. Busque \"MCP\" o navegue a `Cursor Settings → MCP Servers`\n\n### Paso 2: Añadir el servidor MCP de Synapse\n\nHaga clic en \"Add MCP Server\" y 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### Paso 3: Editar config.json directamente (alternativa)\n\nCursor almacena la configuración MCP en `~/.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### Paso 4: Reiniciar Cursor\n\nReinicie Cursor completamente (Cmd+Q y vuelva a abrir en macOS).\n\n## Verifique que funciona\n\nEn el panel de chat de Cursor (Cmd+L):\n\n```\nrecall all my memories\n```\n\nCursor debería llamar a `memory_recall` y responder con sus memorias\nalmacenadas.\n\n## Patrones comunes\n\n### Onboarding del proyecto\n\nAl abrir un proyecto nuevo:\n\n```\nrecalling project context — what do I know about this codebase?\n```\n\nCursor llama a `memory_recall` y continúa el trabajo donde lo dejó.\n\n### Decisiones de arquitectura\n\n```\nstore this decision: \"Using Fastify instead of Express for this project\nbecause of schema validation. Date: 2026-06-27.\"\n```\n\nCursor lo almacena como una memoria `project` con prioridad `high`.\n\n### Historial de depuración\n\n```\nwhat bugs have I hit in this codebase?\n```\n\nCursor busca memorias `mistake` y le recuerda las correcciones pasadas.\n\n### Patrones de código entre sesiones\n\n```\nsearch memories: \"authentication pattern\"\n```\n\nCursor encuentra memorias sobre implementaciones de auth que ha hecho antes.\n\n## Solución de problemas\n\n### El servidor MCP no conecta\n\n1. Verifique Node.js: `node --version` (≥ 18)\n2. Pruebe el servidor MCP: `npx -y synapse-mcp-api@latest` (debería arrancar sin errores)\n3. Revise los logs MCP de Cursor (View → Output → MCP)\n4. Reinicie Cursor completamente\n\n### Las herramientas no aparecen\n\n- Compruebe que `~/.cursor/config.json` es JSON válido\n- Verifique que la variable de entorno `SYNAPSE_MIND_KEY` está establecida\n- Compruebe que la versión de Cursor admite MCP (≥ 0.42)\n\n### Mind Key inválido\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 pasos\n\n- [Configuración de Claude Desktop](/docs/mcp/claude-desktop)\n- [Configuración de Continue.dev](/docs/mcp/continue)\n- [Guía de agente LLM persistente](/docs/guides/persistent-llm-agent)\n","content_html":"<h1>MCP en Cursor</h1>\n<p>Cursor es un IDE con IA basado en VS Code. Con Synapse MCP, Cursor gana memoria\npersistente entre sesiones — recuerda las decisiones del proyecto, los patrones\ndel codebase y las sesiones de depuración pasadas.</p>\n<h2>Requisitos previos</h2>\n<ul>\n<li>IDE Cursor instalado (<a href=\"https://cursor.com\">https://cursor.com</a>)</li>\n<li>Node.js 18+</li>\n<li>Su Mind Key de Synapse</li>\n</ul>\n<h2>Configuración</h2>\n<h3>Paso 1: Abrir la configuración de Cursor</h3>\n<p>En Cursor:</p>\n<ol>\n<li>Abra Settings (Cmd+, en macOS, Ctrl+, en Windows/Linux)</li>\n<li>Busque &quot;MCP&quot; o navegue a <code>Cursor Settings → MCP Servers</code></li>\n</ol>\n<h3>Paso 2: Añadir el servidor MCP de Synapse</h3>\n<p>Haga clic en &quot;Add MCP Server&quot; y configure:</p>\n<table>\n<thead>\n<tr>\n<th>Campo</th>\n<th>Valor</th>\n</tr>\n</thead>\n<tbody><tr>\n<td>Name</td>\n<td><code>synapse</code></td>\n</tr>\n<tr>\n<td>Type</td>\n<td><code>stdio</code></td>\n</tr>\n<tr>\n<td>Command</td>\n<td><code>npx -y synapse-mcp-api@latest</code></td>\n</tr>\n<tr>\n<td>Env</td>\n<td><code>SYNAPSE_MIND_KEY=mk_YOUR_KEY, SYNAPSE_URL=https://synapse.schaefer.zone</code></td>\n</tr>\n</tbody></table>\n<h3>Paso 3: Editar config.json directamente (alternativa)</h3>\n<p>Cursor almacena la configuración MCP en <code>~/.cursor/config.json</code>:</p>\n<pre><code class=\"hljs language-json\"><span class=\"hljs-punctuation\">{</span>\n  <span class=\"hljs-attr\">&quot;mcpServers&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">{</span>\n    <span class=\"hljs-attr\">&quot;synapse&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">{</span>\n      <span class=\"hljs-attr\">&quot;command&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;npx&quot;</span><span class=\"hljs-punctuation\">,</span>\n      <span class=\"hljs-attr\">&quot;args&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">[</span><span class=\"hljs-string\">&quot;-y&quot;</span><span class=\"hljs-punctuation\">,</span> <span class=\"hljs-string\">&quot;synapse-mcp-api@latest&quot;</span><span class=\"hljs-punctuation\">]</span><span class=\"hljs-punctuation\">,</span>\n      <span class=\"hljs-attr\">&quot;env&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">{</span>\n        <span class=\"hljs-attr\">&quot;SYNAPSE_MIND_KEY&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;mk_YOUR_MIND_KEY_HERE&quot;</span><span class=\"hljs-punctuation\">,</span>\n        <span class=\"hljs-attr\">&quot;SYNAPSE_URL&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;https://synapse.schaefer.zone&quot;</span>\n      <span class=\"hljs-punctuation\">}</span>\n    <span class=\"hljs-punctuation\">}</span>\n  <span class=\"hljs-punctuation\">}</span>\n<span class=\"hljs-punctuation\">}</span></code></pre><h3>Paso 4: Reiniciar Cursor</h3>\n<p>Reinicie Cursor completamente (Cmd+Q y vuelva a abrir en macOS).</p>\n<h2>Verifique que funciona</h2>\n<p>En el panel de chat de Cursor (Cmd+L):</p>\n<pre><code class=\"hljs language-plaintext\">recall all my memories</code></pre><p>Cursor debería llamar a <code>memory_recall</code> y responder con sus memorias\nalmacenadas.</p>\n<h2>Patrones comunes</h2>\n<h3>Onboarding del proyecto</h3>\n<p>Al abrir un proyecto nuevo:</p>\n<pre><code class=\"hljs language-plaintext\">recalling project context — what do I know about this codebase?</code></pre><p>Cursor llama a <code>memory_recall</code> y continúa el trabajo donde lo dejó.</p>\n<h3>Decisiones de arquitectura</h3>\n<pre><code class=\"hljs language-plaintext\">store this decision: &quot;Using Fastify instead of Express for this project\nbecause of schema validation. Date: 2026-06-27.&quot;</code></pre><p>Cursor lo almacena como una memoria <code>project</code> con prioridad <code>high</code>.</p>\n<h3>Historial de depuración</h3>\n<pre><code class=\"hljs language-plaintext\">what bugs have I hit in this codebase?</code></pre><p>Cursor busca memorias <code>mistake</code> y le recuerda las correcciones pasadas.</p>\n<h3>Patrones de código entre sesiones</h3>\n<pre><code class=\"hljs language-plaintext\">search memories: &quot;authentication pattern&quot;</code></pre><p>Cursor encuentra memorias sobre implementaciones de auth que ha hecho antes.</p>\n<h2>Solución de problemas</h2>\n<h3>El servidor MCP no conecta</h3>\n<ol>\n<li>Verifique Node.js: <code>node --version</code> (≥ 18)</li>\n<li>Pruebe el servidor MCP: <code>npx -y synapse-mcp-api@latest</code> (debería arrancar sin errores)</li>\n<li>Revise los logs MCP de Cursor (View → Output → MCP)</li>\n<li>Reinicie Cursor completamente</li>\n</ol>\n<h3>Las herramientas no aparecen</h3>\n<ul>\n<li>Compruebe que <code>~/.cursor/config.json</code> es JSON válido</li>\n<li>Verifique que la variable de entorno <code>SYNAPSE_MIND_KEY</code> está establecida</li>\n<li>Compruebe que la versión de Cursor admite MCP (≥ 0.42)</li>\n</ul>\n<h3>Mind Key inválido</h3>\n<pre><code class=\"hljs language-bash\"><span class=\"hljs-comment\"># Test your Mind Key directly</span>\ncurl -H <span class=\"hljs-string\">&quot;Authorization: Bearer mk_YOUR_KEY&quot;</span> \\\n     https://synapse.schaefer.zone/memory/recall</code></pre><h2>Próximos pasos</h2>\n<ul>\n<li><a href=\"/docs/mcp/claude-desktop\">Configuración de Claude Desktop</a></li>\n<li><a href=\"/docs/mcp/continue\">Configuración de Continue.dev</a></li>\n<li><a href=\"/docs/guides/persistent-llm-agent\">Guía de agente LLM persistente</a></li>\n</ul>\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"]}