À la fin, Codex CLI saura répondre à « qu'est-ce qui a changé dans le projet Launch plan depuis hier ? » sans relire chaque note et chaque canal du projet. Il demande à osFoundry quelles ressources le propriétaire a accordées (list_granted_resources), découvre ce que contient le projet (list_project_resources), puis demande à chaque ressource uniquement les événements postérieurs au dernier numéro de séquence qu'il a vu (poll_resource_events). Ces numéros vivent dans un petit fichier de votre repo, si bien que la session Codex suivante reprend là où la précédente s'est arrêtée. Chaque appel apparaît dans Recent activity de la connexion sur osFoundry.
Qui fait quoi
| Codex CLI | osFoundry | |
|---|---|---|
| Connexion | Détient le token OAuth d'osFoundry, osfoundry:read suffit |
Le propriétaire approuve la connexion une fois dans l'onglet Connected |
| Ce qu'il peut voir | Ce que renvoie list_granted_resources, rien d'autre |
Décidé par le propriétaire : les projets ajoutés à la connexion, les Message channels où elle a été invitée |
| Où vit l'état « vu en dernier » | Un entier par ressource, tenu par Codex (ici dans .osfoundry/cursors.json) |
Un log d'événements ordonné par ressource, lu à partir d'un numéro de séquence |
| Ce qui s'exécute lors d'un changement | Codex décide : relire cette note, lire le canal ou simplement le signaler | Rien. Le polling ne modifie jamais rien sur le serveur |
| Qui peut l'arrêter | Vous, en ne demandant plus | Le propriétaire retire le projet, décoche un outil ou révoque la connexion |
Configuration
1. Trouver la connexion Codex
Dans osFoundry, l'icône de clé dans l'en-tête ouvre l'onglet Connected. Si Codex n'est pas encore connecté, choisissez Other MCP client sous Assistant, donnez-lui un nom d'affichage comme Codex CLI et cliquez sur Add assistant. Le panneau affiche l'adresse du serveur à donner à Codex.
Exemple : l'onglet Connected agents avec une connexion Codex CLI active
Côté Codex :
codex mcp add osfoundry --url https://api.osfoundry.io/api/v1/external-mcp
codex mcp login osfoundry
2. Décider ce que Codex a le droit de surveiller
Cette partie revient au propriétaire, et elle répond entièrement à la question « qu'est-ce que Codex va voir ? ». Sélectionnez la connexion et ouvrez Projects. Choisissez un projet dans "Choose a project" et cliquez sur Add to project. La ligne d'aide précise ce que cela accorde : "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."
Un projet donne donc à Codex ses notes, knowledge bases, record channels, Rooms, dépôts GitNest et sessions, plus le canal de discussion du projet. Tout autre Message channel est une seconde étape explicite : plus bas, sous Message channels, choisissez-le dans "Choose a Message channel" et cliquez sur Invite.
Exemple : la connexion Codex CLI avec le projet Launch plan ajouté et un Message channel invité
Les autorisations enregistrées avant l'arrivée de l'accès par projet apparaissent sous "Older individual access". list_granted_resources les renvoie aussi, comme ressources accordées individuellement, alors vérifiez cette section avant de supposer qu'un projet est le seul point d'entrée.
3. Laisser les trois outils cochés
Ouvrez Tools sur la même connexion. "All supported tools are on by default." Laissez cochés list granted resources, list project resources et poll resource events, ainsi que les outils de lecture dont Codex a besoin une fois qu'il sait que quelque chose a changé (read note tab, read channel messages, etc.). Décocher un outil ici le retire côté osFoundry, quoi que dise la configuration de Codex.
4. Restreindre Codex à la boucle de surveillance
# ~/.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",
]
Les six sont marqués en lecture seule sur le serveur, donc Codex les exécute sans demander.
5. Indiquer à Codex où garder les curseurs
Codex démarre chaque session à zéro, donc la dernière séquence de chaque ressource doit vivre quelque part où il peut la lire. Un AGENTS.md dans le repo s'en charge :
## 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.
Réécrire le curseur après le compte rendu, et pas avant, signifie qu'une session qui meurt en cours de route affichera les mêmes événements la fois suivante au lieu de les perdre.
Une vraie exécution
Codex n'est pas installé sur la machine où ce texte a été écrit, donc la session ci-dessous est un exemple simulé. Les noms d'outils et d'arguments sont ceux du serveur en production, avec le préfixe mcp__osfoundry__ qu'ajoute Codex. Le projet, les ressources, les numéros de séquence et les résultats sont du contenu de démonstration.
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.
Quatre polls, deux lectures. Sans les curseurs, la même réponse oblige à lire en entier les trois notes et le canal, puis à les comparer avec ce dont Codex se souvient, c'est-à-dire rien.
Côté propriétaire, chaque appel est une ligne dans Recent activity de la connexion : le nom de l'outil, la décision, l'heure.
Exemple : Tools et Recent activity de la connexion Codex CLI après une vérification
Où passe la limite
Codex ne voit que ce que liste list_granted_resources. La réponse initialize du serveur dit elle-même "Use list_granted_resources first", et cet appel ne prend aucun argument : Codex ne peut pas demander un projet par son nom pour y entrer. Un Message channel qui n'est pas le canal de discussion du projet reste invisible tant que le propriétaire n'y a pas invité la connexion. La description de list_project_resources le répète : "Ordinary Message channels require a separate invitation."
Le polling lit, il ne s'abonne pas. Le serveur n'annonce que des outils, donc osFoundry ne réveille jamais Codex. Ça tombe bien, c'est de toute façon comme ça que Codex fonctionne : il regarde quand vous le lancez, et les curseurs rendent « depuis la dernière fois » peu coûteux.
poll_resource_events travaille sur une ressource par appel. Il n'existe pas de curseur « tout le projet ». Chaque log reste ainsi petit et chaque accès bien séparé. Quand le propriétaire retire le projet, les polls sur ses ressources cessent de fonctionner, et le list_granted_resources suivant ne les liste plus. Codex doit alors supprimer ces curseurs, pas réessayer.
Les sessions Graph sont un cas à part. poll_resource_events accepte graph_session, mais les Graphs vivent sur le bureau du propriétaire. Ils n'arrivent jusqu'à la connexion que si le propriétaire les coche sous "Share desktop Graph sessions" et que l'app desktop est ouverte et connectée. Tout le reste de ce qui n'existe que sur l'appareil y reste. La réponse initialize dit "Local-only data is unavailable to cloud clients."
Prochaine étape : intégrez-le à votre routine du matin avec codex exec "What changed in the Launch plan project since my last check?", lancé depuis le repo qui contient le AGENTS.md, avant d'ouvrir quoi que ce soit d'autre. Les outils attribués à chaque connexion, et pourquoi l'accès reste décidé par projet, sont décrits sur la page tool scope. Le protocole sous-jacent est expliqué dans l'entrée MCP du glossaire.



Top comments (0)