Collega OneMira a Cursor avviando il server MCP locale di OneMira tramite stdio, registrando quel comando esatto in Cursor, controllando gli strumenti esposti e provando una query in sola lettura su una nota locale nota. Non incollare un token remoto nella configurazione di un server locale, a meno che lo strumento documentato non lo richieda davvero.

Nota sulle versioni. Le interfacce di Cursor e MCP cambiano. Questa guida è stata verificata rispetto alla documentazione ufficiale MCP/CLI di Cursor e alle indicazioni di sicurezza MCP disponibili il 16 luglio 2026. I comandi OneMira devono corrispondere alla versione desktop installata.

Che cosa stai collegando?

MCP separa l’applicazione host IA da un server che espone strumenti o risorse. Cursor svolge il ruolo di host/client. Il server OneMira è un processo locale che legge un archivio di note OneMira delimitato e restituisce risultati strutturati. Il modello non riceve automaticamente l’intera cartella, ma il risultato di una chiamata a uno strumento approvata e inviata dall’host.

L’architettura ufficiale MCP supporta i server locali tramite stdio. Le indicazioni di sicurezza consigliano stdio per i server locali, dove possibile, perché limita l’accesso al client che li avvia. Ricordano però che un server locale viene eseguito con i privilegi del sistema operativo del client.

Che cosa verificare prima di aggiungere Cursor?

  1. Installa l’app desktop OneMira supportata e completa la sincronizzazione C1 documentata.
  2. Apri la cartella locale delle note e individua una nota di prova non sensibile.
  3. Esegui il comando di diagnostica OneMira o di elenco MCP indicato dalla versione installata.
  4. Verifica il percorso dell’eseguibile con command -v o con un percorso assoluto.
  5. Controlla il comando: deve avviare il server locale noto di OneMira, non un pacchetto npx non verificato o una pipeline della shell.

La documentazione OneMira aggiornata è il riferimento per i nomi dei comandi: consulta la configurazione MCP e il riferimento CLI. Un articolo del blog non deve fissare un percorso di installazione che varia tra le versioni per macOS e Windows.

Come aggiungere il server locale in Cursor?

Cursor supporta i server MCP e la sua CLI offre comandi per elencarli e ispezionarne gli strumenti. Nelle impostazioni MCP di Cursor aggiungi un server locale stdio , quindi inserisci l’eseguibile OneMira e gli argomenti esatti indicati dalla documentazione installata. Una configurazione concettuale ha questa struttura: 

{
  "mcpServers": {
    "onemira": {
      "command": "/absolute/path/to/onemira",
      "args": ["mcp", "serve"],
      "env": {
        "ONEMIRA_NOTES_ROOT": "/absolute/path/to/OneMira"
      }
    }
  }
}

È una struttura di esempio, non la garanzia che ogni versione usi esattamente quegli argomenti. Copia il comando dalla documentazione installata o dall’app, quindi limita il più possibile la cartella radice delle note. Non impostarla su ~ né sull’intero disco.

Primo piano dal basso del lato metallico, della porta USB-C e della copertura trasparente del C1 bianco argento su una superficie scura.
Il lato metallico e la copertura trasparente del C1 visti all’altezza del tavolo.

Come verificare concretamente la connessione?

Il riferimento CLI ufficiale di Cursor elenca cursor-agent mcp list e cursor-agent mcp list-tools <identifier>. Usali se disponibili nella versione installata: 

cursor-agent mcp list
cursor-agent mcp list-tools onemira

Esegui quindi una prova in quattro parti:

  1. Rilevamento: Cursor mostra il server OneMira come connesso.
  2. Controllo degli strumenti: nomi e parametri corrispondono alla documentazione OneMira; non compaiono strumenti inattesi per shell, rete o accesso all’intero file system.
  3. Lettura con risposta nota: cerca una frase univoca nella nota di prova e verifica l’estratto restituito e il percorso di origine.
  4. Prova fuori ambito: richiedi un file esterno alla cartella radice configurata e verifica che il server rifiuti o non possa accedervi.

Registra la versione del server, la versione di Cursor, il percorso di configurazione, l’elenco degli strumenti e l’esito della prova. Un indicatore verde «connesso» non dimostra da solo che i dati corretti siano accessibili o che i limiti siano rispettati.

Quali dati possono uscire da questo perimetro?

Ci sono due passaggi. Lo strumento MCP locale legge una nota e restituisce testo a Cursor. Cursor può poi inviare quel testo al modello selezionato secondo le condizioni di Cursor e del fornitore del modello. Un server MCP locale limita il modo in cui viene recuperato il contesto; non garantisce che il contesto recuperato rimanga sul computer.

Procedi con accesso progressivo:

  • cerca prima metadati ed estratti brevi;
  • recupera una nota completa solo quando è pertinente;
  • escludi per impostazione predefinita le cartelle sensibili;
  • preferisci strumenti in sola lettura, salvo quando una scrittura è esplicitamente necessaria;
  • esamina ogni modifica ai file generata da un agente sotto forma di diff.

Come diagnosticare i problemi?

Sintomo Cosa controllare Cosa evitare
Il server non si avvia Percorso assoluto dell’eseguibile, autorizzazioni, virgolette, versione dell’app Sostituirlo con un pacchetto sconosciuto
Connesso, ma senza strumenti Log del server, negoziazione del protocollo, versione della funzionalità installata Concedere autorizzazioni estese al file system
Lo strumento non restituisce note Cartella radice, stato della sincronizzazione, frase di prova nota, maiuscole e minuscole nel percorso Impostare come radice l’intera cartella personale
Errore nel percorso Windows Escape JSON e formato del percorso assoluto Copiare alla lettera un percorso macOS
Chiamata inattesa a uno strumento Annullare e controllare descrizione e argomenti dello strumento Approvare perché il server è «locale»

Come rimuovere correttamente l’accesso?

Disattiva o elimina la voce del server OneMira in Cursor, riavvia l’host e verifica che non compaia più nell’elenco MCP. Rimuovi eventuali credenziali d’ambiente aggiunte appositamente per il server. Le note restano normali file locali: rimuovere l’accesso MCP non le elimina.

Per una visione più ampia dell’architettura del contesto, leggi Dalla conversazione al contesto. Per i limiti di sicurezza di MCP, consulta le fonti ufficiali riportate sotto.

Fonti e approfondimenti