Lascia che un agente gestisca la tua lista di cose da fare

MCP o la CLI?

Preferisci gli strumenti MCP quando il tuo agente ha già una connessione MCP a TaskForge. Sono tipizzati, restituiscono errori strutturati su cui l'agente può autocorreggersi, e non richiedono nulla nel tuo PATH. Ricorri invece alla CLI da contesti di shell senza connessione MCP: script, cron, CI, o un agente di coding che lavora in una copia locale di un repository. Entrambi guidano lo stesso motore con semantica identica, scegli quindi quello già collegato nel tuo ambiente. Modificare i file del vault a mano resta l'ultima risorsa.

Installazione

{
  "mcpServers": {
    "taskforge": {
      "command": "npx",
      "args": ["-y", "taskforge-md", "mcp", "--stdio"],
      "env": {
        "TASKFORGE_VAULT": "/path/to/your/vault"
      }
    }
  }
}

Su Windows, metti cmd /c davanti a npx. I client MCP desktop come Claude Desktop avviano il server senza shell, e npx è uno script .cmd che Windows esegue solo tramite una shell:

{
  "mcpServers": {
    "taskforge": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "taskforge-md", "mcp", "--stdio"],
      "env": {
        "TASKFORGE_VAULT": "C:\\path\\to\\your\\vault"
      }
    }
  }
}

Hai compilato taskforge dal codice sorgente invece di usare npx? Punta la configurazione direttamente al binario:

"command": "taskforge",
"args": ["mcp", "--stdio"]

Solo desktop, perché è lì che vivono i client MCP. taskforge viene distribuito come un unico binario nativo per macOS e Windows, e il server MCP è uno dei suoi sottocomandi. Linux arriverà presto.

L'intero set di strumenti

30 strumenti in totale, che coprono l'intero ciclo di vita di un'attività: creare, leggere, aggiornare, completare, archiviare ed eliminare, ciascuno con una variante bulk; spostare, riassegnare il genitore e convertire tra una riga inline e un file attività; un controllo lint prima di scrivere una riga; una chiamata doctor per lo stato di salute del vault; e risorse di schema e Spazi, così l'agente impara il tuo formato prima di agire. I sei qui sotto sono quelli che userai più spesso. Ogni chiamata rilegge il vault dal disco, quindi l'agente agisce sempre sui file attuali.

Ogni strumento porta delle annotazioni, così un client sa a colpo d'occhio quali chiamate leggono soltanto, quali scrivono e quale elimina. Il resto del set aggiunge bulk_add_tasks, bulk_update_tasks, bulk_complete_tasks, bulk_delete_tasks, get_tasks, archive_task, move_task, bulk_move_tasks, convert_task, bulk_convert_tasks, outdent_task, bulk_reparent_tasks, lint_task, doctor, list_spaces e create_note, read_note, update_note, patch_note_block, patch_note_frontmatter, delete_note, move_note, normalize_references, get_dialect.

Tre risorse

Accanto agli strumenti, il server espone un contesto in sola lettura, così l'agente impara le regole del tuo vault prima di agire:

Se non riesce a trovare il tuo vault

Il server si avvia sempre, anche prima di sapere dove si trova il tuo vault, così Claude Desktop non mostra mai un opaco "server failed to start". Quando una chiamata a uno strumento non riesce a risolvere un vault, restituisce un errore chiaro che l'agente può riportare: imposta la variabile d'ambiente TASKFORGE_VAULT sul percorso del tuo vault, oppure reinstalla il pacchetto e inserisci la cartella del vault quando richiesto.

Solo in locale

Il server MCP di TaskForge gira in locale e legge e scrive i file Markdown del tuo vault. L'installazione tramite npx scarica il pacchetto da npm. Il tuo client IA può inviare input e risultati degli strumenti al suo fornitore; si applicano comunque le sue impostazioni sulla privacy. La sincronizzazione del vault che già usi sposta le modifiche tra i dispositivi.

Preferisci un terminale?

Se preferisci scriptare le tue attività o eseguire comandi una tantum invece di farle guidare da un agente, la CLI taskforge copre lo stesso vault con le stesse regole.

Domande frequenti