Am Ende kann Codex CLI die Frage "Was hat sich seit gestern im Projekt Launch plan geändert?" beantworten, ohne jede Notiz und jeden Channel darin neu zu lesen. Es fragt osFoundry, welche Ressourcen der Owner freigegeben hat (list_granted_resources), findet heraus, was im Projekt liegt (list_project_resources), und fragt dann jede Ressource nur nach den Events nach der letzten Sequenznummer, die es gesehen hat (poll_resource_events). Die Zahlen liegen in einer kleinen Datei in deinem Repo, sodass die nächste Codex-Session dort weitermacht, wo die letzte aufgehört hat. Jeder Call taucht in osFoundry unter Recent activity der Verbindung auf.
Wer macht was
| Codex CLI | osFoundry | |
|---|---|---|
| Login | Hält den OAuth-Token von osFoundry, osfoundry:read reicht |
Der Owner gibt die Verbindung einmal im Tab Connected frei |
| Was es sehen kann | Das, was list_granted_resources zurückgibt, sonst nichts |
Entscheidet der Owner: Projekte, die der Verbindung hinzugefügt wurden, und Message channels, zu denen sie eingeladen wurde |
| Wo der Stand "zuletzt gesehen" liegt | Ein Integer pro Ressource, den Codex verwaltet (hier in .osfoundry/cursors.json) |
Ein geordnetes Event-Log pro Ressource, gelesen ab einer Sequenznummer |
| Was bei einer Änderung passiert | Entscheidet Codex: die eine Notiz neu lesen, den Channel lesen oder nur berichten | Nichts. Polling ändert auf dem Server nie etwas |
| Wer es stoppen kann | Du, indem du nicht fragst | Der Owner entfernt das Projekt, entfernt den Haken bei einem Tool oder widerruft die Verbindung |
Einrichtung
1. Die Codex-Verbindung finden
In osFoundry öffnet das Schlüssel-Icon im Header den Tab Connected. Ist Codex noch nicht verbunden, wähle unter Assistant den Eintrag Other MCP client, gib einen Anzeigenamen wie Codex CLI ein und klicke auf Add assistant. Das Panel zeigt die Serveradresse, die du Codex mitgibst.
Beispiel: der Tab Connected agents mit einer aktiven Codex-CLI-Verbindung
Auf der Codex-Seite:
codex mcp add osfoundry --url https://api.osfoundry.io/api/v1/external-mcp
codex mcp login osfoundry
2. Festlegen, was Codex beobachten darf
Das ist der Teil des Owners, und er beantwortet die Frage "Was wird Codex sehen?" vollständig. Wähle die Verbindung aus und öffne Projects. Such dir unter "Choose a project" ein Projekt aus und klicke auf Add to project. Der Hilfetext sagt, was das freigibt: "Adding this agent to a project gives it access to supported synced content in that project and its discussion channel. Other Message channels require a separate invitation."
Ein Projekt gibt Codex also dessen Notizen, Knowledge Bases, Record Channels, Rooms, GitNest-Repositories und Sessions, dazu den Diskussions-Channel des Projekts. Jeder andere Message channel ist ein zweiter, expliziter Schritt: Weiter unten unter Message channels wählst du ihn in "Choose a Message channel" aus und klickst auf Invite.
Beispiel: die Verbindung Codex CLI mit dem hinzugefügten Projekt Launch plan und einem eingeladenen Message channel
Berechtigungen, die gespeichert wurden, bevor es Projektzugriff gab, stehen unter "Older individual access". list_granted_resources gibt auch diese zurück, als einzeln freigegebene Ressourcen. Schau dir den Bereich also an, bevor du annimmst, dass ein Projekt der einzige Weg hinein ist.
3. Die drei Tools aktiviert lassen
Öffne Tools in derselben Verbindung. "All supported tools are on by default." Lass list granted resources, list project resources und poll resource events angehakt, zusammen mit den Lese-Tools, die Codex braucht, sobald es weiß, dass sich etwas geändert hat (read note tab, read channel messages usw.). Wenn du hier einen Haken entfernst, ist das Tool auf der Seite von osFoundry weg, egal was in der Codex-Konfiguration steht.
4. Codex auf die Watch-Schleife beschränken
# ~/.codex/config.toml
[mcp_servers.osfoundry]
url = "https://api.osfoundry.io/api/v1/external-mcp"
scopes = ["osfoundry:read"]
enabled_tools = [
"list_granted_resources",
"list_project_resources",
"poll_resource_events",
"list_note_tabs",
"read_note_tab",
"read_channel_messages",
]
Alle sechs sind auf dem Server als read-only markiert, deshalb führt Codex sie ohne Rückfrage aus.
5. Codex sagen, wo die Cursor liegen
Codex startet jede Session frisch, also muss die letzte Sequenz pro Ressource irgendwo liegen, wo es sie lesen kann. Eine AGENTS.md im Repo erledigt das:
## osFoundry changes
- Cursors are in .osfoundry/cursors.json: {"<resource_type>:<resource_id>": <last sequence>}.
- Start with list_granted_resources. Drop cursors for resources it no longer returns.
- For each watched resource call poll_resource_events with after_sequence from the file
and limit 100. If a page comes back full, call again from its last sequence.
- Only after reporting the changes, write the new sequence back to the file.
- A resource with no cursor yet: poll from after_sequence 0 once to get its current sequence.
Den Cursor erst nach dem Bericht zurückzuschreiben und nicht vorher bedeutet: Eine Session, die mittendrin abbricht, zeigt beim nächsten Mal dieselben Events noch einmal, statt sie zu verlieren.
Ein echter Durchlauf
Auf dem Rechner, auf dem dieser Text entstanden ist, ist Codex nicht installiert, die Session unten ist also ein simuliertes Beispiel. Tool- und Argumentnamen stammen vom Live-Server, mit dem Präfix mcp__osfoundry__, das Codex ergänzt. Projekt, Ressourcen, Sequenznummern und Ergebnisse sind Demo-Inhalte.
Example (simulated)
> What changed in the Launch plan project since my last check?
• mcp__osfoundry__list_granted_resources {}
← project "Launch plan"; message_channel "launch-updates" (invited)
• mcp__osfoundry__list_project_resources {"project_id": "…", "resource_type": "note"}
← 3 notes: "Launch checklist", "Pricing page copy", "Press list"
• mcp__osfoundry__poll_resource_events {"resource_type": "note", "resource_id": "…",
"after_sequence": 118, "limit": 100} (Launch checklist)
← 2 events, last sequence 120
• mcp__osfoundry__poll_resource_events {… "Pricing page copy", "after_sequence": 64 …}
← no events
• mcp__osfoundry__poll_resource_events {… "Press list", "after_sequence": 9 …}
← no events
• mcp__osfoundry__poll_resource_events {"resource_type": "message_channel",
"resource_id": "…", "after_sequence": 311, "limit": 100}
← 5 events, last sequence 316
• mcp__osfoundry__read_note_tab {"note_id": "…", "tab_id": "…"} (Launch checklist)
• mcp__osfoundry__read_channel_messages {"channel_id": "…", "limit": 5}
(Codex writes 120 and 316 back to .osfoundry/cursors.json)
Two things moved since yesterday. In "Launch checklist", the press embargo
line now says Thursday 09:00 instead of Wednesday. In launch-updates, five
messages: the pricing page is approved, and the App Store build is still in
review. "Pricing page copy" and "Press list" haven't changed.
Vier Polls, zwei Lesezugriffe. Ohne die Cursor hieße dieselbe Antwort: alle drei Notizen und den Channel komplett lesen und mit dem abgleichen, woran sich Codex erinnert, und das ist nichts.
Auf der Seite des Owners ist jeder Call eine Zeile unter Recent activity der Verbindung: Tool-Name, Entscheidung, Uhrzeit.
Beispiel: Tools und Recent activity der Verbindung Codex CLI nach einem Check
Wo die Grenze verläuft
Codex sieht nur, was list_granted_resources auflistet. Die eigene initialize-Antwort des Servers sagt "Use list_granted_resources first", und dieser Call nimmt keine Argumente: Codex kann nicht ein Projekt beim Namen nennen und damit hineinkommen. Ein Message channel, der nicht der Diskussions-Channel des Projekts ist, bleibt unsichtbar, bis der Owner die Verbindung einlädt. Die Beschreibung von list_project_resources wiederholt das: "Ordinary Message channels require a separate invitation."
Polling liest, es abonniert nichts. Der Server bietet nur Tools an, osFoundry weckt Codex also nie auf. Das passt ohnehin zur Arbeitsweise von Codex: Es schaut nach, wenn du es startest, und die Cursor machen "seit dem letzten Mal" billig.
poll_resource_events arbeitet mit einer Ressource pro Call. Einen Cursor für "alles im Projekt" gibt es nicht. So bleibt jedes Log klein und jede Freigabe getrennt. Entfernt der Owner das Projekt, funktionieren die Polls für dessen Ressourcen nicht mehr, und das nächste list_granted_resources listet sie nicht mehr auf. Codex sollte diese Cursor dann verwerfen und es nicht erneut versuchen.
Graph-Sessions sind ein Sonderfall. poll_resource_events akzeptiert graph_session, aber Graphs liegen auf dem Desktop des Owners. Sie erreichen die Verbindung nur, wenn der Owner sie unter "Share desktop Graph sessions" anhakt und die Desktop-App geöffnet und angemeldet ist. Alles andere, was nur auf dem Gerät existiert, bleibt dort. Die initialize-Antwort sagt "Local-only data is unavailable to cloud clients."
Als Nächstes kannst du das in deine Morgenroutine einbauen: codex exec "What changed in the Launch plan project since my last check?" im Repo mit der AGENTS.md, bevor du irgendetwas anderes öffnest. Welche Tools jede Verbindung bekommt und warum der Zugriff trotzdem pro Projekt entschieden wird, steht auf der Seite zum Tool-Scope. Das Protokoll darunter erklärt der Glossareintrag zu MCP.



Top comments (0)