Server AI OS MCP e CLIper qualsiasi agente AI
Il server AI OS MCP connette qualsiasi agente AI alla piattaforma AI OS. Il tuo agente ottiene 16 strumenti, così può lavorare nella tua cartella AI OS, cercare nel catalogo delle competenze, seguire i progetti e rispondere basandosi sulle guide qui pubblicate.
Il tuo AI OS risiede in una cartella. Il tuo agente risiede in una chat. Il server AI OS MCP è ciò che connette i due, permettendo all'agente di aprire la cartella, esaminarla e migliorarla senza che tu debba copiare nulla.
Molti sentono "server MCP" e pensano sia uno strumento per sviluppatori. Non lo è. Lo aggiungi una sola volta inviando un messaggio al tuo agente, e da quel momento in poi chiedi semplicemente le cose in linguaggio naturale.
Quindi la vera domanda non è come funziona MCP. È cosa chiederesti a un agente che può vedere l'intero tuo AI OS.
- Cos'è il server AI OS MCP e cosa connette
- Cosa puoi chiedere una volta connesso
- Ogni strumento che fornisce al tuo agente e cosa modifica ciascuno
- Quando usare il server MCP e quando usare la CLI
- Cosa farà e cosa non farà ai tuoi file
Cominciamo da cos'è realmente.
Cos'è il server AI OS MCP
Il server AI OS MCP è un collegamento tra la tua cartella AI OS e l'agente che già utilizzi. MCP è uno standard aperto per fornire a un agente strumenti che non ha integrati, e questo gliene fornisce 16.
Lo aggiungi una volta. Dopodiché il tuo agente può controllare la cartella, leggere e scrivere i tuoi file di contesto, recuperare la guida per un file prima di scriverlo e cercare nel catalogo delle competenze, senza che tu debba uscire dalla conversazione.
La posizione in cui il server è in esecuzione non determina se il tuo agente può raggiungere i tuoi file. Questa è una proprietà dell'applicazione che stai utilizzando, perché è l'applicazione che concede a un server l'accesso a una cartella. Alcuni agenti cloud fanno esattamente questo. La tabella seguente indica quali strumenti funzionano in ogni caso.
Cosa puoi chiedere
Una volta connesso, puoi parlare normalmente con il tuo agente. Ognuna di queste esegue uno strumento dall'elenco più in basso.
“Audit my AI OS.”
os_audit
“What is wrong with my CLAUDE.md?”
os_audit, context_read
“My agent keeps losing my voice. Fix it.”
blueprint_get, context_write
“Set up an AI OS here and interview me for it.”
os_init, blueprint_get
“Is there a skill for writing newsletters?”
skills_search
“What actually goes in a context file?”
docs_search
“Which tier am I on, and what would Pro add?”
whoami, upgrade_info
“Check nothing in my folder is stale.”
os_audit
Tutto il tuo AI OS, all'interno della chat
16 strumenti, raggruppati per ambito. 3 di questi coprono l'intero catalogo di competenze, anziché uno strumento per competenza, il che mantiene i costi stabili all'espandersi del catalogo.
Verifica
Valuta la tua cartella e ti indica cosa correggere, partendo dal più critico. Ogni risultato suggerisce i passi successivi.
Contesto
Legge e scrive i file che definiscono chi sei, il tuo tono di voce e cosa vendi.
Progetti
Il metodo e un modello per ogni file, in modo che ciò che viene scritto segua il tuo metodo.
Competenze
Cerca nel catalogo e installa una competenza nel tuo AI OS.
Guide
Le risposte provengono dalle guide qui pubblicate, non dalla memoria.
Account
Il tuo piano, il tuo credito e cosa aggiunge il piano successivo.
Ogni strumento e a cosa serve
Tutti i 16, con la loro funzione specifica, dove vengono eseguiti e cosa possono fare ai tuoi file.
| Strumento | A cosa serve | Dove viene eseguito | I tuoi file |
|---|---|---|---|
| os_audit | Ti dice cosa c'è di sbagliato nel tuo AI OS e cosa risolvere per primo. Esegui questo prima di qualsiasi altra cosa, e prima di accettare consigli sulla tua configurazione. | La tua macchina | Legge |
| os_init | Avvia un nuovo AI OS in una cartella, in modo che il tuo agente abbia un posto dove mettere ciò che impara su di te. Scrive modelli vuoti di proposito e non tocca mai un file già esistente. | La tua macchina | Aggiunge |
| os_validate | Conferma che i tuoi file possono essere effettivamente letti da un agente. Un front matter che si apre e non si chiude rende un file invisibile anziché corrotto, quindi nulla ti avvisa. | La tua macchina | Legge |
| os_update | Aggiorna il tuo AI OS alla versione corrente e lascia intatto tutto ciò che hai scritto tu stesso. Confronta tramite hash, quindi le tue modifiche vengono segnalate anziché sovrascritte. | La tua macchina | Può sostituire |
| context_list | Mostra la struttura del tuo AI OS a colpo d'occhio: quali file di contesto esistono, quanto c'è realmente in ciascuno e quando è stato modificato l'ultima volta. | La tua macchina | Legge |
| context_read | Apre un file completo, in modo che una riscrittura si basi su ciò che hai già detto invece di sostituirlo con un'ipotesi. | La tua macchina | Legge |
| context_write | Salva ciò che il tuo agente ha imparato su di te nel file che lo contiene. Un nuovo file viene scritto immediatamente. La sostituzione di un file che ha già contenuto ti chiede prima conferma. | La tua macchina | Può sostituire |
| blueprint_list | Mostra ogni guida di scrittura e modello sulla piattaforma, in modo che il tuo agente sappia quale aiuto esiste prima di iniziare a scrivere qualsiasi cosa. | Entrambi | Legge |
| blueprint_get | Fornisce al tuo agente il metodo per un file, con un modello ed esempi pratici. Questo è ciò che gli permette di scrivere a modo tuo invece di ricorrere alle sue impostazioni predefinite. | Entrambi | Legge |
| skills_search | Trova una skill già pronta per qualcosa che vuoi che il tuo AI OS faccia, in modo da non doverla descrivere da zero ogni volta. | Entrambi | Legge |
| skills_get | Ti mostra cosa aggiunge effettivamente una skill, prima che si avvicini alla tua cartella. | Entrambi | Legge |
| skills_install | Installa una skill nel tuo AI OS, in modo che ogni agente che legge la cartella possa usarla. Si rifiuta di sostituire una skill con lo stesso nome a meno che tu non lo specifichi. | La tua macchina | Aggiunge |
| docs_search | Risponde a una domanda su AI OS basandosi sulle guide pubblicate qui, piuttosto che su ciò che il modello ricorda a metà. | Entrambi | Legge |
| docs_get | Legge una guida completa, per quando un estratto non è sufficiente per agire. | Entrambi | Legge |
| whoami | Indica quale account stai usando, cosa puoi utilizzare e quanto del tuo credito giornaliero è rimasto. Chiedi questo per primo quando uno strumento si rifiuta di funzionare. | Entrambi | Legge |
| upgrade_info | Indica cosa include ogni livello e cosa aggiungerebbe per te il livello successivo. | Entrambi | Legge |
Dove viene eseguito uno strumento dipende dal server a cui ti sei connesso, non dall'app che usi. Il server locale gira sulla tua macchina e può vedere la tua cartella, quindi include tutti i 16 strumenti. Il server ospitato gira sui nostri server e non ha una copia della tua cartella, quindi include gli 8 che non ne hanno bisogno.
È importante essere precisi su questo, perché è facile confondersi. Un agente nel cloud non è isolato dai tuoi file. Claude Cowork accede alle cartelle che gli alleghi e scrive al loro interno con i propri strumenti, quindi gli 8 strumenti ospitati sono davvero utili in quel contesto. Ciò che un agente cloud non può fare è avviare un server sulla tua macchina.
Nulla di ciò che riguarda la tua macchina viene misurato, e nulla dei tuoi file viene inviato altrove. Questi strumenti funzionano anche senza accesso e offline, motivo per cui l'audit non costa nulla e non costerà mai.
AI OS è disponibile in 3 livelli: AI OS Starter, AI OS Pro e AI OS Max. Ogni strumento elencato qui è disponibile oggi su AI OS Starter. Un livello a pagamento aggiunge la profondità della risposta piuttosto che un elenco più lungo di strumenti.
MCP o la CLI
Entrambi provengono dalla stessa installazione ed entrambi leggono un elenco di strumenti, quindi nessuno dei due può avere uno strumento che manca all'altro. Questo è testato piuttosto che intenzionale: lo stesso audit eseguito su entrambi restituisce una risposta identica byte per byte. Ciò che cambia è quando lo paghi e chi digita.
Cosa ti costa ciascuno
Gli stessi 16 strumenti in entrambi i casi. Differiscono nel momento in cui li paghi.
| Server MCP | CLI | |
|---|---|---|
| Loaded every turn | 3.315 token | 97 token |
| Loaded when your AI OS comes up | Niente di più | 1.595 in più, una volta |
| Tools | 16 | 16 |
| With AIOS_READ_ONLY=1 | 2.364 token, 12 strumenti | Gli stessi 12 |
| Works on the web and on your phone | Sì, tramite il server ospitato, con 8 strumenti | No. Non c'è una riga di comando lì |
| Works with no AI open at all | No. MCP è il modo in cui un agente raggiunge uno strumento | Sì. Questa è l'unica interfaccia che lo fa |
| You start it by | Chiedendo qualcosa a parole tue | Digitando un comando |
Un server MCP invia il suo intero elenco di strumenti al modello ad ogni turno, che il tuo AI OS si attivi o meno. Questo è il prezzo di essere connessi, prima ancora di chiedere qualsiasi cosa. La CLI non costa nulla finché non viene chiamata: ciò che rimane nella conversazione è 1 riga che la descrive, e il resto arriva solo quando il tuo agente la richiede.
Su 20 turni in cui il tuo AI OS si attiva una volta, si tratta di 66.300 token contro 3.535. Quando l'intera conversazione è il tuo AI OS, il divario si riduce e il server offre un'esperienza migliore, perché chiedi in linguaggio naturale invece di ricordare i comandi.
La maggior parte dei 3.315 token non è qualcosa che si possa eliminare. È il protocollo che scrive 16 strumenti come JSON Schema, e qualsiasi server con così tanti strumenti paga all'incirca lo stesso. Spegnilo nei giorni in cui non lo usi, e ogni client ha un modo per farlo.
Il numero rimane invariato man mano che il catalogo cresce, perché una skill viene recuperata quando il tuo agente ne chiede una piuttosto che spedita quando si connette. Un server con 1 strumento per skill passerebbe 50.000 token in un anno, e non ci sarebbe modo di tornare indietro.
Tutti i numeri qui provengono da un handshake reale con questa build, contati con un tokenizzatore piuttosto che stimati dalla lunghezza del testo.
Come si usa ciascuno
| Cosa stai facendo | Con MCP | Con la CLI |
|---|---|---|
| Auditing a folder before you trust it | Chiedi al tuo agente di controllare il tuo AI OS. Ti legge il rapporto e si offre di correggere la prima cosa che ha trovato. | Esegui aios-cli os-audit e leggi il rapporto tu stesso. Questo è quello che vuoi quando stai controllando diverse cartelle, o controllandone una prima che un agente l'abbia mai vista. |
| Fixing a voice file that is wrong | Il tuo agente recupera il blueprint vocale, ti intervista e scrive il file, tutto all'interno della conversazione. | Recuperi il blueprint e scrivi il file tu stesso, oppure chiedi a un agente che può eseguire un comando di farlo per te. |
| Installing a skill | Dici cosa vuoi che faccia il tuo AI OS, e il tuo agente cerca nel catalogo e lo installa. | Esegui aios-cli skills-search, poi aios-cli skills-install. |
| Setting up a second AI OS | Apri una conversazione in quella cartella e chiedi. | Esegui aios-cli os-init e prosegui. Più veloce quando ne stai facendo diversi. |
| Proving they really are the same thing | L'elenco degli strumenti che il tuo client riceve. | aios-cli schema os-audit stampa lo schema esatto che viene inviato a un client MCP, così puoi confrontarli tu stesso. |
Usa MCP come predefinito. È quello che ti permette di chiedere qualcosa a parole tue e di vederlo realizzato, che è il senso stesso di avere un AI OS.
Ricorri alla CLI quando non c'è una conversazione da fare. Stai impostando diverse cartelle, o vuoi controllarne una prima che un agente l'abbia vista, o preferisci non portare l'elenco degli strumenti in ogni conversazione.
La maggior parte delle persone finisce per usarli entrambi, ed entrambi provengono dalla stessa installazione.
Cosa rileva l'audit
Inizia da qui, a prescindere da qualsiasi altra cosa tu faccia. Questi sono i problemi che non puoi vedere da un elenco di file, ed è il motivo per cui esiste l'audit.
Una credenziale in un file di contesto
Incollato una volta e letto da ogni agente da allora. Viene segnalato redatto, mai per intero.
Segnaposto che nessuno ha compilato
Il tuo agente ha letto [Your name] come un fatto su di te per mesi.
File che esistono e non dicono nulla
Un file vocale vuoto è peggiore di uno mancante, perché sembra gestito.
Contesto troppo lungo per essere utile
Nominati con il conteggio delle parole, così sai quale file tagliare e all'incirca di quanto.
Riferimenti a file che non esistono più
Il tuo agente li segue, non trova nulla e prosegue senza dirtelo.
Tutto ciò che è obsoleto
Classificato in base a quanto è portante, non solo in base alla sua età.
Cosa farà e cosa non farà
Stai puntando un agente sulla cartella che descrive la tua attività, quindi vale la pena leggerlo prima di connettere qualsiasi cosa.
- I tuoi file di contesto non lasciano mai la tua macchina. L'audit li legge dove si trovano e non ne invia nessuno altrove. Solo il set di regole viaggia, e viaggia verso di te.
- Le scritture sono attive per impostazione predefinita. Un server la cui ogni scrittura necessita di un flag ti insegna a lasciare quel flag sempre attivo, il che sembra protezione ma non lo è.
- Tutto ciò che potrebbe sostituire un lavoro che non puoi recuperare viene rifiutato finché non lo confermi. Questo include
os_updatee unacontext_writesu un file che contiene già del contenuto. - Imposta
AIOS_READ_ONLY=1e i 4 strumenti che scrivono non verranno mai offerti. Usalo quando punti un agente di cui non ti fidi completamente sulla tua cartella. - Imposta
AIOS_AUDIT_LOGsu un file e ogni tentativo di scrittura viene registrato, sia quelli rifiutati che quelli eseguiti. - Una credenziale trovata in un file di contesto viene segnalata in forma redatta, mai per intero, in modo che il ritrovamento non diventi una seconda copia della fuga di dati.
Livelli
AI OS è disponibile in 3 livelli: AI OS Starter, AI OS Pro e AI OS Max. Il livello è associato al tuo account piuttosto che a qualsiasi cosa tu abbia installato, quindi un aggiornamento cambia ciò che il tuo agente può fare alla sua prossima richiesta, senza bisogno di riconnettere nulla.
Tutti gli strumenti presenti in questa pagina sono disponibili con AI OS Starter. Ciò che un livello a pagamento aggiunge è profondità piuttosto che un elenco più lungo: il set completo di regole di audit, i blueprint corrispondenti al tipo di attività che svolgi realmente e un'indennità giornaliera più elevata per gli strumenti che raggiungono i nostri server.
Le indennità non sono ancora pubblicate qui, perché il sistema di gating non è ancora stato implementato. Ogni strumento viene fornito oggi come AI OS Starter. Questa pagina riporterà i numeri il giorno in cui saranno effettivi, piuttosto che una tabella di cifre non ancora applicate.
Limiti
Gli strumenti locali non sono mai a consumo. Leggono e scrivono nella tua cartella, non raggiungono mai i nostri server e un limite su di essi costerebbe a te qualcosa senza farci risparmiare nulla.
Gli strumenti ospitati contano ai fini di un'indennità giornaliera sul tuo account. Ognuno ha un peso, quindi uno strumento costoso non può essere eseguito 500 volte all'interno di un limite dimensionato per quelli economici.
Quando esaurisci il limite, il rifiuto indica l'ora in cui si resetta anziché fallire silenziosamente. Chiedi al tuo agente whoami in qualsiasi momento e ti dirà cosa rimane.
Impostazioni
Nessuna di queste è obbligatoria. Esistono per i casi in cui si desidera qualcosa di diverso dall'impostazione predefinita.
| Impostazione | Cosa fa |
|---|---|
| AIOS_API_KEY | Una chiave per consentire a una macchina di accedere senza browser. Normalmente non la si imposta mai. aios-cli login la gestisce e non si vede mai una chiave. |
| AIOS_SESSION_PATH | Dove viene memorizzato l'accesso. L'impostazione predefinita è ~/.aios/session.json. |
| AIOS_OS_PATH | Qual è la cartella del tuo AI OS. L'impostazione predefinita è la posizione attuale, risalendo fino alla più vicina cartella CLAUDE.md, AGENTS.md o context, nello stesso modo in cui git trova la sua root. |
| AIOS_READ_ONLY | Impostalo su 1 e nessun tool di scrittura verrà offerto. 12 tool invece di 16. |
| AIOS_AUDIT_LOG | Un file a cui aggiungere ogni tentativo di scrittura, sia consentito che rifiutato. |
| AIOS_API_URL | Puntala a un indirizzo diverso da api.aios.guide. Per i test. |
| AIOS_REQUEST_TIMEOUT_MS | Quanto tempo attendere una risposta prima di arrendersi. L'impostazione predefinita è 30000. |
Cosa significano i numeri
Un comando termina con uno di questi. Il tuo agente li legge così non devi farlo tu.
| Codice | Significato | Cosa è successo |
|---|---|---|
| 0 | Fatto | Ha funzionato. |
| 2 | Uso | Il comando era sbagliato, mancava un argomento, oppure una scrittura è stata rifiutata perché non l'avevi confermata. |
| 3 | Non trovato | La skill, il blueprint o la guida che hai richiesto non esiste. |
| 4 | Accesso | Non hai effettuato l'accesso, oppure l'accesso non è più valido. |
| 5 | Server | Qualcosa è andato storto da parte nostra, oppure la rete ha avuto un problema. |
| 7 | Credito | Hai esaurito il credito giornaliero per gli strumenti ospitati. Il messaggio indica quando si resetta. |
| 10 | Non configurato | Niente è ancora configurato. Esegui aios-cli login. |
Hai ancora domande?
AI OS si connette tramite MCP, il Model Context Protocol. MCP è uno standard aperto che consente a un agente AI di accedere a strumenti esterni a sé stesso.
Aggiungi il server una sola volta. Dopodiché, il tuo agente può controllare il tuo AI OS, leggere e scrivere i tuoi file di contesto, recuperare la guida di scrittura per un file prima di scriverlo e cercare nel catalogo delle competenze, tutto all'interno di una singola conversazione.
MCP è un modo standard per un agente AI di utilizzare strumenti che non sono integrati in esso. Pensalo come un plugin che funziona ovunque invece che una volta per app.
Configuri AI OS una sola volta. La stessa connessione funziona poi in Claude, ChatGPT, Cursor, Codex e ogni altro agente su questa pagina.
La CLI è composta dagli stessi 16 strumenti dei comandi shell. Entrambe le interfacce leggono un unico elenco di strumenti, quindi nessuna delle due può avere uno strumento che manca all'altra.
Ci parli in entrambi i modi. Con MCP il tuo agente chiama lo strumento stesso. Con la CLI digiti `aios-cli os-audit`, oppure chiedi a un agente in grado di eseguire una shell di digitarlo per te.
La CLI aggiunge una cosa che MCP non può fare. Funziona senza alcun agente, quindi puoi inserirla in uno script, in CI, o inviare il suo JSON a jq. La maggior parte delle persone usa entrambi, ed entrambi provengono dalla stessa installazione.
Funziona ogni agente che parla MCP, il che include gli 11 su questa pagina e qualsiasi altra cosa che accetti un URL del server. Ciò che cambia è dove l'agente viene eseguito.
- 8 agenti vengono eseguiti sulla tua macchina. Claude Code, Cursor, Codex, Gemini CLI, Antigravity, OpenCode, OpenClaw e Hermes ottengono tutti 16 strumenti, perché possono leggere e scrivere la tua cartella. Tutti e 8 possono anche eseguire la CLI.
- 3 agenti vengono eseguiti nel cloud. Claude Cowork, ChatGPT e Grok Bot si connettono tramite internet, quindi partono con gli 8 strumenti che non necessitano di un filesystem. Cowork può comunque raggiungere i tuoi file tramite l'app Claude Desktop, e Grok Bot può eseguire comandi sulla tua macchina una volta che lo consenti nelle sue impostazioni.
Controlla il tuo AI OS e poi ti aiuta a risolvere ciò che trova. Ogni altro strumento esiste per supportare questo.
- L'audit valuta la tua cartella e restituisce cosa correggere, dal peggiore al primo. Ogni risultato indica cosa fare dopo.
- Gli strumenti di contesto leggono e scrivono chi sei, come suoni e cosa vendi.
- I blueprint danno al tuo agente il metodo e un modello per ogni file, in modo che scriva a modo tuo invece che a modo suo.
- Gli strumenti delle competenze cercano nel catalogo e installano una competenza nel tuo OS.
- Lo strumento delle guide risponde alle domande basandosi su ciò che è pubblicato qui piuttosto che sulla memoria.
- Gli strumenti dell'account riportano il tuo livello, la tua quota e cosa aggiunge il livello successivo.
L'audit rileva i problemi che non puoi vedere da un elenco di file. Questo è il motivo della sua esistenza.
- Trova credenziali incollate in un file di contesto e lette da ogni agente da allora. Le segnala oscurate, mai per intero.
- Trova segnaposto di modelli che nessuno ha compilato. Il tuo agente li ha letti come fatti.
- Trova file che esistono e non dicono nulla. Un file vocale vuoto è peggio di uno mancante, perché sembra gestito.
- Trova contesti così lunghi che la fine viene tagliata dalla finestra.
- Trova riferimenti che puntano a file che non esistono.
No. Incolli l'URL e accedi, oppure esegui `aios-cli login` e completi nel browser che si apre. In entrambi i casi non vedrai mai una chiave.
Ogni strumento locale funziona senza accesso, incluso l'audit. L'accesso aggiunge il catalogo, i blueprint e le guide.
Grok è quello da controllare prima di iniziare. xAI documenta i connettori MCP personalizzati su grok.com/connectors e afferma che completi qualsiasi accesso richiesto dal server lì. La documentazione di Grok Bot non copre ancora l'aggiunta di un server MCP personalizzato.
Il server AI OS MCP e la CLI sono concessi in licenza con la Elastic License 2.0. Puoi leggere il codice sorgente, modificarlo e usarlo nella tua attività su quante macchine e progetti desideri.
Ci sono 2 cose che non puoi fare. Non puoi offrirlo ad altre persone come servizio ospitato o gestito, e non puoi spostare, modificare o aggirare i controlli di livello.
Questo lo rende disponibile come sorgente piuttosto che open source, il che è una vera differenza e vale la pena dirlo chiaramente. L'AI OS Starter Kit è un repository separato con la sua licenza.
No. L'audit legge i tuoi file sulla tua macchina e non ne invia nessuno da nessuna parte. Viene scaricato solo il set di regole, e il tuo contenuto non viaggia mai nell'altra direzione.
Questa è una proprietà del codice piuttosto che una promessa su una pagina. Nulla nella parte che legge i tuoi file è autorizzato a effettuare una richiesta di rete, e un test nel repository lo impone.
Tutti i 16 strumenti costano circa 3.659 token. Questa cifra è misurata da una connessione reale, non stimata, e il README ti fornisce il comando per verificarla tu stesso.
Il numero rimane invariato man mano che il catalogo cresce. Le competenze vengono recuperate quando il tuo agente ne richiede una, piuttosto che spedite al momento della connessione. Un server con 1 strumento per competenza supererebbe i 50.000 token entro un anno.
Niente per iniziare, e non hai bisogno di un account. AI OS Starter include ogni strumento locale senza limiti, perché questi strumenti non toccano mai i nostri server.
Gli strumenti ospitati hanno una quota giornaliera. AI OS Pro e AI OS Max aumentano questa quota, aggiungono le regole di audit più complete e aggiungono blueprint abbinati alla tua attività.
Sì. Usalo nella tua attività come preferisci, su quante macchine e progetti desideri. È pubblicato su npm e funziona in Docker, quindi si adatta ovunque tu stia già lavorando.
Imposta `AIOS_READ_ONLY=1` per rimuovere ogni scrittura dall'elenco degli strumenti quando punti un agente di cui non ti fidi completamente alla tua cartella. Imposta `AIOS_AUDIT_LOG` per registrare ogni tentativo di scrittura, quelli rifiutati così come quelli eseguiti.
Esiste anche un'API, quindi un agente non è mai l'unico modo per entrare.