Servidor AI OS MCP y CLIpara cualquier agente de IA
El servidor AI OS MCP conecta cualquier agente de IA a la plataforma AI OS. Tu agente obtiene 16 herramientas para trabajar en tu propia carpeta de AI OS, buscar en el catálogo de habilidades, seguir los planos y responder desde las guías publicadas aquí.
Tu AI OS reside en una carpeta. Tu agente reside en un chat. El servidor MCP de AI OS es lo que los conecta, permitiendo que el agente acceda a la carpeta, la revise y la mejore sin que tengas que copiar nada.
La mayoría de la gente escucha "servidor MCP" y asume que es una herramienta para desarrolladores. No lo es. Lo añades una sola vez enviando un mensaje a tu agente, y a partir de entonces solo tienes que pedirle cosas en lenguaje natural.
Así que la verdadera pregunta no es cómo funciona MCP, sino qué le pedirías a un agente que puede ver todo tu AI OS.
- Qué es el servidor MCP de AI OS y qué conecta
- Qué puedes pedirle una vez conectado
- Todas las herramientas que proporciona a tu agente y qué toca cada una
- Cuándo usar el servidor MCP y cuándo usar la CLI
- Qué hará y qué no hará con tus archivos
Empecemos por lo que realmente es.
¿Qué es el servidor AI OS MCP?
El servidor AI OS MCP es una conexión entre tu carpeta AI OS y el agente que ya utilizas. MCP es un estándar abierto para proporcionar a un agente herramientas que no tiene integradas, y este le proporciona 16.
Lo añades una sola vez. Después de eso, tu agente puede auditar la carpeta, leer y escribir tus archivos de contexto, obtener la guía de un archivo antes de escribirlo y buscar en el catálogo de habilidades, sin que tengas que salir de la conversación.
El lugar donde se ejecuta el servidor no determina si tu agente puede acceder a tus archivos. Esa es una propiedad de la aplicación que estás utilizando, porque la aplicación es la que otorga a un servidor acceso a una carpeta. Algunos agentes en la nube hacen exactamente eso. La siguiente tabla indica qué herramientas funcionan en cada caso.
Qué puedes pedir
Una vez conectado, hablas con tu agente con normalidad. Cada una de estas acciones ejecuta una herramienta de la lista inferior.
“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
Todo tu AI OS, dentro del chat
16 herramientas, agrupadas por su ámbito de acción. 3 de ellas cubren todo el catálogo de habilidades, en lugar de una herramienta por habilidad, lo que mantiene el coste fijo a medida que el catálogo crece.
Auditoría
Califica tu carpeta y te dice qué arreglar, priorizando lo más importante. Cada hallazgo indica los pasos a seguir.
Contexto
Lee y escribe los archivos que contienen quién eres, cómo te expresas y qué vendes.
Esquemas
El método y una plantilla para cada archivo, para que lo que se escriba siga tu método.
Habilidades
Busca en el catálogo e instala una habilidad en tu AI OS.
Guías
Las respuestas provienen de las guías publicadas aquí, no de la memoria.
Cuenta
Tu nivel, tu asignación y lo que añade el siguiente nivel.
Todas las herramientas y para qué sirven
Las 16 herramientas, con su propósito real, dónde se ejecutan y qué pueden hacer con tus archivos.
| Herramienta | Para qué sirve | Dónde se ejecuta | Tus archivos |
|---|---|---|---|
| os_audit | Te dice qué está mal con tu AI OS y qué arreglar primero. Ejecuta esto antes que nada, y antes de aceptar cualquier consejo sobre tu configuración. | Tu máquina | Lee |
| os_init | Inicia un nuevo AI OS en una carpeta, para que tu agente tenga dónde guardar lo que aprende sobre ti. Escribe plantillas vacías a propósito y nunca toca un archivo que ya exista. | Tu máquina | Añade |
| os_validate | Confirma que tus archivos pueden ser leídos por un agente. Un 'front matter' que se abre y nunca se cierra hace que un archivo sea invisible en lugar de estar roto, por lo que nada te lo advierte. | Tu máquina | Lee |
| os_update | Actualiza tu AI OS a la versión actual y deja intacto todo lo que escribiste. Compara por hash, por lo que tus propias ediciones se reportan en lugar de ser sobrescritas. | Tu máquina | Puede reemplazar |
| context_list | Muestra la forma de tu AI OS de un vistazo: qué archivos de contexto existen, cuánto hay realmente en cada uno y cuándo fue la última vez que se modificó. | Tu máquina | Lee |
| context_read | Abre un archivo completo, para que una reescritura se base en lo que ya dijiste en lugar de reemplazarlo con una suposición. | Tu máquina | Lee |
| context_write | Guarda lo que tu agente aprendió sobre ti en el archivo que lo contiene. Un archivo nuevo se escribe de inmediato. Reemplazar uno que ya tiene contenido te pregunta primero. | Tu máquina | Puede reemplazar |
| blueprint_list | Muestra cada guía de escritura y plantilla en la plataforma, para que tu agente sepa qué ayuda existe antes de empezar a escribir cualquier cosa. | Ambos | Lee |
| blueprint_get | Entrega a tu agente el método para un archivo, con una plantilla y ejemplos prácticos. Esto es lo que hace que escriba a tu manera en lugar de recurrir a sus propios valores predeterminados. | Ambos | Lee |
| skills_search | Encuentra una habilidad predefinida para algo que quieres que haga tu AI OS, para que no tengas que describirla desde cero cada vez. | Ambos | Lee |
| skills_get | Te muestra lo que una habilidad realmente añade, antes de que se acerque a tu carpeta. | Ambos | Lee |
| skills_install | Instala una habilidad en tu AI OS, para que cada agente que lea la carpeta pueda usarla. Se niega a reemplazar una habilidad con el mismo nombre a menos que tú lo indiques. | Tu máquina | Añade |
| docs_search | Responde una pregunta sobre AI OS a partir de las guías publicadas aquí, en lugar de lo que el modelo recuerde a medias. | Ambos | Lee |
| docs_get | Lee una guía completa, para cuando un extracto no es suficiente para actuar. | Ambos | Lee |
| whoami | Indica en qué cuenta estás, qué puedes usar y cuánto de tu asignación diaria queda. Pregunta esto primero cuando una herramienta se niegue a funcionar. | Ambos | Lee |
| upgrade_info | Indica qué incluye cada nivel y qué te añadiría el siguiente nivel superior. | Ambos | Lee |
Dónde se ejecuta una herramienta depende del servidor al que te conectaste, no de la aplicación que uses. El servidor local se ejecuta en tu propia máquina y puede ver tu carpeta, por lo que incluye las 16 herramientas. El servidor alojado se ejecuta en el nuestro y no tiene una copia de tu carpeta, por lo que incluye las 8 que no la necesitan.
Vale la pena ser precisos al respecto, porque es fácil confundirse. Un agente en la nube no está desconectado de tus archivos. Claude Cowork accede a las carpetas que le adjuntas y escribe en ellas con sus propias herramientas, por lo que las 8 alojadas son realmente útiles allí. Lo que un agente en la nube no puede hacer es iniciar un servidor en tu máquina.
Nada marcado como 'tu máquina' tiene costo, y nada de tus archivos se envía a ningún lugar. Esas herramientas funcionan con la sesión cerrada y sin conexión, por eso la auditoría no cuesta nada y nunca lo hará.
AI OS viene en 3 niveles: AI OS Starter, AI OS Pro y AI OS Max. Todas las herramientas aquí listadas están disponibles en AI OS Starter hoy. Lo que un nivel de pago añade es la profundidad de la respuesta en lugar de una lista más larga de herramientas.
MCP o la CLI
Ambos provienen de la misma instalación y ambos leen una lista de herramientas, por lo que ninguno puede tener una herramienta que le falte al otro. Eso se prueba en lugar de ser intencional: la misma auditoría ejecutada a través de ambos devuelve una respuesta idéntica byte por byte. Lo que cambia es cuándo pagas por ello y quién escribe.
Lo que te cuesta cada uno
Las mismas 16 herramientas de cualquier manera. Difieren en cuándo pagas por ellas.
| Servidor MCP | CLI | |
|---|---|---|
| Loaded every turn | 3,315 tokens | 97 tokens |
| Loaded when your AI OS comes up | Nada más | 1,595 más, una vez |
| Tools | 16 | 16 |
| With AIOS_READ_ONLY=1 | 2,364 tokens, 12 herramientas | Los mismos 12 |
| Works on the web and on your phone | Sí, a través del servidor alojado, con 8 herramientas | No. No hay línea de comandos allí |
| Works with no AI open at all | No. MCP es cómo un agente accede a una herramienta | Sí. Esta es la única interfaz que lo hace |
| You start it by | Pidiendo algo con tus propias palabras | Escribiendo un comando |
Un servidor MCP envía toda su lista de herramientas al modelo en cada turno, ya sea que tu AI OS se active o no. Ese es el precio de estar conectado, antes de que pidas nada. La CLI no cuesta nada hasta que se la llama: lo que aparece en la conversación es 1 línea que la describe, y el resto llega solo cuando tu agente la busca.
En más de 20 turnos donde tu AI OS se activa una vez, eso es 66,300 tokens frente a 3,535. Cuando toda la conversación es tu AI OS, la brecha se cierra y el servidor ofrece una mejor experiencia, porque preguntas en lenguaje natural en lugar de recordar comandos.
La mayor parte de los 3,315 no es algo que cualquiera pueda eliminar. Es el protocolo que escribe 16 herramientas como JSON Schema, y cualquier servidor con esta cantidad de herramientas paga aproximadamente lo mismo. Apágalo los días que no lo uses, y cada cliente tiene una forma de hacerlo.
El número se mantiene constante a medida que el catálogo crece, porque una habilidad se obtiene cuando tu agente la pide en lugar de enviarse cuando se conecta. Un servidor con 1 herramienta por habilidad pasaría 50,000 tokens en un año, y no habría vuelta atrás.
Cada número aquí provino de un "handshake" real contra esta compilación, contado con un tokenizador en lugar de estimado a partir de la longitud del texto.
Cómo es usar cada uno
| Lo que estás haciendo | Con MCP | Con la CLI |
|---|---|---|
| Auditing a folder before you trust it | Le pides a tu agente que audite tu AI OS. Te lee el informe y se ofrece a arreglar lo primero que encontró. | Ejecutas aios-cli os-audit y lees el informe tú mismo. Este es el que quieres cuando revisas varias carpetas, o revisas una antes de que un agente la haya visto. |
| Fixing a voice file that is wrong | Tu agente obtiene el "blueprint" de voz, te entrevista y escribe el archivo, todo dentro de la conversación. | Obtienes el "blueprint" y escribes el archivo tú mismo, o le pides a un agente que pueda ejecutar un comando que lo haga por ti. |
| Installing a skill | Dices lo que quieres que haga tu AI OS, y tu agente busca en el catálogo y lo instala. | Ejecutas aios-cli skills-search, luego aios-cli skills-install. |
| Setting up a second AI OS | Abres una conversación en esa carpeta y preguntas. | Ejecutas aios-cli os-init y sigues adelante. Más rápido cuando haces varios. |
| Proving they really are the same thing | La lista de herramientas que recibe tu cliente. | aios-cli schema os-audit imprime el esquema exacto que se envía a un cliente MCP, para que puedas compararlos tú mismo. |
Usa MCP como predeterminado. Es el que te permite pedir algo con tus propias palabras y que se haga, que es el objetivo de tener un AI OS.
Recurre a la CLI cuando no haya conversación. Estás configurando varias carpetas, o quieres revisar una antes de que un agente la vea, o prefieres no llevar la lista de herramientas en cada conversación.
La mayoría de la gente termina usando ambos, y ambos provienen de la misma instalación.
Lo que detecta la auditoría
Empiece por aquí, haga lo que haga. Estos son los problemas que no se pueden ver en un listado de archivos, por eso existe la auditoría.
Una credencial en un archivo de contexto
Pegado una vez y leído por cada agente desde entonces. Se informa redactado, nunca completo.
Marcadores de posición que nadie rellenó
Su agente ha estado leyendo [Your name] como un hecho sobre usted durante meses.
Archivos que existen y no dicen nada
Un archivo de voz vacío es peor que uno que falta, porque parece que ha sido gestionado.
Contexto demasiado largo para sobrevivir
Nombrados con recuentos de palabras, para que sepa qué archivo cortar y aproximadamente cuánto.
Referencias a archivos que ya no existen
Su agente los sigue, no encuentra nada y continúa sin avisarle.
Cualquier cosa obsoleta
Clasificado por su importancia, no solo por su antigüedad.
Lo que hará y lo que no hará
Está apuntando un agente a la carpeta que describe su negocio, así que vale la pena leer esto antes de conectar cualquier cosa.
- Sus archivos de contexto nunca salen de su máquina. La auditoría los lee donde están y no envía ninguno a ningún sitio. Solo viaja el conjunto de reglas, y viaja hacia usted.
- Las escrituras están activadas por defecto. Un servidor cuya cada escritura necesita un indicador le enseña a dejar ese indicador activado permanentemente, lo que parece protección y no lo es.
- Cualquier cosa que pueda reemplazar trabajo que no pueda recuperar es rechazada hasta que la confirme. Eso es
os_updatey unacontext_writesobre un archivo que ya tiene contenido. - Establezca
AIOS_READ_ONLY=1y las 4 herramientas de escritura nunca se ofrecerán. Úselo cuando apunte un agente en el que no confía plenamente a su carpeta. - Establezca
AIOS_AUDIT_LOGa un archivo y cada intento de escritura se registrará, tanto los que fueron rechazados como los que se ejecutaron. - Una credencial encontrada en un archivo de contexto se reporta redactada, nunca completa, para que el hallazgo no se convierta en una segunda copia de la fuga.
Niveles
AI OS está disponible en 3 niveles: AI OS Starter, AI OS Pro y AI OS Max. El nivel pertenece a tu cuenta, no a lo que hayas instalado, por lo que una actualización cambia lo que tu agente puede hacer en su siguiente solicitud, sin necesidad de reconectar nada.
Cada herramienta de esta página está disponible en AI OS Starter. Lo que añade un nivel de pago es profundidad, no una lista más larga: el conjunto completo de reglas de auditoría, planos adaptados al tipo de negocio que realmente tienes y una asignación diaria más alta para las herramientas que llegan a nuestros servidores.
Las asignaciones no se publican aquí todavía, porque la restricción aún no está implementada. Hoy, cada herramienta se envía como AI OS Starter. Esta página incluirá las cifras el día que sean reales, en lugar de una tabla de números que no se aplican.
Límites
Las herramientas locales nunca se miden. Leen y escriben en tu propia carpeta, nunca llegan a nuestros servidores, y un límite en ellas te costaría algo sin ahorrarnos nada.
Las herramientas alojadas cuentan para una asignación diaria en tu cuenta. Cada una tiene un peso, por lo que una herramienta costosa no puede ejecutarse 500 veces dentro de un límite diseñado para herramientas baratas.
Cuando te quedes sin ellas, el rechazo indicará la hora de reinicio en lugar de fallar silenciosamente. Pregúntale a tu agente whoami en cualquier momento y te dirá lo que queda.
Configuración
Ninguna de estas es obligatoria. Existen para cuando necesites algo distinto a la configuración por defecto.
| Configuración | Función |
|---|---|
| AIOS_API_KEY | Una clave para que una máquina pueda iniciar sesión sin navegador. Normalmente, nunca la configuras. aios-cli login se encarga de ello y nunca ves la clave. |
| AIOS_SESSION_PATH | Dónde se guarda el inicio de sesión. Por defecto, es ~/.aios/session.json. |
| AIOS_OS_PATH | Cuál es la carpeta de tu AI OS. Por defecto, es tu ubicación actual, subiendo hasta la carpeta CLAUDE.md, AGENTS.md o context más cercana, de la misma forma que git encuentra su raíz. |
| AIOS_READ_ONLY | Establécelo en 1 y ninguna herramienta de escritura se ofrecerá. 12 herramientas en lugar de 16. |
| AIOS_AUDIT_LOG | Un archivo al que se añade cada intento de escritura, tanto los permitidos como los rechazados. |
| AIOS_API_URL | Apúntala a un lugar diferente de api.aios.guide. Para pruebas. |
| AIOS_REQUEST_TIMEOUT_MS | Cuánto tiempo esperar por una respuesta antes de rendirse. Por defecto, es 30000. |
Qué significan los números
Un comando termina con uno de estos códigos. Tu agente los interpreta para que no tengas que hacerlo.
| Código | Significado | Qué pasó |
|---|---|---|
| 0 | Hecho | Funcionó. |
| 2 | Uso | El comando era incorrecto, faltaba un argumento o se rechazó una escritura porque no la habías confirmado. |
| 3 | No encontrado | La habilidad, el plano o la guía que solicitaste no existe. |
| 4 | Iniciar sesión | No has iniciado sesión o la sesión ya no es válida. |
| 5 | Servidor | Algo salió mal de nuestro lado o en la red. |
| 7 | Límite | Has agotado el límite diario para las herramientas alojadas. El mensaje indica cuándo se restablece. |
| 10 | No configurado | Aún no hay nada configurado. Ejecuta aios-cli login. |
¿Te queda alguna pregunta?
AI OS se conecta a través de MCP, el Protocolo de Contexto del Modelo. MCP es un estándar abierto que permite a un agente de IA acceder a herramientas externas.
Solo tienes que añadir el servidor una vez. Después de eso, tu agente puede auditar tu AI OS, leer y escribir tus archivos de contexto, obtener la guía de escritura para un archivo antes de redactarlo y buscar en el catálogo de habilidades, todo dentro de una misma conversación.
MCP es una forma estandarizada para que un agente de IA utilice herramientas que no están integradas en él. Piensa en ello como un plugin que funciona en todas partes, en lugar de una vez por aplicación.
Configuras AI OS una sola vez. La misma conexión funciona entonces en Claude, ChatGPT, Cursor, Codex y cualquier otro agente en esta página.
La CLI tiene las mismas 16 herramientas que los comandos de shell. Ambas interfaces leen una única lista de herramientas, por lo que ninguna puede tener una herramienta que la otra no tenga.
Te comunicas con ella de cualquier manera. Con MCP, tu agente llama a la herramienta directamente. Con la CLI, escribes `aios-cli os-audit`, o le pides a un agente que pueda ejecutar un shell que lo escriba por ti.
La CLI añade algo que MCP no puede hacer: funciona sin ningún agente, por lo que puedes incluirla en un script, en CI o canalizar su JSON a jq. La mayoría de la gente usa ambas, y ambas provienen de la misma instalación.
Funciona cualquier agente que hable MCP, lo que incluye los 11 de esta página y cualquier otro que acepte una URL de servidor. Lo que cambia es dónde se ejecuta el agente.
- 8 agentes se ejecutan en tu máquina. Claude Code, Cursor, Codex, Gemini CLI, Antigravity, OpenCode, OpenClaw y Hermes obtienen las 16 herramientas, porque pueden leer y escribir en tu carpeta. Los 8 también pueden ejecutar la CLI.
- 3 agentes se ejecutan en la nube. Claude Cowork, ChatGPT y Grok Bot se conectan a través de internet, por lo que priorizan las 8 herramientas que no necesitan un sistema de archivos. Cowork aún puede acceder a tus archivos a través de la aplicación Claude Desktop, y Grok Bot puede ejecutar comandos en tu máquina una vez que lo permitas en su configuración.
Audita tu AI OS y luego te ayuda a corregir lo que encuentra. Todas las demás herramientas existen para apoyar eso.
- La auditoría califica tu carpeta y te indica qué corregir, de lo peor a lo mejor. Cada hallazgo te dice qué hacer a continuación.
- Las herramientas de contexto leen y escriben quién eres, cómo suenas y qué vendes.
- Los planos le dan a tu agente el método y una plantilla para cada archivo, para que escriba a tu manera en lugar de a la suya.
- Las herramientas de habilidades buscan en el catálogo e instalan una habilidad en tu sistema operativo.
- La herramienta de guías responde preguntas basándose en lo publicado aquí, en lugar de en la memoria.
- Las herramientas de cuenta informan tu nivel, tu asignación y lo que añade el siguiente nivel.
La auditoría detecta los problemas que no puedes ver en un listado de archivos. Esa es la razón de su existencia.
- Encuentra credenciales pegadas en un archivo de contexto y leídas por cada agente desde entonces. Las reporta redactadas, nunca completas.
- Encuentra marcadores de posición de plantillas que nadie rellenó. Tu agente los ha estado leyendo como hechos.
- Encuentra archivos que existen y no dicen nada. Un archivo de voz vacío es peor que uno que falta, porque parece que se ha gestionado.
- Encuentra contexto tan largo que el final se pierde de la ventana.
- Encuentra referencias que apuntan a archivos que no existen.
No. Pegas la URL e inicias sesión, o ejecutas `aios-cli login` y terminas en el navegador que se abre. De cualquier manera, nunca verás una clave.
Todas las herramientas locales funcionan sin iniciar sesión, incluida la auditoría. Iniciar sesión añade el catálogo, los planos y las guías.
Grok es el que debes verificar antes de empezar. xAI documenta los conectores MCP personalizados en grok.com/connectors, y dice que completes cualquier inicio de sesión que el servidor solicite allí. La propia documentación de Grok Bot aún no cubre la adición de un servidor MCP personalizado.
El servidor MCP y la CLI de AI OS están bajo la licencia Elastic License 2.0. Puedes leer el código fuente, modificarlo y usarlo en tu propio negocio en tantas máquinas y proyectos como desees.
Hay 2 cosas que no puedes hacer: no puedes ofrecerlo a otras personas como un servicio alojado o gestionado, y no puedes mover, cambiar o eludir las comprobaciones de nivel.
Esto lo convierte en código fuente disponible en lugar de código abierto, lo cual es una diferencia real y vale la pena decirlo claramente. El AI OS Starter Kit es un repositorio separado con su propia licencia.
No. La auditoría lee tus archivos en tu máquina y no envía ninguno de ellos a ningún lugar. Solo se descarga el conjunto de reglas, y tu contenido nunca viaja en la dirección opuesta.
Esta es una propiedad del código, no una promesa en una página. Nada en la parte que lee tus archivos tiene permitido hacer una solicitud de red, y una prueba en el repositorio lo garantiza.
Las 16 herramientas utilizan aproximadamente 3.659 tokens. Esa cifra se mide a partir de una conexión real, no es una estimación, y el README te proporciona el comando para verificarlo tú mismo.
El número se mantiene constante a medida que el catálogo crece. Las habilidades se obtienen cuando tu agente las solicita, en lugar de enviarse en el momento de la conexión. Un servidor con 1 herramienta por habilidad pasaría 50.000 tokens en un año.
Nada para empezar, y no necesitas una cuenta. AI OS Starter incluye todas las herramientas locales sin límite, porque esas herramientas nunca tocan nuestros servidores.
Las herramientas alojadas tienen una asignación diaria. AI OS Pro y AI OS Max aumentan esa asignación, añaden las reglas de auditoría más completas y añaden planos adaptados a tu negocio.
Sí. Úsalo en tu propio negocio como quieras, en tantas máquinas y proyectos como desees. Está publicado en npm y se ejecuta en Docker, por lo que se adapta a cualquier entorno en el que ya trabajes.
Establece `AIOS_READ_ONLY=1` para eliminar todas las escrituras de la lista de herramientas cuando apuntes un agente en el que no confías completamente a tu carpeta. Establece `AIOS_AUDIT_LOG` para registrar cada intento de escritura, tanto los rechazados como los ejecutados.
También hay una API, por lo que un agente nunca es la única forma de acceder.