Collegare un assistente

Un’app di IA sullo stesso computer dell’app desktop avvia da sola il server MCP di Trusted Codes e comunica con esso tramite una pipe. Non viene aperto nulla verso la rete. Gli assistenti nel browser non possono collegarsi; Assistenti nel browser spiega perché.

Una versione successiva dell’app desktop collegherà Claude Desktop con un clic. Fino ad allora, i passaggi di questa pagina usano il Terminale.

Prima di iniziare

• Installa l’app desktop e accedi una volta.
• Su un Mac, l’app deve trovarsi nella cartella Applicazioni. Una copia avviata dall’immagine disco scaricata o dalla cartella Download scrive un percorso che smette di funzionare.
• Su Windows e Linux, una versione successiva dell’app farà il collegamento per te. I comandi di questa pagina valgono per il Mac.

Claude Desktop (Mac)

1. Chiudi completamente Claude Desktop (⌘Q).

2. Apri il Terminale ed esegui:

   "/Applications/Trusted Codes.app/Contents/MacOS/tcc-desktop" mcp configure claude-desktop

3. Riapri Claude Desktop.

Cursor (Mac)

1. Chiudi completamente Cursor (⌘Q).

2. Apri il Terminale ed esegui:

   "/Applications/Trusted Codes.app/Contents/MacOS/tcc-desktop" mcp configure cursor

3. Riapri Cursor.

Claude Code (Mac)

Apri il Terminale ed esegui:

claude mcp add --scope user trusted-codes -- "/Applications/Trusted Codes.app/Contents/MacOS/tcc-desktop" mcp

Poi avvia una nuova sessione di Claude Code. Non usare mcp configure claude-code: la versione attuale scrive un file che Claude Code non legge.

Che cosa scrive il comando

mcp configure aggiunge una voce chiamata trusted-codes al file delle impostazioni dell’app di IA:

• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
• Cursor: ~/.cursor/mcp.json

{
  "mcpServers": {
    "trusted-codes": {
      "command": "/Applications/Trusted Codes.app/Contents/MacOS/tcc-desktop",
      "args": ["mcp"]
    }
  }
}

Le altre voci del file restano, con un’eccezione nella versione attuale: se il file non si può leggere, per esempio dopo una modifica a mano con un errore di battitura, il comando lo sostituisce con un file che contiene solo la voce di Trusted Codes. Se hai modificato il file a mano, fanne prima una copia.

Verificare e rimuovere

"/Applications/Trusted Codes.app/Contents/MacOS/tcc-desktop" mcp status
"/Applications/Trusted Codes.app/Contents/MacOS/tcc-desktop" mcp remove cursor

status mostra se Claude Desktop e Cursor hanno una voce trusted-codes. Per Claude Code, esegui claude mcp list. Dopo remove, chiudi l’app di IA e riaprila.

Come funziona il collegamento

L’app di IA avvia il programma dell’app desktop come processo figlio e comunica con esso in JSON-RPC tramite input e output standard. È l’unica via con cui un assistente raggiunge Trusted Codes, ed è l’unica su cui è disponibile lo strumento del timbro fornitore, perché firma con la chiave di quella macchina.

L’avvio è volutamente immediato: nessuna richiesta del portachiavi, nessuna chiamata di rete, nessun browser. Non viene controllato nulla finché l’assistente non chiama il suo primo strumento. Se non hai effettuato l’accesso, quella chiamata torna come AUTH_REQUIRED; l’assistente chiama lo strumento di accesso, si apre un browser e riprova. Su un nuovo dispositivo l’accesso può rispondere invece recovery_required, e l’assistente ti chiederà le tre parole di recupero dell’app mobile.

Se il tuo piano non lo include

mcp configure controlla il tuo account prima di scrivere qualcosa e ti avvisa se il server MCP non fa parte del tuo piano. Il controllo è un’indicazione data mentre qualcuno aspetta una risposta, non un blocco. Il server gira sulla tua macchina con una chiave che possiedi già e calcola i codici offline, quindi nessun server può rifiutarlo.