AI OS MCP Server

Expone el AI OS de Felix (sincronizado en Notion) como herramientas MCP, de modo que cualquier cliente de IA compatible con MCP pueda consultarlo directamente, en lugar de tener que rastrear un enlace público.

Limitación honesta: esto se escribió sin la posibilidad de ejecutar de verdad npm install ni de compilarlo para probarlo (no hay acceso a la red en el entorno en el que se construyó). El código sigue correctamente las formas actuales del SDK de TypeScript para MCP y de la API de cliente de Notion, hasta donde se sabe, pero ejecuta tú mismo el paso de compilación y verifica que no haya errores antes de confiar en él: no asumas que es impecable solo porque se escribió con cuidado.

Herramientas que expone

• search_vault(query) — búsqueda por palabras clave en todo el AI OS

• get_page(page_name) — contenido completo de una página con nombre

• list_projects() — el contenido actual de la página índice de 10_Projects

• get_project_status(project_name) — el estado actual concreto de un proyecto

Related MCP server: nooon

Configuración

1. Crea una integración en Notion

Ve a notion.so/my-integrations → Nueva integración → ponle un nombre (p. ej., "AI OS MCP") → copia el «secreto de integración interna» (empieza con secret_ o ntn_).

2. Comparte el AI OS con ella

Abre la página raíz AI OS en Notion → menú ... → Conexiones → añade la integración que acabas de crear. Esto es distinto de «Compartir en la web»: es lo que en realidad permite que las llamadas a la API de la integración vean las páginas.

3. Configura la clave de API

cp .env.example .env
# paste your key into .env

4. Compila y ejecuta con Docker

docker compose build
docker compose run --rm ai-os-mcp

Esto ejecuta el servidor a través de stdio: está pensado para que lo lance un cliente MCP (Claude Desktop, etc.), no para que se quede funcionando por separado en una terminal durante un periodo largo.

5. Apunta un cliente MCP hacia él

Para Claude Desktop, añádelo a su configuración de MCP (claude_desktop_config.json):

{
  "mcpServers": {
    "ai-os": {
      "command": "docker",
      "args": ["compose", "-f", "/full/path/to/ai-os-mcp/docker-compose.yml", "run", "--rm", "ai-os-mcp"]
    }
  }
}

Cosas que conviene comprobar antes de confiar en él

• ¿npm install se completa sin problemas o hay desajustes de versión con el SDK?

• ¿npm run build compila sin errores?

• ¿search_vault devuelve resultados de verdad? Eso depende de que la integración se haya compartido con las páginas adecuadas (paso 2).

• El contenido de las tablas en get_page puede representarse de forma tosca: la API de bloques de Notion está anidada y esto extrae las filas de las tablas a un solo nivel de profundidad, sin una verificación a fondo.

Qué no hace

Sin escritura ni edición: es de solo lectura por diseño, así que no puede modificar la bóveda sin querer. No hay un activador automático: sigue siendo necesario que un cliente MCP lo invoque bajo petición, en línea con la decisión de ejecución del AI OS de ser «manual, activado desde el chat».