AI OS MCP-server & CLIför valfri AI-agent
AI OS MCP-servern ansluter valfri AI-agent till AI OS-plattformen. Din agent får 16 verktyg för att arbeta i din egen AI OS-mapp, söka i färdighetskatalogen, följa ritningarna och svara utifrån de guider som publiceras här.
Ditt AI OS finns i en mapp. Din agent finns i en chatt. AI OS MCP-servern är det som kopplar ihop de två, så att agenten kan öppna mappen, granska den och förbättra den utan att du behöver kopiera något manuellt.
De flesta hör "MCP-server" och antar att det är ett utvecklarverktyg. Det är det inte. Du lägger till den en gång genom att skicka ett meddelande till din agent, och därefter ber du bara om saker på vanlig svenska.
Så den verkliga frågan är inte hur MCP fungerar. Det är vad du skulle be en agent om som kan se hela ditt AI OS.
- Vad AI OS MCP-servern är och vad den kopplar ihop
- Vad du kan be om när den väl är ansluten
- Alla verktyg den ger din agent och vad var och en påverkar
- När du ska använda MCP-servern och när du ska använda CLI
- Vad den kommer att göra och inte göra med dina filer
Låt oss börja med vad det faktiskt är.
Vad är AI OS MCP-servern
AI OS MCP-servern kopplar ihop din AI OS-mapp med den agent du redan använder. MCP är en öppen standard för att ge en agent verktyg som den inte har inbyggda, och denna ger den 16 nya.
Du lägger till den en gång. Därefter kan din agent granska mappen, läsa och skriva dina kontextfiler, hämta guiden för en fil innan den skriver den, och söka i färdighetskatalogen, allt utan att du behöver lämna konversationen.
Var servern körs avgör inte om din agent kan nå dina filer. Det är en egenskap hos appen du använder, eftersom det är appen som ger en server åtkomst till en mapp. Vissa molnagenter gör just det. Tabellen nedan visar vilka verktyg som fungerar i varje fall.
Vad du kan fråga om
När den väl är ansluten pratar du med din agent som vanligt. Var och en av dessa kör ett verktyg från listan längre ner.
“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
Hela ditt AI OS, inuti chatten
16 verktyg, grupperade efter vad de hanterar. Tre av dem täcker hela färdighetskatalogen, snarare än ett verktyg per färdighet, vilket håller kostnaden konstant när katalogen växer.
Granskning
Granskar din mapp och berättar vad som behöver åtgärdas, med det viktigaste först. Varje fynd anger nästa steg.
Kontext
Läser och skriver filerna som innehåller information om vem du är, hur du låter och vad du säljer.
Ritningar
Metoden och en mall för varje fil, så det som skrivs följer din metod.
Färdigheter
Söker i katalogen och installerar en färdighet i ditt AI OS.
Guider
Svaren kommer från guiderna som publicerats här, inte från minnet.
Konto
Din nivå, din tillåtna användning och vad nästa nivå erbjuder.
Varje verktyg, och vad det är till för
Alla 16, med vad var och en faktiskt är till för, var den körs och vad den kan göra med dina filer.
| Verktyg | Vad den är till för | Var den körs | Dina filer |
|---|---|---|---|
| os_audit | Berättar vad som är fel med ditt AI OS och vad du ska åtgärda först. Kör detta före allt annat, och innan du tar någons råd om din installation. | Din maskin | Läser |
| os_init | Startar ett nytt AI OS i en mapp, så din agent har någonstans att lägga det den lär sig om dig. Den skriver avsiktligt tomma mallar och rör aldrig en fil som redan finns där. | Din maskin | Lägger till |
| os_validate | Bekräftar att dina filer faktiskt kan läsas av en agent. Front matter som öppnar och aldrig stänger gör en fil osynlig snarare än trasig, så inget varnar dig. | Din maskin | Läser |
| os_update | Uppdaterar ditt AI OS till den aktuella versionen och lämnar allt du själv har skrivit orört. Den jämför med hash, så dina egna ändringar rapporteras snarare än skrivs över. | Din maskin | Kan ersätta |
| context_list | Visar formen på ditt AI OS i ett ögonkast: vilka kontextfiler som finns, hur mycket som verkligen finns i varje, och när den senast ändrades. | Din maskin | Läser |
| context_read | Öppnar en fil i sin helhet, så en omskrivning bygger på vad du redan sagt istället för att ersätta det med en gissning. | Din maskin | Läser |
| context_write | Sparar det din agent lärt sig om dig i filen som innehåller det. En ny fil skrivs omedelbart. Att ersätta en som redan har innehåll frågar dig först. | Din maskin | Kan ersätta |
| blueprint_list | Visar varje skrivguide och mall på plattformen, så din agent vet vilken hjälp som finns innan den börjar skriva något. | Båda | Läser |
| blueprint_get | Ger din agent metoden för en fil, med en mall och arbetade exempel. Det är detta som får den att skriva på ditt sätt istället för att falla tillbaka på sina egna standardinställningar. | Båda | Läser |
| skills_search | Hittar en färdig färdighet för något du vill att ditt AI OS ska göra, så du inte behöver beskriva det från grunden varje gång. | Båda | Läser |
| skills_get | Visar vad en färdighet faktiskt tillför, innan den kommer i närheten av din mapp. | Båda | Läser |
| skills_install | Lägger en färdighet i ditt AI OS, så varje agent som läser mappen kan använda den. Den vägrar att ersätta en färdighet med samma namn om du inte säger till. | Din maskin | Lägger till |
| docs_search | Svarar på en fråga om AI OS från de guider som publiceras här, snarare än från vad modellen halvt minns. | Båda | Läser |
| docs_get | Läser en guide i sin helhet, för när ett utdrag inte räcker för att agera på. | Båda | Läser |
| whoami | Visar vilket konto du använder, vad du kan använda och hur mycket av dagens tilldelning som återstår. Fråga efter detta först när ett verktyg vägrar. | Båda | Läser |
| upgrade_info | Berättar vad varje nivå inkluderar och vad nästa nivå skulle lägga till för dig. | Båda | Läser |
Var ett verktyg körs handlar om vilken server du anslöt till, inte vilken app du använder. Den lokala servern körs på din egen maskin och kan se din mapp, så den innehåller alla 16. Den hostade servern körs på vår och har ingen kopia av din mapp, så den innehåller de 8 som inte behöver en.
Det är viktigt att vara precis med detta, eftersom det är lätt att missförstå. En agent i molnet är inte avskuren från dina filer. Claude Cowork når de mappar du kopplar till den och skriver i dem med sina egna verktyg, så de 8 hostade verktygen är genuint användbara där. Vad en molnagent inte kan göra är att starta en server på din maskin.
Inget som är markerat "din maskin" är avgiftsbelagt, och inget om dina filer skickas någonstans. Dessa verktyg fungerar utloggade och offline, vilket är anledningen till att granskningen inte kostar något och aldrig kommer att göra det.
AI OS finns i 3 nivåer: AI OS Starter, AI OS Pro och AI OS Max. Varje verktyg som listas här är tillgängligt på AI OS Starter idag. Vad en betald nivå lägger till är djupet i svaret snarare än en längre lista med verktyg.
MCP eller CLI
Båda kommer från samma installation och båda läser en lista med verktyg, så ingen kan ha ett verktyg som den andra saknar. Det är testat snarare än avsett: samma granskning som körs genom båda returnerar ett byte för byte identiskt svar. Det som ändras är när du betalar för det, och vem som skriver.
Vad varje kostar dig
Samma 16 verktyg oavsett. De skiljer sig åt i när du betalar för dem.
| MCP-server | CLI | |
|---|---|---|
| Loaded every turn | 3 315 tokens | 97 tokens |
| Loaded when your AI OS comes up | Inget mer | 1 595 till, en gång |
| Tools | 16 | 16 |
| With AIOS_READ_ONLY=1 | 2 364 tokens, 12 verktyg | Samma 12 |
| Works on the web and on your phone | Ja, via den hostade servern, med 8 verktyg | Nej. Det finns ingen kommandorad där |
| Works with no AI open at all | Nej. MCP är hur en agent når ett verktyg | Ja. Detta är den enda ytan som gör det |
| You start it by | Ber om något med dina egna ord | Skriver ett kommando |
En MCP-server skickar hela sin verktygslista till modellen vid varje tur, oavsett om ditt AI OS dyker upp eller inte. Det är priset för att vara ansluten överhuvudtaget, innan du ber om något. CLI kostar inget förrän det anropas: det som finns i konversationen är 1 rad som beskriver det, och resten anländer först när din agent använder det.
Över 20 turer där ditt AI OS dyker upp en gång, är det 66 300 tokens mot 3 535. När hela konversationen är ditt AI OS, minskar skillnaden och servern ger en bättre upplevelse, eftersom du frågar på vanligt språk istället för att komma ihåg kommandon.
Det mesta av de 3 315 är inget någon kan skriva bort. Det är protokollet som skriver ut 16 verktyg som JSON Schema, och varje server med så här många verktyg betalar ungefär samma. Stäng av det de dagar du inte använder det, och varje klient har ett sätt att göra det.
Antalet förblir konstant när katalogen växer, eftersom en färdighet hämtas när din agent ber om en snarare än skickas när den ansluter. En server med 1 verktyg per färdighet skulle passera 50 000 tokens inom ett år, och det skulle inte finnas någon återvändo från det.
Varje siffra här kom från en verklig handskakning mot denna version, räknad med en tokeniserare snarare än uppskattad från textens längd.
Hur varje är att använda
| Vad du gör | Med MCP | Med CLI |
|---|---|---|
| Auditing a folder before you trust it | Du ber din agent att granska ditt AI OS. Den läser upp rapporten för dig och erbjuder sig att åtgärda det första den hittade. | Du kör aios-cli os-audit och läser rapporten själv. Detta är den du vill ha när du kontrollerar flera mappar, eller kontrollerar en innan en agent någonsin har sett den. |
| Fixing a voice file that is wrong | Din agent hämtar röstritningen, intervjuar dig och skriver filen, allt inom konversationen. | Du hämtar ritningen och skriver filen själv, eller så ber du en agent som kan köra ett kommando att göra det åt dig. |
| Installing a skill | Du säger vad du vill att ditt AI OS ska göra, och din agent söker i katalogen och installerar det. | Du kör aios-cli skills-search, sedan aios-cli skills-install. |
| Setting up a second AI OS | Du öppnar en konversation i den mappen och frågar. | Du kör aios-cli os-init och går vidare. Snabbare när du gör flera. |
| Proving they really are the same thing | Verktygslistan din klient tar emot. | aios-cli schema os-audit skriver ut det exakta schemat som en MCP-klient skickas, så du kan jämföra dem själv. |
Använd MCP som standard. Det är den som låter dig be om något med dina egna ord och få det gjort, vilket är hela poängen med att ha ett AI OS överhuvudtaget.
Använd CLI när det inte finns någon konversation att ha. Du kanske sätter upp flera mappar, eller vill kontrollera en innan en agent har sett den, eller så vill du helt enkelt inte bära med dig verktygslistan i varje konversation.
De flesta använder båda, och båda kommer från samma installation.
Vad granskningen fångar upp
Börja här, oavsett vad du gör i övrigt. Det här är problemen du inte kan se från en fillista, vilket är anledningen till att granskningen finns.
En uppgift i en kontextfil
Inklistrad en gång och läst av varje agent sedan dess. Den rapporteras censurerad, aldrig i sin helhet.
Platshållare som ingen fyllt i
Din agent har läst [Your name] som ett faktum om dig i månader.
Filer som finns men inte säger något
En tom röstfil är värre än en saknad, eftersom den ser hanterad ut.
För lång kontext för att överleva
Namngivna med ordantal, så du vet vilken fil du ska korta och ungefär hur mycket.
Referenser till filer som är borta
Din agent följer dem, hittar inget och fortsätter utan att berätta det för dig.
Allt inaktuellt
Rankad efter hur bärande den är, inte bara efter hur gammal den är.
Vad den kommer och inte kommer att göra
Du riktar en agent mot mappen som beskriver din verksamhet, så detta är värt att läsa innan du ansluter något.
- Dina kontextfiler lämnar aldrig din maskin. Granskningen läser dem där de finns och skickar ingenstans. Endast regeluppsättningen färdas, och den färdas mot dig.
- Skrivningar är aktiverade som standard. En server vars varje skrivning kräver en flagga lär dig att lämna flaggan permanent aktiverad, vilket ser ut som skydd men inte är det.
- Allt som skulle kunna ersätta arbete du inte kan få tillbaka nekas tills du bekräftar det. Det gäller
os_updateoch encontext_writeöver en fil som redan innehåller data. - Ställ in
AIOS_READ_ONLY=1så erbjuds de 4 skrivande verktygen aldrig. Använd det när du riktar en agent du inte helt litar på mot din mapp. - Ställ in
AIOS_AUDIT_LOGtill en fil så loggas varje försök till skrivning, både de som nekades och de som kördes. - En uppgift som hittas i en kontextfil rapporteras maskerad, aldrig i sin helhet, så att fyndet inte blir en andra kopia av läckan.
Nivåer
AI OS finns i tre nivåer: AI OS Starter, AI OS Pro och AI OS Max. Nivån är kopplad till ditt konto snarare än till något du har installerat, så en uppgradering ändrar vad din agent kan göra vid nästa förfrågan, utan att du behöver återansluta något.
Alla verktyg på den här sidan är tillgängliga i AI OS Starter. En betald nivå lägger till djup snarare än en längre lista: den fullständiga uppsättningen granskningsregler, ritningar anpassade till den typ av verksamhet du faktiskt driver, och en högre daglig tilldelning för de verktyg som når våra servrar.
Tilldelningarna publiceras inte här ännu, eftersom begränsningen inte är byggd än. Alla verktyg levereras som AI OS Starter idag. Den här sidan får siffrorna den dag de är verkliga, snarare än en tabell med siffror som inget upprätthåller.
Begränsningar
Lokala verktyg är aldrig avgiftsbelagda. De läser och skriver till din egen mapp, når aldrig våra servrar, och en begränsning på dem skulle kosta dig något samtidigt som det inte sparar oss något.
Värdbaserade verktyg räknas mot en daglig tilldelning på ditt konto. Var och en har en vikt, så ett dyrt verktyg kan inte köras 500 gånger inom en gräns anpassad för billiga verktyg.
När du har slut på tilldelningen anger meddelandet när den återställs istället för att tyst misslyckas. Fråga din agent om whoami när som helst så får du veta vad som återstår.
Inställningar
Inget av dessa är obligatoriskt. De finns till för de tillfällen du vill ha något annat än standardinställningarna.
| Inställning | Vad den gör |
|---|---|
| AIOS_API_KEY | En nyckel som låter en maskin logga in utan webbläsare. Du ställer normalt aldrig in denna. aios-cli login hanterar det och du ser aldrig nyckeln. |
| AIOS_SESSION_PATH | Var inloggningen lagras. Standard är ~/.aios/session.json. |
| AIOS_OS_PATH | Vilken mapp är ditt AI OS. Standard är där du befinner dig, upp till närmaste CLAUDE.md, AGENTS.md eller kontextmapp, på samma sätt som git hittar sin rot. |
| AIOS_READ_ONLY | Sätt den till 1 så erbjuds inga skrivande verktyg alls. 12 verktyg istället för 16. |
| AIOS_AUDIT_LOG | En fil att lägga till varje skrivförsök i, både tillåtna och nekade. |
| AIOS_API_URL | Peka den någon annanstans än api.aios.guide. För testning. |
| AIOS_REQUEST_TIMEOUT_MS | Hur länge ska man vänta på ett svar innan man ger upp. Standard är 30000. |
Vad siffrorna betyder
Ett kommando avslutas med en av dessa. Din agent läser dem så du slipper.
| Kod | Betyder | Vad hände |
|---|---|---|
| 0 | Klar | Det fungerade. |
| 2 | Användning | Kommandot var felaktigt, ett argument saknades, eller en skrivning nekades för att du inte hade bekräftat den. |
| 3 | Hittades ej | Färdigheten, ritningen eller guiden du efterfrågade finns inte. |
| 4 | Logga in | Du är inte inloggad, eller så är inloggningen inte längre giltig. |
| 5 | Server | Något gick fel hos oss, eller så var det nätverket. |
| 7 | Tillåten mängd | Du har använt dagens tillåtna mängd för de hostade verktygen. Meddelandet anger när det återställs. |
| 10 | Ej konfigurerad | Inget är konfigurerat ännu. Kör aios-cli login. |
Har du några frågor?
AI OS ansluter via MCP, Model Context Protocol. MCP är en öppen standard som ger en AI-agent tillgång till externa verktyg.
Du lägger till servern en gång. Därefter kan din agent granska ditt AI OS, läsa och skriva dina kontextfiler, hämta skrivguiden för en fil innan den skriver den, och söka i färdighetskatalogen, allt inom en och samma konversation.
MCP är ett standardiserat sätt för en AI-agent att använda verktyg som inte är inbyggda. Tänk på det som en plugin som fungerar överallt istället för en gång per app.
Du konfigurerar AI OS en gång. Samma anslutning körs sedan i Claude, ChatGPT, Cursor, Codex och alla andra agenter på den här sidan.
CLI:n är samma 16 verktyg som shell-kommandon. Båda ytorna läser en lista med verktyg, så ingen kan ha ett verktyg som den andra saknar.
Du kommunicerar med den på båda sätten. Med MCP anropar din agent verktyget själv. Med CLI:n skriver du `aios-cli os-audit`, eller så ber du en agent som kan köra ett shell att skriva det åt dig.
CLI:n lägger till en sak som MCP inte kan göra. Den körs utan någon agent alls, så du kan lägga den i ett skript, i CI, eller skicka dess JSON till jq. De flesta använder båda, och båda kommer från samma installation.
Alla agenter som talar MCP fungerar, vilket inkluderar de 11 på den här sidan och allt annat som accepterar en server-URL. Det som ändras är var agenten körs.
- 8 agenter körs på din maskin. Claude Code, Cursor, Codex, Gemini CLI, Antigravity, OpenCode, OpenClaw och Hermes får alla 16 verktyg, eftersom de kan läsa och skriva i din mapp. Alla 8 kan också köra CLI:n.
- 3 agenter körs i molnet. Claude Cowork, ChatGPT och Grok Bot ansluter via internet, så de använder de 8 verktyg som inte kräver ett filsystem. Cowork kan fortfarande nå dina filer via Claude Desktop-appen, och Grok Bot kan köra kommandon på din maskin när du tillåter det i dess inställningar.
Den granskar ditt AI OS och hjälper dig sedan att åtgärda det den hittar. Alla andra verktyg finns för att stödja detta.
- Granskningen betygsätter din mapp och returnerar vad som behöver åtgärdas, värst först. Varje fynd anger vad som ska göras härnäst.
- Kontextverktygen läser och skriver vem du är, hur du låter och vad du säljer.
- Ritningarna ger din agent metoden och en mall för varje fil, så den skriver på ditt sätt istället för sitt eget.
- Färdighetsverktygen söker i katalogen och installerar en färdighet i ditt OS.
- Guideverktyget svarar på frågor utifrån det som publiceras här snarare än från minnet.
- Kontoverktygen rapporterar din nivå, din tillåtna användning och vad nästa nivå lägger till.
Granskningen fångar problem du inte kan se från en fillista. Det är anledningen till att den finns.
- Den hittar inloggningsuppgifter inklistrade i en kontextfil och lästa av varje agent sedan dess. Den rapporterar dem redigerade, aldrig i sin helhet.
- Den hittar mallplatshållare som ingen fyllt i. Din agent har läst dessa som fakta.
- Den hittar filer som finns men inte säger något. En tom röstfil är värre än en saknad, eftersom den ser hanterad ut.
- Den hittar kontext som är så lång att slutet av den tappas från fönstret.
- Den hittar referenser som pekar på filer som inte finns.
Nej. Du klistrar in URL:en och loggar in, eller så kör du `aios-cli login` och slutför i webbläsaren som öppnas. Hur som helst ser du aldrig en nyckel.
Alla lokala verktyg fungerar utloggade, inklusive granskningen. Att logga in lägger till katalogen, ritningarna och guiderna.
Grok är den du bör kontrollera innan du börjar. xAI dokumenterar anpassade MCP-anslutningar på grok.com/connectors, och säger att du slutför den inloggning servern ber om där. Grok Bots egen dokumentation täcker ännu inte hur man lägger till en anpassad MCP-server.
AI OS MCP-servern och CLI:n är licensierade under Elastic License 2.0. Du kan läsa källkoden, ändra den och använda den i din egen verksamhet på så många maskiner och projekt du vill.
Det finns 2 saker du inte kan göra. Du kan inte erbjuda den till andra som en hostad eller hanterad tjänst, och du kan inte flytta, ändra eller kringgå nivåkontrollerna.
Det gör den källkodstillgänglig snarare än öppen källkod, vilket är en verklig skillnad och värt att säga rakt ut. AI OS Starter Kit är ett separat arkiv med egen licens.
Nej. Granskningen läser dina filer på din maskin och skickar ingen av dem någonstans. Endast regeluppsättningen laddas ner, och ditt innehåll färdas aldrig åt andra hållet.
Detta är en egenskap hos koden snarare än ett löfte på en sida. Ingenting i den del som läser dina filer får göra en nätverksförfrågan, och ett test i arkivet säkerställer detta.
Alla 16 verktyg kostar cirka 3 659 tokens. Den siffran är mätt från en verklig anslutning, inte uppskattad, och README-filen ger dig kommandot för att kontrollera det själv.
Antalet förblir konstant när katalogen växer. Färdigheter hämtas när din agent ber om en, snarare än att skickas vid anslutningstillfället. En server med 1 verktyg per färdighet skulle passera 50 000 tokens inom ett år.
Inget till att börja med, och du behöver inget konto. AI OS Starter inkluderar alla lokala verktyg utan begränsning, eftersom dessa verktyg aldrig rör våra servrar.
De hostade verktygen har en daglig tillåten användning. AI OS Pro och AI OS Max höjer den tillåtna användningen, lägger till de fylligare granskningsreglerna och lägger till ritningar anpassade till din verksamhet.
Ja. Använd den i din egen verksamhet hur du vill, på så många maskiner och projekt du vill. Den publiceras på npm och körs i Docker, så den passar in var du än redan arbetar.
Ställ in `AIOS_READ_ONLY=1` för att ta bort alla skrivningar från verktygslistan när du pekar en agent du inte helt litar på mot din mapp. Ställ in `AIOS_AUDIT_LOG` för att registrera varje försök till skrivning, både de som nekades och de som kördes.
Det finns också ett API, så en agent är aldrig den enda vägen in.