AI OS MCP Server

Stellt Felix’ AI OS (in Notion synchronisiert) als MCP-Tools bereit, sodass jeder MCP-kompatible KI-Client es direkt abfragen kann, anstatt einen öffentlichen Link zu scrapen.

Ehrliche Einschränkung: Das wurde geschrieben, ohne es tatsächlich npm install oder einen Kompiliertest durchführen zu können (kein Netzwerkzugriff in der Umgebung, in der es gebaut wurde). Der Code folgt nach aktuellem Wissensstand den korrekten Formen des MCP TypeScript SDK und der Notion client API — aber führe den Build-Schritt selbst aus und prüfe auf Fehler, bevor du ihm vertraust — geh nicht davon aus, dass er fehlerfrei ist, nur weil er sorgfältig geschrieben wurde.

Bereitgestellte Tools

• search_vault(query) — Stichwortsuche über das gesamte AI OS

• get_page(page_name) — vollständiger Inhalt einer benannten Seite

• list_projects() — der aktuelle Inhalt der 10_Projects-Indexseite

• get_project_status(project_name) — der aktuelle Status genau eines Projekts

Related MCP server: nooon

Einrichtung

1. Eine Notion-Integration erstellen

Gehe zu notion.so/my-integrations → Neue Integration → benenne sie (z. B. „AI OS MCP“) → kopiere das „Internal Integration Secret“ (beginnt mit secret_ oder ntn_).

2. Das AI OS für sie freigeben

Öffne die AI OS-Ausgangsseite in Notion → Menü ... → Verbindungen → füge die eben erstellte Integration hinzu. Das ist getrennt von „Share to web“ — genau das sorgt dafür, dass die API-Aufrufe der Integration die Seiten überhaupt sehen können.

3. Den API-Schlüssel festlegen

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

4. Mit Docker bauen und ausführen

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

Der Server läuft über stdio — er ist dafür gedacht, von einem MCP-Client (z. B. Claude Desktop) gestartet zu werden, nicht dauerhaft eigenständig in einem Terminal zu laufen.

5. Einen MCP-Client darauf zeigen lassen

Füge für Claude Desktop die in die MCP-Konfiguration hinzu (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"]
    }
  }
}

Dinge, die man prüfen sollte, bevor man dem Ganzen vertraut

• Läuft npm install sauber durch, oder gibt es Versionskonflikte mit dem SDK?

• Kompiliert npm run build getragen ohne Fehlermeldungen?

• Liefert search_vault tatsächlich Ergebnisse — das hängt davon ab, ob die Integration für die richtigen Seiten freigegeben wurde (Schritt 2).

• Der Tabelleninhalt in get_page wird möglicherweise ungenau gerendert — die Notion Block-API ist verschachtelt, und das hier zieht Tabellenzeilen nur eine Ebene tief; das ist nicht umfassend verifiziert.

Was das nicht tut

Keine Schreib- oder Bearbeitungsfunktionen — bewusst nur lesend, damit der Tresor nicht versehentlich verändert werden kann. Kein Automatisierungstrigger — es muss weiter auf Anfrage von einem MCP-Client aufgerufen werden, passend zur Entscheidung des AI OS für die „manuelle, Chat-ausgelöste“ Ausführung.