Usa le tue registrazioni di Vocatim nelle app di IA sul tuo Mac

Prima di tutto, in Vocatim

Sul Mac, apri Impostazioni → Dati e dispositivi → App di IA su questo Mac e attiva l’opzione. Leggi la schermata che spiega cosa può vedere l’app di IA, poi fai clic su Attiva. Quindi segui i passaggi per la tua app di IA.

Claude Desktop

1. Fai clic su Installa in Claude Desktop e salva Vocatim.mcpb dove preferisci, ad esempio nella cartella Download. Una volta salvato il file, Vocatim copia la chiave di Vocatim.
2. Apri Vocatim.mcpb. Claude Desktop mostra l’estensione di Vocatim e chiede se installarla.
3. Quando Claude Desktop chiede la chiave, incollala nel campo Chiave di Vocatim. Lascia il campo Programma vocatim-mcp così com’è.
4. In una nuova chat, chiedi, ad esempio, «Cosa abbiamo deciso nella mia ultima registrazione in Vocatim?». Claude potrebbe chiederti di consentire l’uso dello strumento di Vocatim.

Preferisci modificare tu la configurazione? Fai clic su Copia la configurazione per Claude Desktop. In Claude Desktop, apri il menu Claude nella barra dei menu di macOS (non le impostazioni all’interno della finestra di Claude) e scegli Settings… → Developer → Edit Config. Se il file non contiene ancora "mcpServers", sostituiscine il contenuto con l’esempio completo qui sotto. Se elenca già dei server, incolla solo la voce "vocatim" all’interno di "mcpServers", con una virgola tra questa e la voce precedente. Salva il file, chiudi completamente Claude Desktop e riaprilo.

{
  "mcpServers": {
    "vocatim": { … paste from Vocatim … }
  }
}

ChatGPT e Codex

1. Fai clic su Copia la configurazione per ChatGPT e Codex.
2. Apri il file ~/.codex/config.toml in un editor di testo, oppure crealo se non esiste ancora. ~/.codex è una cartella nascosta nella tua cartella Inizio: nel Finder, scegli Vai → Vai alla cartella… e digita ~/.codex.
3. Se il file non ha una sezione [mcp_servers.vocatim], incolla la configurazione su una nuova riga alla fine. Se ne ha già una, da una configurazione precedente, sostituisci l’intera sezione con quella nuova. Il file non deve contenere la sezione due volte.
4. Salva il file e riavvia ChatGPT o Codex.
5. In una nuova chat, chiedi, ad esempio, «Cosa abbiamo deciso nella mia ultima registrazione in Vocatim?». In ChatGPT, usa Vocatim in una conversazione Codex, non in una chat normale.

[mcp_servers.vocatim]
command = "/Applications/Vocatim.app/Contents/MacOS/vocatim-mcp"
args = ["--port", "…", "--token", "…"]

codex mcp list mostra la chiave di Vocatim nella colonna Args. La chiave permette solo alle app di questo Mac di leggere Vocatim, e solo mentre Vocatim è aperto. Non condividere quel risultato; se l’hai fatto, usa «Reimposta la chiave» in Vocatim.

VS Code, Cursor e LM Studio

1. Fai clic su Installa in VS Code, Aggiungi a Cursor o Aggiungi a LM Studio. Vocatim apre quell’app con la configurazione di Vocatim.
2. Nell’app, conferma che vuoi aggiungere Vocatim.
3. Per VS Code, Vocatim copia la chiave di Vocatim: quando VS Code chiede la Chiave di Vocatim, incollala. Cursor e LM Studio ricevono la chiave insieme alla configurazione e la salvano nelle proprie impostazioni.
4. Nella chat di IA dell’app, chiedi, ad esempio, «Cosa abbiamo deciso nella mia ultima registrazione in Vocatim?».

Altre app: Cursor, LM Studio, JetBrains AI Assistant e Junie

1. Fai clic su Copia la configurazione per altre app.
2. Apri le impostazioni MCP dell’app: in Cursor, il file ~/.cursor/mcp.json; in LM Studio, il suo mcp.json; in JetBrains AI Assistant, Settings → Tools → AI Assistant → MCP e Add; in Junie, il file ~/.junie/mcp/mcp.json.
3. Se lì non c’è ancora "mcpServers", incolla l’intera configurazione. Se sono già elencati dei server, aggiungi solo la voce "vocatim" all’interno di "mcpServers", oppure sostituisci con questa la vecchia voce "vocatim". La voce non deve comparire due volte.
4. Salva, poi riavvia l’app.

Zed

1. Fai clic su Copia la configurazione per Zed.
2. In Zed, esegui zed: open settings file.
3. Metti la parte "context_servers" dentro le parentesi graffe esterne di quel file. Se "context_servers" c’è già, aggiungi al suo interno solo la voce "vocatim", oppure sostituisci con questa la vecchia voce "vocatim". La voce non deve comparire due volte.
4. Salva il file, poi riavvia Zed.

Vocatim in Terminale (riga di comando)

Puoi leggere le tue registrazioni anche in Terminale su questo Mac, con gli stessi quattro strumenti in sola lettura che ricevono le app di IA: elenco, ricerca, trascrizione e riassunto. La riga di comando usa lo stesso interruttore e la stessa chiave di Vocatim delle tue app di IA e funziona solo mentre Vocatim è aperto con l’interruttore attivato.

1. Copia questo comando e incollalo in una finestra di Terminale, ma non premere ancora A capo:

   printf '\n%s\n' "$(pbpaste | grep -m 1 '^alias vocatim=')" >> ~/.zshrc

2. In Vocatim, fai clic su Copia il comando CLI. Vocatim copia una riga: un alias chiamato vocatim per zsh, la shell predefinita di macOS.
3. Torna in Terminale e premi A capo. Il comando aggiunge la riga copiata alla fine di ~/.zshrc, il file che zsh legge ogni volta che apri una finestra di Terminale. Aggiunge solo una riga che inizia con alias vocatim=, quindi nient’altro dagli appunti finisce nel file.
4. Apri una nuova finestra di Terminale e digita vocatim list. L’alias funziona nelle finestre che apri dopo il passaggio 3.

I quattro comandi:

• vocatim list mostra le tue 20 registrazioni più recenti, una per riga: id, data e ora, durata e titolo. vocatim list --limit 50 ne mostra fino a 50.
• vocatim search budget trova le registrazioni il cui titolo, trascrizione, riassunto, note o una traduzione contengono «budget». Metti tra virgolette una ricerca con spazi: vocatim search "revisione settimanale". Mostra fino a 10 risultati, o fino a 20 con --limit 20.
• vocatim transcript <id> mostra la trascrizione completa di una registrazione. L’id si trova nella prima colonna di vocatim list e di vocatim search.
• vocatim summary <id> ne mostra il riassunto.

Aggiungi --json a qualsiasi comando per ottenere JSON per i tuoi script. vocatim help elenca i comandi.

La tua chiave. La riga vocatim in ~/.zshrc contiene la tua chiave di Vocatim. Se incolli quella riga direttamente in Terminale, la chiave resta anche nella cronologia di Terminale. La chiave permette solo alle app di questo Mac di leggere Vocatim, e solo mentre Vocatim è aperto. Non condividere la riga né il file; se l’hai fatto, usa «Reimposta la chiave» in Vocatim.

Dopo «Reimposta la chiave», o quando Vocatim mostra «La configurazione è cambiata: configura di nuovo le tue app di IA.», la vecchia riga smette di funzionare. Ripeti i passaggi da 1 a 4. Conta la riga vocatim più recente in ~/.zshrc; puoi eliminare quelle più vecchie.

Dopo un comando, App di IA su questo Mac nelle Impostazioni di Vocatim mostra vocatim-cli, come mostra il nome di un’app di IA.

La riga di comando comunica solo con Vocatim su questo Mac e mostra il risultato nella tua finestra di Terminale. Se passi quel risultato ad altri, per esempio a un servizio di IA online, finisce lì.

Per rimuoverla, elimina tutte le righe vocatim da ~/.zshrc; dopo aver ripetuto i passaggi da 1 a 4 possono essercene più di una. Anche disattivare l’interruttore in Vocatim, o «Reimposta la chiave», la ferma.

Se non funziona: i messaggi della riga di comando di Vocatim iniziano con vocatim-mcp:.

• vocatim-mcp: Vocatim is not open on this Mac, or AI app access is turned off in Vocatim Settings. (Vocatim non è aperto su questo Mac, oppure l’accesso delle app di IA è disattivato nelle Impostazioni di Vocatim): apri Vocatim e controlla l’interruttore. Dopo «Reimposta la chiave» o «La configurazione è cambiata», ripeti i passaggi da 1 a 4. La riga sopra, se c’è, indica il motivo tecnico, per esempio vocatim-mcp: connect: Connection refused.
• zsh: command not found: vocatim: apri una nuova finestra di Terminale. Se il messaggio compare ancora, controlla che ~/.zshrc abbia una riga che inizia con alias vocatim=; se non c’è, ripeti i passaggi da 1 a 4. Controlla anche che echo $SHELL mostri /bin/zsh.
• zsh: no such file or directory con un percorso a vocatim-mcp: la riga punta a un posto in cui Vocatim non c’è più, per esempio dopo che hai spostato l’app. Ripeti i passaggi da 1 a 4.
• vocatim-mcp: Too many requests, try again in a moment. (troppe richieste, riprova tra un momento): attendi un momento ed esegui di nuovo il comando.
• vocatim senza comando, per esempio vocatim o vocatim --json, resta in attesa e non mostra nulla: premi Controllo-C, poi digita un comando come vocatim list.

Per gli script: i dati vanno sullo standard output, per intero e solo se il comando riesce; i messaggi vanno sullo standard error. Con --json, ogni risposta di Vocatim è una riga di JSON, quindi transcript scrive una riga per ogni pagina di una trascrizione lunga: leggi l’output riga per riga, non come un unico documento JSON. Codici di uscita: 0 fatto, 1 altro errore, 2 comando o opzione errati, 3 Vocatim non è aperto o l’accesso è disattivato, 4 troppe richieste.

Cosa esce dal tuo Mac

L’accesso delle app di IA alle tue registrazioni è disattivato per impostazione predefinita. Lo attivi tu nelle Impostazioni di Vocatim, solo se decidi di condividere le tue trascrizioni con app di IA su questo Mac.

Vocatim di per sé non invia nulla. Se l’app di IA usa un modello online, come fanno di solito Claude Desktop, ChatGPT e Codex, ciò che legge da Vocatim viene inviato a quell’azienda (Anthropic o OpenAI) tramite il tuo account presso di lei, come se lo avessi incollato nella chat.

Per interrompere

Disattiva l’interruttore in Vocatim. Reimposta la chiave rende inutilizzabili tutte le chiavi che hai copiato e tutte le configurazioni che hai incollato. Per ricollegare l’app di IA, configurala di nuovo. Per l’estensione di Claude Desktop, fai di nuovo clic su Installa in Claude Desktop in Vocatim, salva il file e aprilo: Vocatim copia la nuova chiave non appena il file è salvato. Incollala quando Claude Desktop te la chiede, oppure nel campo Chiave di Vocatim dell’estensione di Vocatim in Claude Desktop. Per Cursor e LM Studio, fai di nuovo clic su Aggiungi a Cursor o Aggiungi a LM Studio. Per una configurazione che hai incollato, copiala di nuovo e incollala al posto della vecchia voce o sezione. Poi chiudi completamente l’app di IA (chiudere la sua finestra non basta) e riaprila: fino ad allora continua a usare la vecchia chiave. Puoi anche rimuovere Vocatim dall’app di IA: l’estensione di Vocatim in Claude Desktop, la voce "vocatim" nella sua configurazione, nelle impostazioni MCP di un’altra app o nel file delle impostazioni di Zed, oppure la sezione [mcp_servers.vocatim] in ~/.codex/config.toml.

Se non funziona

• «Vocatim non è aperto su questo Mac, oppure l’accesso delle app di IA è disattivato nelle Impostazioni di Vocatim.»: apri Vocatim e controlla l’interruttore. Dopo «Reimposta la chiave», configura di nuovo l’app di IA, poi chiudila completamente (chiudere la sua finestra non basta) e riaprila.
• Vocatim mostra «La configurazione è cambiata: configura di nuovo le tue app di IA.»: configura di nuovo ogni app di IA come descritto sopra, al posto della vecchia voce o sezione, e riavviala.
• Vocatim mostra «L’app non si è aperta. È installata su questo Mac?»: installa quell’app su questo Mac. Per Cursor e LM Studio puoi anche usare Copia la configurazione per altre app.
• ChatGPT o Codex smette di funzionare, o segnala un errore in config.toml, dopo che hai incollato la configurazione una seconda volta: il file contiene due sezioni [mcp_servers.vocatim]. Tieni solo la più recente.
• Codex dice che non c’è nessuno strumento di Vocatim: avvia una nuova conversazione in un progetto la cui cartella si trova su questo Mac (un progetto sincronizzato da un altro computer potrebbe non avere una cartella qui).
• Hai aperto l’app di IA prima di Vocatim: riavvia l’app di IA con Vocatim aperto.
• Manca una registrazione: le registrazioni nel cestino e le registrazioni di esempio non vengono mostrate, e una nuova registrazione compare solo quando la sua trascrizione termina o viene interrotta. Una registrazione non ancora trascritta del tutto compare nell’elenco, ma la sua trascrizione e il suo riassunto non sono disponibili finché non lo sarà.