Assistenti IA

L'app desktop per Mac e Windows può fare da server MCP. A quel punto un assistente come Claude Code o Copilot in VS Code può mostrare le tue condivisioni, condividere file al posto tuo, leggere un file di una condivisione senza scaricarla tutta o mandare qualcosa a un dispositivo vicino. L'assistente parla con l'app sul tuo computer; da noi non passa nulla.

Come attivarlo

Nell'app desktop apri le Impostazioni, cerca «Server MCP» e attivalo. L'app mostra l'indirizzo e un token; copiali entrambi.

http://127.0.0.1:3473/mcp

Il token serve a ogni richiesta. «Rigenera» ne emette uno nuovo e quello vecchio smette subito di funzionare; dovrai sostituirlo in tutti i client che hai configurato.

Il server ascolta su tutte le interfacce di rete del computer, non solo su quella locale, quindi con il token giusto ci si può collegare anche da altri computer della tua rete locale. Non dare il token a nessuno e spegni il server quando non lo usi.

Claude Code

claude mcp add --transport http share-ninja http://127.0.0.1:3473/mcp \
  --header "Authorization: Bearer <token>"

VS Code

Nel .vscode/mcp.json del workspace o nel tuo mcp.json utente:

{
  "servers": {
    "share-ninja": {
      "type": "http",
      "url": "http://127.0.0.1:3473/mcp",
      "headers": { "Authorization": "Bearer <token>" }
    }
  }
}

Qualsiasi altro client che parla MCP su HTTP si configura allo stesso modo: l'indirizzo, e il token come bearer nell'header Authorization.

Cosa può fare l'assistente

Consultare: get_status, list_my_shares, list_shared_with_me, list_transfers, list_nearby, list_workspaces, get_settings.
Leggere da una condivisione senza scaricarla: browse_share mostra un livello di cartella, read_share_range restituisce un file o una sua parte, come testo o come immagine.
Condividere e scaricare: create_share crea un link da file locali, delete_share chiude una condivisione, start_download scarica un link nella cartella dei download o riprende un download già iniziato, pause_transfer, resume_transfer, delete_download.
Dispositivi vicini: send_nearby_share, accept_nearby_offer, reject_nearby_offer.
Diagnosticare l'app: get_diagnostics, recent_events, tail_logs, set_log_level. Nulla di tutto questo restituisce chiavi o token.

Puoi chiedere con parole tue: condividi i PDF di questa cartella e dammi il link; cosa c'è nella condivisione che mi ha mandato Anna; leggi il README di quella condivisione; chiudi tutte le condivisioni più vecchie di una settimana; manda questa build al mio portatile.

L'assistente vede quello che vede l'app e può fare quello che fa l'app, compreso chiudere condivisioni ed eliminare download. Una condivisione di cui non hai la chiave non la può leggere, e nemmeno noi.