{"title":"MCP in Cursor","slug":"cursor","category":"mcp","summary":"Colleghi Synapse all'IDE Cursor per una memoria di progetto persistente tra le sessioni di coding.","audience":["human"],"tags":["mcp","cursor","ide","coding"],"difficulty":"intermediate","updated":"2026-06-27","word_count":323,"read_minutes":2,"lang":"it","translated":true,"requested_lang":"it","content_markdown":"\n# MCP in Cursor\n\nCursor è un IDE basato sull'AI, fondato su VS Code. Con Synapse MCP, Cursor\nottiene memoria persistente tra le sessioni — ricorda le decisioni di\nprogetto, i pattern del codebase e le sessioni di debug precedenti.\n\n## Prerequisiti\n\n- IDE Cursor installato (<https://cursor.com>)\n- Node.js 18+\n- La propria Mind Key di Synapse\n\n## Configurazione\n\n### Passaggio 1: aprire le impostazioni di Cursor\n\nIn Cursor:\n\n1. Apra le Impostazioni (Cmd+, su macOS, Ctrl+, su Windows/Linux)\n2. Cerchi \"MCP\" o navighi in `Cursor Settings → MCP Servers`\n\n### Passaggio 2: aggiungere il server MCP di Synapse\n\nClicchi su \"Add MCP Server\" e configuri:\n\n| Campo | Valore |\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### Passaggio 3: modificare config.json direttamente (alternativa)\n\nCursor memorizza la configurazione MCP in `~/.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### Passaggio 4: riavviare Cursor\n\nRiavvii completamente Cursor (Cmd+Q e riapertura su macOS).\n\n## Verifica del funzionamento\n\nNel pannello chat di Cursor (Cmd+L):\n\n```\nrecall all my memories\n```\n\nCursor dovrebbe richiamare `memory_recall` e rispondere con le memorie memorizzate.\n\n## Pattern comuni\n\n### Onboarding di progetto\n\nAll'apertura di un nuovo progetto:\n\n```\nrecalling project context — what do I know about this codebase?\n```\n\nCursor richiama `memory_recall` e riprende il lavoro da dove era rimasto.\n\n### Decisioni architetturali\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 memorizza come memoria `project` con priorità `high`.\n\n### Cronologia di debug\n\n```\nwhat bugs have I hit in this codebase?\n```\n\nCursor cerca le memorie `mistake` e le ricorda delle correzioni passate.\n\n### Pattern di codice tra sessioni\n\n```\nsearch memories: \"authentication pattern\"\n```\n\nCursor trova le memorie relative alle implementazioni di autenticazione fatte in passato.\n\n## Risoluzione dei problemi\n\n### Il server MCP non si connette\n\n1. Verifichi Node.js: `node --version` (≥ 18)\n2. Testi il server MCP: `npx -y synapse-mcp-api@latest` (dovrebbe avviarsi senza errori)\n3. Controlli i log MCP di Cursor (View → Output → MCP)\n4. Riavvii completamente Cursor\n\n### Gli strumenti non appaiono\n\n- Controlli che `~/.cursor/config.json` sia JSON valido\n- Verifichi che la variabile d'ambiente `SYNAPSE_MIND_KEY` sia impostata\n- Controlli che la versione di Cursor supporti MCP (≥ 0.42)\n\n### Mind Key non valida\n\n```bash\n# Testi direttamente la Mind Key\ncurl -H \"Authorization: Bearer mk_YOUR_KEY\" \\\n     https://synapse.schaefer.zone/memory/recall\n```\n\n## Prossimi passi\n\n- [Configurazione di Claude Desktop](/docs/mcp/claude-desktop)\n- [Configurazione di Continue.dev](/docs/mcp/continue)\n- [Guida agente LLM persistente](/docs/guides/persistent-llm-agent)\n","content_html":"<h1>MCP in Cursor</h1>\n<p>Cursor è un IDE basato sull&#39;AI, fondato su VS Code. Con Synapse MCP, Cursor\nottiene memoria persistente tra le sessioni — ricorda le decisioni di\nprogetto, i pattern del codebase e le sessioni di debug precedenti.</p>\n<h2>Prerequisiti</h2>\n<ul>\n<li>IDE Cursor installato (<a href=\"https://cursor.com\">https://cursor.com</a>)</li>\n<li>Node.js 18+</li>\n<li>La propria Mind Key di Synapse</li>\n</ul>\n<h2>Configurazione</h2>\n<h3>Passaggio 1: aprire le impostazioni di Cursor</h3>\n<p>In Cursor:</p>\n<ol>\n<li>Apra le Impostazioni (Cmd+, su macOS, Ctrl+, su Windows/Linux)</li>\n<li>Cerchi &quot;MCP&quot; o navighi in <code>Cursor Settings → MCP Servers</code></li>\n</ol>\n<h3>Passaggio 2: aggiungere il server MCP di Synapse</h3>\n<p>Clicchi su &quot;Add MCP Server&quot; e configuri:</p>\n<table>\n<thead>\n<tr>\n<th>Campo</th>\n<th>Valore</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>Passaggio 3: modificare config.json direttamente (alternativa)</h3>\n<p>Cursor memorizza la configurazione MCP in <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>Passaggio 4: riavviare Cursor</h3>\n<p>Riavvii completamente Cursor (Cmd+Q e riapertura su macOS).</p>\n<h2>Verifica del funzionamento</h2>\n<p>Nel pannello chat di Cursor (Cmd+L):</p>\n<pre><code class=\"hljs language-plaintext\">recall all my memories</code></pre><p>Cursor dovrebbe richiamare <code>memory_recall</code> e rispondere con le memorie memorizzate.</p>\n<h2>Pattern comuni</h2>\n<h3>Onboarding di progetto</h3>\n<p>All&#39;apertura di un nuovo progetto:</p>\n<pre><code class=\"hljs language-plaintext\">recalling project context — what do I know about this codebase?</code></pre><p>Cursor richiama <code>memory_recall</code> e riprende il lavoro da dove era rimasto.</p>\n<h3>Decisioni architetturali</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 memorizza come memoria <code>project</code> con priorità <code>high</code>.</p>\n<h3>Cronologia di debug</h3>\n<pre><code class=\"hljs language-plaintext\">what bugs have I hit in this codebase?</code></pre><p>Cursor cerca le memorie <code>mistake</code> e le ricorda delle correzioni passate.</p>\n<h3>Pattern di codice tra sessioni</h3>\n<pre><code class=\"hljs language-plaintext\">search memories: &quot;authentication pattern&quot;</code></pre><p>Cursor trova le memorie relative alle implementazioni di autenticazione fatte in passato.</p>\n<h2>Risoluzione dei problemi</h2>\n<h3>Il server MCP non si connette</h3>\n<ol>\n<li>Verifichi Node.js: <code>node --version</code> (≥ 18)</li>\n<li>Testi il server MCP: <code>npx -y synapse-mcp-api@latest</code> (dovrebbe avviarsi senza errori)</li>\n<li>Controlli i log MCP di Cursor (View → Output → MCP)</li>\n<li>Riavvii completamente Cursor</li>\n</ol>\n<h3>Gli strumenti non appaiono</h3>\n<ul>\n<li>Controlli che <code>~/.cursor/config.json</code> sia JSON valido</li>\n<li>Verifichi che la variabile d&#39;ambiente <code>SYNAPSE_MIND_KEY</code> sia impostata</li>\n<li>Controlli che la versione di Cursor supporti MCP (≥ 0.42)</li>\n</ul>\n<h3>Mind Key non valida</h3>\n<pre><code class=\"hljs language-bash\"><span class=\"hljs-comment\"># Testi direttamente la Mind Key</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>Prossimi passi</h2>\n<ul>\n<li><a href=\"/docs/mcp/claude-desktop\">Configurazione di Claude Desktop</a></li>\n<li><a href=\"/docs/mcp/continue\">Configurazione di Continue.dev</a></li>\n<li><a href=\"/docs/guides/persistent-llm-agent\">Guida 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"]}