Connetti le app di IA (MCP)

Kimiko include un server MCP, così le app di IA sul tuo computer possono cercare nelle tue riunioni, leggere le tue note e trascrizioni e lavorare con le tue attività. MCP (Model Context Protocol) è lo standard aperto che le app di IA usano per connettersi agli strumenti.

Il server, kimiko-mcp, fa parte di Kimiko e funziona sul tuo computer. L’app di IA avvia il server quando le serve, e il server si ferma quando l’app chiude la connessione. Non esiste una versione online del server, quindi possono connettersi solo le app sullo stesso computer.

Cosa può fare un’app di IA

Un’app connessa ha a disposizione dieci strumenti. Otto leggono la tua libreria e due modificano le attività.

Strumento	Cosa fa
list_meetings	Elenca riunioni e note, dalla più recente, per data, progetto o tipo
search_meetings	Cerca in trascrizioni, note, riepiloghi e titoli, e restituisce i momenti con il relativo minutaggio
get_meeting	Mostra i dettagli di una riunione, chi era invitato e chi ha parlato, e il suo riepilogo più recente
get_notes	Legge ciò che hai scritto, la versione rifinita se ne hai creata una e i riepiloghi in tempo reale
get_transcript	Legge una trascrizione una pagina alla volta, così una riunione lunga non sommerge l’app
get_screenshots	Legge il testo che Kimiko ha trovato negli screenshot di una chiamata, mai le immagini
list_tasks	Elenca le tue attività con la loro riunione e il loro progetto; quelle completate solo se l’app lo chiede
list_projects	Elenca i tuoi progetti con il numero di attività di ciascuno
create_task	Aggiunge un’attività
update_task	Modifica un’attività, la sposta in un altro stato o progetto, oppure la segna come completata

La ricerca funziona sempre per parole chiave. Se il tuo modello di ricerca gira su Ollama o su un altro server locale sul tuo computer, cerca anche per significato. Con la configurazione integrata, le app di IA cercano per parole chiave. Consulta Ricerca nella chat.

Prompt pronti all’uso

Kimiko offre anche tre prompt. Le app che supportano i prompt MCP li mostrano come comandi slash o in un menu dei prompt.

• weekly_review: una revisione della settimana passata, o di un periodo più lungo fino a 90 giorni, con decisioni, impegni, punti aperti e attività aperte per progetto. Il suo argomento days imposta il periodo, da 1 a 90 giorni (7 per impostazione predefinita).
• meeting_prep: una nota di preparazione su una persona o un argomento, con contesto, impegni di entrambe le parti, punti aperti e domande da porre. Il suo argomento person_or_topic è obbligatorio.
• open_loops: attività scadute e impegni delle ultime due settimane che non sono mai diventati un’attività. Il suo argomento facoltativo project, il nome o l’ID di un progetto, lo limita a un solo progetto. Il prompt chiede all’app di creare un’attività solo dopo la tua conferma.

In Claude Code, digita / e scegli Kimiko:meeting_prep (MCP), oppure digita /mcp__Kimiko__meeting_prep Anna. Claude Code separa gli argomenti in corrispondenza degli spazi, quindi lì indica una persona o un argomento di una sola parola.

Cosa un’app non può mai fare

Kimiko non offre alle app di IA alcun modo per:

• avviare o interrompere una registrazione
• eliminare attività, riunioni o note
• creare o eliminare progetti
• modificare le tue note
• aprire l’audio o le immagini degli screenshot
• leggere le tue impostazioni o le tue chiavi API

Con Consenti modifiche alle attività attivo, un’app può comunque modificare un’attività, anche cancellandone i dettagli, l’assegnatario o le date.

Attiva l’accesso

L’accesso resta disattivato finché non lo attivi tu.

1. Apri Impostazioni → Connessioni.
2. Nella sezione Server MCP, attiva Consenti le app di IA.

Quando è attivo, qualsiasi app sul tuo computer che avvia il server MCP di Kimiko può leggere le tue riunioni. Ogni azione di aggiunta o di copia in Impostazioni → Connessioni attiva l’accesso al posto tuo, e Kimiko ti avvisa quando lo fa.

Consenti modifiche alle attività, nella sezione Cosa possono fare le app, è attivo per impostazione predefinita. Permette alle app di creare e aggiornare attività. Se lo disattivi, le app possono leggere le attività ma non modificarle. Kimiko rifiuta subito create_task e update_task e li esclude dall’elenco degli strumenti che un’app carica da quel momento in poi.

Attivare o disattivare Consenti le app di IA ha effetto dalla richiesta successiva di un’app connessa. Se un’app ha provato ad avviare Kimiko mentre l’accesso era disattivato, riavvia l’app. Anche una modifica a Consenti modifiche alle attività vale dalla richiesta successiva, ma un’app mantiene l’elenco degli strumenti caricato al momento della connessione finché non la riavvii o non la riconnetti.

Connetti un’app

Su Mac, consenti al server di Kimiko di usare il tuo Portachiavi prima che un’app si connetta per la prima volta, così la richiesta di macOS, che compare una sola volta, non può restare nascosta dietro l’app. Scegli Autorizza ora nella riga Accesso al Portachiavi, poi Sempre. La riga si trova nella sezione Server MCP quando l’accesso è attivo, altrimenti in Aiuto. La richiesta del Portachiavi di macOS spiega i dettagli.

La sezione App di IA in Impostazioni → Connessioni connette queste app al posto tuo:

• Claude (l’app desktop): scegli Aggiungi a Claude. Kimiko mostra cosa scriverà nel file delle impostazioni di Claude, prima salva un backup e mantiene le altre impostazioni. Scegli Aggiungi, poi esci completamente da Claude e riaprilo, perché Claude legge le impostazioni solo all’avvio. Su Mac, scegli Claude → Esci da Claude; su Windows, fai clic con il pulsante destro del mouse sull’icona di Claude nell’area di notifica e scegli Esci. Chiudere la finestra non basta.
• Claude Code: scegli Aggiungi a Claude Code per aggiungere Kimiko a tutti i tuoi progetti, poi avvia una nuova sessione di Claude Code. Se Kimiko non trova il comando claude, la riga offre invece Copia comando. Esegui il comando in Terminale su Mac, o in un terminale su Windows.
• Cursor: scegli Aggiungi a Cursor. Cursor apre la sua finestra di installazione con i dati di Kimiko già inseriti; conferma lì l’installazione.
• VS Code: scegli Aggiungi a VS Code per aprire in VS Code la pagina di installazione di Kimiko, poi conferma l’installazione. Gli strumenti di Kimiko funzionano nella modalità agente di GitHub Copilot.
• LM Studio (versione 0.3.17 o successiva): apri Altre app e scegli Aggiungi a LM Studio. LM Studio apre la sua finestra con i dati di Kimiko già inseriti; conferma lì.

Le altre app in Altre app hanno un pulsante Copia comando, Copia configurazione o Copia percorso: ChatGPT e Codex, Gemini CLI, Raycast, Zed, Windsurf e Warp. Ognuno copia un frammento pronto da incollare, con il percorso esatto per il tuo computer.

Aggiungi Kimiko a mano

Tutte le app qui sotto avviano lo stesso server, chiamato Kimiko, senza argomenti né variabili d’ambiente.

Qualunque app usi, attiva prima Consenti le app di IA. Un’azione di copia in Impostazioni → Connessioni lo fa al posto tuo. Su Mac, prima che l’app si connetta per la prima volta, scegli anche Autorizza ora nella riga Accesso al Portachiavi, poi Sempre.

Gli esempi usano il percorso del server su Mac, con Kimiko nella cartella Applicazioni:

/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp

Se Kimiko si trova altrove, usa invece il frammento di Impostazioni → Connessioni. Contiene sempre il percorso giusto per il Kimiko che stai usando. Per copiare solo il percorso, apri Altre app e scegli Copia percorso nella riga di Raycast.

Su Windows, Aggiungi a Claude e Aggiungi a Cursor inseriscono il percorso al posto tuo. Per configurare a mano l’una o l’altra app, usa Copia configurazione nella riga di Windsurf o di Warp in Altre app: copia la stessa voce mcpServers con le barre rovesciate del percorso già raddoppiate. Zed ha il suo Copia configurazione, e così anche la riga di ChatGPT e Codex, nel suo menu ⋯. Se scrivi tu un percorso di Windows in un file JSON o TOML, raddoppia ogni barra rovesciata (C:\\Users\\…\\kimiko-mcp.exe). Su Windows, ~ nei percorsi qui sotto indica la tua cartella utente (%USERPROFILE%).

Claude (app desktop)

Aggiungi questa voce al file delle impostazioni di Claude, ~/Library/Application Support/Claude/claude_desktop_config.json su Mac o %APPDATA%\Claude\claude_desktop_config.json su Windows, mantenendo gli altri server che hai già. Su Mac, la voce è:

{
  "mcpServers": {
    "Kimiko": {
      "command": "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp"
    }
  }
}

Su Windows, il server è kimiko-mcp.exe, accanto a kimiko-app.exe; copia il suo percorso esatto da Impostazioni → Connessioni.

Poi esci completamente da Claude e riaprilo: su Mac, scegli Claude → Esci da Claude; su Windows, fai clic con il pulsante destro del mouse sull’icona di Claude nell’area di notifica e scegli Esci. Chiudere la finestra non basta. A quel punto gli strumenti e i prompt di Kimiko compaiono in Claude.

Claude Code

Su Mac, esegui questo comando in un terminale:

claude mcp add --scope user --transport stdio Kimiko -- "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp"

--scope user aggiunge Kimiko per tutti i progetti. Usa invece --scope project per aggiungerlo al file .mcp.json del progetto corrente. claude mcp list mostra se si è connesso, e /mcp all’interno di una sessione elenca gli strumenti.

Cursor

Su Mac, aggiungi a ~/.cursor/mcp.json la stessa voce mcpServers usata per Claude:

{
  "mcpServers": {
    "Kimiko": {
      "command": "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp"
    }
  }
}

VS Code

Aggiungi Kimiko al tuo file mcp.json utente (~/Library/Application Support/Code/User/mcp.json, oppure %APPDATA%\Code\User\mcp.json su Windows). Su Mac, la voce è:

{
  "servers": {
    "Kimiko": {
      "type": "stdio",
      "command": "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp"
    }
  }
}

Oppure, su Mac, aggiungilo da un terminale:

code --add-mcp '{"name":"Kimiko","command":"/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp","args":[]}'

ChatGPT e Codex

I thread di Codex nell’app desktop di ChatGPT e la CLI di Codex condividono ~/.codex/config.toml. Kimiko funziona in Codex, non nelle normali chat di ChatGPT. Su Mac, la voce è:

[mcp_servers.Kimiko]
command = "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp"

Oppure, su Mac, esegui:

codex mcp add Kimiko -- "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp"

Gemini CLI

Su Mac, questo comando aggiunge Kimiko a ~/.gemini/settings.json:

gemini mcp add -s user Kimiko "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp"

Zed

Aggiungi una voce context_servers al file delle impostazioni di Zed (~/.config/zed/settings.json su Mac, %APPDATA%\Zed\settings.json su Windows). Su Mac, la voce è:

{
  "context_servers": {
    "Kimiko": {
      "command": "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp",
      "args": []
    }
  }
}

Raycast

In Raycast, esegui Install MCP Server, scegli il trasporto Standard Input/Output (stdio) e incolla il percorso del server come comando. Altre app → Raycast → Copia percorso lo copia per te.

Windsurf e Warp

Entrambe usano la stessa voce mcpServers di Claude. Per Windsurf, aggiungila a ~/.codeium/windsurf/mcp_config.json. Per Warp, aggiungila nelle impostazioni di Warp, in AI e poi in MCP servers. Copia configurazione nella riga di ciascuna app la copia per te. Su Mac, la voce è:

{
  "mcpServers": {
    "Kimiko": {
      "command": "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp"
    }
  }
}

Qualsiasi altra app

Aggiungi un server MCP locale che usa il trasporto stdio, chiamato Kimiko, con il percorso del server come comando e senza argomenti. Attiva Consenti le app di IA, poi, su Mac, consenti l’accesso al Portachiavi la prima volta che l’app si connette (vedi sotto).

Per provare il server da un terminale, eseguilo con --check. La verifica apre la tua libreria senza servire nulla alle app, e su Mac può mostrare la richiesta del Portachiavi. Su Mac, esegui:

"/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp" --check

Su Windows, in PowerShell, esegui & "<path to kimiko-mcp.exe>" --check, con il percorso preso da Impostazioni → Connessioni.

La verifica stampa ok quando Kimiko riesce a leggere la tua libreria. Non controlla Consenti le app di IA, che serve comunque alle app. Se qualcosa non va, stampa invece il motivo, ad esempio un problema del Portachiavi o del database.

App che non possono connettersi

Le app di IA che usi nel browser, come claude.ai e ChatGPT sul web, non possono connettersi. Nemmeno le app per dispositivi mobili. Si connettono solo a server MCP su internet, mentre il server di Kimiko, per scelta, funziona solo sul tuo computer.

Nell’app desktop di ChatGPT, Kimiko funziona nei thread di Codex, non nelle normali chat.

La richiesta del Portachiavi di macOS

Kimiko conserva la chiave di cifratura della tua libreria nel Portachiavi di macOS. La prima volta che kimiko-mcp la legge, macOS chiede se può usare il tuo Portachiavi. Scegli Sempre.

Spesso questa richiesta si apre dietro la finestra dell’app di IA, e la prima connessione resta in attesa finché non rispondi. Per evitarlo, scegli Autorizza ora nella riga Accesso al Portachiavi di Impostazioni → Connessioni prima che un’app si connetta per la prima volta. La richiesta si apre allora sopra Kimiko. Finché l’accesso è attivo ma non ancora autorizzato, la riga si trova nella sezione Server MCP; altrimenti è in Aiuto.

macOS potrebbe chiederlo di nuovo dopo un aggiornamento di Kimiko. Se hai scelto Rifiuta, apri Accesso Portachiavi, cerca app.kimiko.db, rimuovi kimiko-mcp in Controllo accesso, poi scegli Riprova nella riga.

Gestione credenziali su Windows

Su Windows, la chiave è salvata in Gestione credenziali per il tuo account Windows, quindi non compare alcuna richiesta. Verifica ora nella riga Gestione credenziali in Aiuto conferma che le app possono leggerla.

Privacy

Kimiko di per sé non invia nulla online quando un’app di IA lo usa. Il server risponde solo all’app che l’ha avviato e non si connette mai a internet. La ricerca usa il tuo modello di ricerca solo quando gira su Ollama o su un altro server locale sul tuo computer.

Ciò che un’app legge viene gestito da quell’app e dal suo fornitore di IA. Un’app di IA nel cloud invia ciò che legge, compreso il testo delle trascrizioni, al proprio fornitore del modello, secondo i termini di quell’app. Un’app che usa un modello locale può tenere questi dati sul tuo computer. La Modalità solo locale controlla le connessioni di Kimiko stesso; non impedisce a un’app connessa di inviare ciò che legge.

I dettagli di una riunione possono includere informazioni dal tuo calendario, come il titolo dell’evento e le persone invitate, con i loro nomi e indirizzi email. Un’app di IA nel cloud li invia al proprio fornitore come qualsiasi altra cosa che legge.

Cronologia connessioni, in Aiuto, mostra quali app hanno usato Kimiko e quando. Conserva solo nomi delle app, versioni, orari, conteggi e l’ultimo strumento usato, mai ciò che è stato chiesto. Le voci inutilizzate da 90 giorni vengono eliminate.

Consulta Privacy e dati per sapere cosa conserva e cosa invia Kimiko.

Il contenuto delle riunioni non è attendibile

Chiunque partecipi a una riunione può pronunciare frasi rivolte a un’app di IA, come «ignora le tue istruzioni», e uno schermo condiviso può mostrarle. I riepiloghi creati dalla riunione possono ripeterle, e anche il titolo di una riunione proveniente dall’invito di calendario di qualcun altro può contenerle. Kimiko dice all’app di trattare il testo delle trascrizioni, il testo sullo schermo e i riepiloghi come dati, mai come istruzioni.

Rivedi comunque ciò che un’app suggerisce prima di agire. Se la tua app può usare gli strumenti senza chiedere conferma, fai in modo che la chieda prima di create_task e update_task: una modifica può rinominare un’attività, spostarla o cancellarne i dettagli e le date. Kimiko non permette mai a un’app di eliminare un’attività. Se vuoi che le app possano solo leggere, disattiva Consenti modifiche alle attività.

Disattiva l’accesso delle app di IA

Disattiva Consenti le app di IA in Impostazioni → Connessioni. Tutte le app perdono subito l’accesso, e un’app connessa riceve l’errore agent access is off alla richiesta successiva.

Per rimuovere Kimiko da un’app, elimina la voce Kimiko dalle impostazioni di quell’app. Per Claude Code, esegui:

claude mcp remove Kimiko

Risoluzione dei problemi

Aiuto → Non si connette? in Impostazioni → Connessioni elenca le più comuni di queste soluzioni.

Problema	Soluzione
L’app dice che Kimiko non si è avviato o si è disconnesso, oppure segnala agent access is off	Attiva Consenti le app di IA, poi riavvia l’app. Se la causa era l’accesso, il log dell’app mostra agent access is off (per Claude, vedi il suo log più sotto; per Claude Code, esegui claude mcp get Kimiko).
La prima connessione si blocca su Mac	Una richiesta del Portachiavi potrebbe essere nascosta dietro l’app. Scegli Sempre, oppure usa prima Autorizza ora.
Claude Code rinuncia dopo 30 secondi	Avvialo con MCP_TIMEOUT=60000 claude (in PowerShell, $env:MCP_TIMEOUT=60000; claude), oppure usa prima Autorizza ora. claude mcp get Kimiko mostra i messaggi del server.
Kimiko non compare in Claude	Esci completamente da Claude e riaprilo; chiudere la finestra non basta. Il suo log è ~/Library/Logs/Claude/mcp-server-Kimiko.log (su Windows, %APPDATA%\Claude\logs\mcp-server-Kimiko.log).
Solo otto strumenti, senza create_task o update_task	Attiva Consenti modifiche alle attività, poi riavvia l’app (in Claude Code, riconnetti Kimiko da /mcp o avvia una nuova sessione).
Hai spostato Kimiko, oppure la riga di Claude indica Serve un aggiornamento	Scegli Aggiorna nella riga di Claude, poi esci da Claude e riaprilo. Per le altre app, aggiungi di nuovo Kimiko o copia di nuovo il suo frammento da Impostazioni → Connessioni.
Kimiko dice che il file delle impostazioni di Claude non è valido	Correggi il file o rimuovilo, poi scegli di nuovo Aggiungi a Claude. In un file modificato a mano, cerca una virgola mancante o una barra rovesciata singola in un percorso di Windows.
Impostazioni → Connessioni indica che manca una parte di Kimiko	Reinstalla Kimiko.
Una ricerca non restituisce nulla	Chiedi un intervallo di date più ampio, un altro progetto o un altro tipo, oppure chiedi all’app di sfogliare le riunioni con list_meetings.
Una ricerca non trova una riunione	Usa parole pronunciate durante la riunione. Le app cercano per parole chiave, a meno che il tuo modello di ricerca non giri su un server locale.
Il server si chiude subito e dice che il database non è stato trovato	Apri Kimiko una volta, così può creare la tua libreria.
Accesso al Portachiavi indica «Negato»	Segui i passaggi in La richiesta del Portachiavi di macOS.