Collegare agenti IA esterni con MCP

Kosmico può esporre il progetto aperto nell'app desktop come server locale Model Context Protocol. Claude Code, Cursor, VS Code, OpenCode e Codex possono così lavorare sul progetto vivo invece che su una cartella copiata o un contesto incollato.

In questa configurazione Kosmico è il server MCP. Non si collega come client a server MCP di terze parti arbitrari.

Prima di iniziare

Tieni aperta l'app desktop per macOS o Windows con il progetto corretto.
Installa Node.js 18 o successivo, così il client esterno può avviare @kosmico/mcp-server tramite npx.

L'app web non può ospitare il bridge locale. I progetti remoti SSH non vengono registrati nel bridge.

Attivare il server

Apri Impostazioni → Connessioni → Server MCP e attiva il server. Le impostazioni indicano se è in esecuzione e quale progetto sta esponendo.

Nel pannello di configurazione scegli Claude Code, Cursor, VS Code, OpenCode o Codex. Kosmico genera il comando o la configurazione completa per quel client. Copia il valore generato invece di adattare l'esempio di un altro client, perché formati e selettori delle capacità cambiano.

Scegliere gli strumenti disponibili

Usa la connessione completa di compatibilità quando il client si aspetta un unico server ampio. Per uno schema più piccolo, scegli i pacchetti di capacità e collegali come server con nomi indipendenti:

spazio di lavoro
ricerca
documenti Word
presentazioni
notebook
dashboard
Mappa del progetto
Mappa della ricerca
collaborazione
LaTeX
esecuzione

Ogni connessione selezionata sa comunque quale spazio di lavoro Kosmico è aperto. Il pacchetto di esecuzione è facoltativo perché può avviare comandi di shell e celle di notebook sul computer desktop.

Progetti locali, cloud e condivisi

Progetto aperto	Cosa espone MCP
Cartella locale	Lo spazio di lavoro registrato e gli strumenti nativi disponibili
Progetto solo cloud o condiviso	File cloud autenticati e strumenti consentiti dal ruolo attuale
Progetto remoto SSH	Non disponibile tramite MCP
App web senza desktop	Non disponibile

I permessi vengono verificati a ogni chiamata cloud. I Proprietari ricevono l'intera superficie dei file cloud, inclusa l'eliminazione confermata. Gli Editor possono modificare ma non eliminare. I Visualizzatori ricevono strumenti in sola lettura. Testi e notebook cloud funzionano tramite il progetto condiviso; file binari e PDF richiedono ancora una cartella locale.

Sicurezza e aggiornamenti

Il bridge è uno stdio locale ospitato dall'app desktop in esecuzione. Kosmico non pubblica un endpoint MCP HTTP o OAuth. Mantieni privata la configurazione generata e abilita l'esecuzione solo per agenti a cui affideresti progetto e terminale.

Le impostazioni avvisano quando il pacchetto MCP locale è più vecchio della versione prevista dall'app. Riavviare il client esterno consente normalmente a npx di recuperare la versione nuova; le impostazioni spiegano anche come svuotare la cache quando serve.