Vai al contenuto principale
TaskForge 3.0: l'IA legge le tue attività.

Gestisci le attività senza uscire da Cursor

Cursor apre una cartella e modifica i file al suo interno. Apri il tuo vault Obsidian e potrà aggiungere, riprogrammare e completare le tue attività, che sono semplici righe markdown. Due configurazioni ti portano al risultato: registra il server MCP taskforge per gli strumenti tipizzati, oppure aggiungi una regola di una riga che punta al file di contratto del tuo vault, così Cursor scrive le attività nel tuo formato fin dal primo tasto premuto.

Due modi per collegarlo

Il file di regole è la via più rapida e non richiede nulla da installare. Il server MCP aggiunge strumenti tipizzati se vuoi che l'agente chiami aggiungi e completa invece di modificare le righe a mano. Scegline uno, oppure usali entrambi.

  1. Genera il contratto del vault

    Apri il tuo vault in TaskForge 3.0 o versioni successive, poi Settings, AI & Agents, e lascia attivo "Generate agent files". TaskForge scrive una cartella TaskForge/Settings/ che descrive il formato delle tue attività, su cui si basano entrambe le configurazioni qui sotto.

  2. Apri il vault come cartella in Cursor

    File, Open Folder, e scegli il tuo vault. Cursor ora vede ogni nota, compreso il contratto TaskForge/Settings/, nel suo workspace.

  3. Punta una regola al contratto

    Cursor non individua ancora automaticamente le guide dentro il vault, quindi digli dove si trova la tua. Aggiungi una regola di progetto che fa riferimento a TaskForge/Settings/agents.md, e Cursor la legge prima di scrivere qualsiasi attività.

    # .cursor/rules/taskforge.md
    When adding or editing tasks, first read TaskForge/Settings/agents.md
    in this vault and follow its exact syntax and date format.
    Un file, una riga di intento. Cursor ora rispetta un campo rinominato o una cartella TaskNotes invece di indovinare.
  4. Oppure aggiungi il server MCP per strumenti tipizzati

    Preferisci che l'agente chiami degli strumenti? Aggiungi taskforge alla configurazione MCP di Cursor. npx lo scarica alla prima esecuzione, e Cursor ottiene add_task, query_tasks, complete_task e il resto.

    {
      "mcpServers": {
        "taskforge": {
          "command": "npx",
          "args": ["-y", "taskforge-md", "mcp", "--stdio"],
          "env": {
            "TASKFORGE_VAULT": "/path/to/your/vault"
          }
        }
      }
    }
    Salvalo come .cursor/mcp.json nel progetto, oppure aggiungilo nelle impostazioni MCP di Cursor.

Come Cursor rispetta il tuo formato

Qualunque configurazione scegli, la cartella TaskForge/Settings/ è la fonte di verità. Il file di regole manda Cursor a leggere agents.md; il server MCP espone gli stessi dati come risorse. In entrambi i casi, Cursor scrive una riga che i tuoi altri strumenti possono leggere, nel tuo dialetto, al primo tentativo.

TaskForge/Settings/agents.md La sintassi delle tue attività in linguaggio semplice. È il file a cui punta la tua regola .cursor.
TaskForge/Settings/dialect.json La versione leggibile da una macchina, esposta al server MCP come taskforge://dialect.
TaskForge/Settings/spaces.json I tuoi Spazi salvati e dove finiscono le nuove attività, così "aggiungi questa al mio Spazio Work" la archivia correttamente.

Prompt che funzionano

Chiedi a Cursor nel suo pannello di chat con il vault aperto. Legge il contratto, modifica il markdown, e la modifica è un diff che puoi rivedere prima di accettarla.

Tu chiedi a Cursor

“Aggiungi un'attività per il pacchetto di revisione del cliente, scadenza giovedì, priorità alta.”

Cosa finisce nel file

- [ ] pacchetto di revisione del cliente ⏫ 📅 2026-07-09

Cursor legge prima TaskForge/Settings/agents.md, così il marcatore di priorità e il formato delle date corrispondono a questo vault, non a un'ipotesi generica.

Tu chiedi a Cursor

“Leggi meeting-notes.md e aggiungi ogni azione da svolgere a tasks/this-week.md, ciascuna con scadenza venerdì.”

Cosa finisce nel file

- [ ] inviare il contratto firmato all'ufficio legale 📅 2026-07-10

- [ ] prenotare la caparra per la sala 📅 2026-07-10

Le righe finiscono nel tuo vault. TaskForge le mostra la prossima volta che legge il vault, e il tuo telefono segue alla sincronizzazione successiva.

Niente lascia il tuo computer

Cursor modifica i file locali nella cartella che hai aperto, e il server MCP taskforge, se lo usi, gira anch'esso in locale. Nessun account TaskForge, nessun cloud. La sincronizzazione che già usi, iCloud, Dropbox o Obsidian Sync, sposta le modifiche sugli altri tuoi dispositivi.

Le domande più frequenti

Mi serve il server MCP, o basta il file di regole?

Il file di regole basta per la maggior parte delle persone. Punta Cursor su TaskForge/Settings/agents.md così scrive le attività nel tuo formato modificando direttamente i file. Aggiungi il server MCP solo se vuoi che Cursor chiami strumenti tipizzati come add_task e complete_task.

Perché Cursor ha bisogno di una regola quando Claude Code no?

Cursor non individua ancora automaticamente le guide dentro il vault, quindi ha bisogno di una riga che gli dica dove si trova TaskForge/Settings/agents.md. È un copia-incolla che fai una volta per vault. Dopodiché, Cursor legge il contratto da solo.

Le attività compariranno nell'app TaskForge?

Sì. Cursor modifica gli stessi file markdown che legge TaskForge. L'app rileva subito la modifica su quel computer, e raggiunge il tuo telefono non appena la sincronizzazione del vault viene eseguita.

Posso usare sia la regola sia il server MCP?

Sì. La regola mantiene le modifiche libere nel tuo formato, e il server MCP dà all'agente strumenti tipizzati per le azioni che preferisce chiamare. Leggono lo stesso contratto, quindi non sono mai in disaccordo sul tuo dialetto.

Funziona con attività in stile TaskNotes?

Sì. Se il tuo vault usa TaskNotes, il contratto descrive quei campi YAML e quelle cartelle, così Cursor scrive un'attività TaskNotes valida, non una semplice riga con casella di controllo.

Configurazioni correlate

Cursor è un editor tra tanti. La panoramica IA copre il quadro generale, e le pagine MCP e CLI approfondiscono ciascuna superficie.

Tieni le attività nell'editor in cui vivi già.

Semplice markdown nel tuo vault, modificato da Cursor. TaskForge è scaricabile gratis su iPhone, iPad, Mac, Android e Windows.