Di akhir tutorial ini, Codex CLI bisa menjawab "apa yang berubah di project Launch plan sejak kemarin?" tanpa membaca ulang setiap note dan channel di dalamnya. Codex bertanya ke osFoundry resource mana saja yang diberikan owner (list_granted_resources), mencari tahu isi project (list_project_resources), lalu meminta setiap resource hanya event setelah nomor sequence terakhir yang sudah dilihatnya (poll_resource_events). Angka-angka itu disimpan di file kecil di repo Anda, jadi sesi Codex berikutnya melanjutkan dari titik sesi sebelumnya berhenti. Setiap call muncul di Recent activity koneksi tersebut di osFoundry.
Siapa mengerjakan apa
| Codex CLI | osFoundry | |
|---|---|---|
| Login | Menyimpan token OAuth osFoundry, osfoundry:read sudah cukup |
Owner menyetujui koneksi sekali di tab Connected |
| Apa yang bisa dilihat | Apa pun yang dikembalikan list_granted_resources, tidak lebih |
Ditentukan owner: project yang ditambahkan ke koneksi, Message channels tempat koneksi diundang |
| Di mana state "terakhir dilihat" disimpan | Satu integer per resource, dipegang Codex (di sini di .osfoundry/cursors.json) |
Log event berurutan per resource, dibaca mulai dari nomor sequence |
| Apa yang dijalankan saat ada perubahan | Codex yang memutuskan: membaca ulang note itu, membaca channel, atau sekadar melaporkan | Tidak ada. Polling tidak pernah mengubah apa pun di server |
| Siapa yang bisa menghentikannya | Anda, dengan tidak bertanya | Owner menghapus project, menghapus centang tool, atau mencabut koneksi |
Setup
1. Temukan koneksi Codex
Di osFoundry, ikon kunci di header membuka tab Connected. Kalau Codex belum terhubung, pilih Other MCP client di bawah Assistant, beri nama tampilan seperti Codex CLI, lalu klik Add assistant. Panel tersebut menampilkan alamat server yang perlu Anda berikan ke Codex.
Contoh: tab Connected agents dengan koneksi Codex CLI yang aktif
Di sisi Codex:
codex mcp add osfoundry --url https://api.osfoundry.io/api/v1/external-mcp
codex mcp login osfoundry
2. Tentukan apa yang boleh dipantau Codex
Bagian ini milik owner, dan inilah jawaban lengkap untuk "apa yang akan dilihat Codex?". Pilih koneksi lalu buka Projects. Pilih project di "Choose a project" dan klik Add to project. Teks bantuannya menjelaskan apa yang diberikan: "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."
Jadi satu project memberi Codex akses ke note, knowledge base, record channel, Room, repository GitNest, dan session di dalamnya, ditambah channel diskusi project. Message channel lain adalah langkah kedua yang eksplisit: lebih ke bawah, di Message channels, pilih channel-nya di "Choose a Message channel" lalu klik Invite.
Contoh: koneksi Codex CLI dengan project Launch plan yang sudah ditambahkan dan satu Message channel yang diundang
Izin yang disimpan sebelum akses project ada akan muncul di "Older individual access". list_granted_resources juga mengembalikannya, sebagai resource yang diberikan secara individual, jadi cek bagian itu sebelum menganggap project adalah satu-satunya jalan masuk.
3. Biarkan ketiga tool tetap tercentang
Buka Tools di koneksi yang sama. "All supported tools are on by default." Biarkan list granted resources, list project resources, dan poll resource events tetap tercentang, bersama tool pembaca yang dibutuhkan Codex setelah tahu ada yang berubah (read note tab, read channel messages, dan seterusnya). Menghapus centang sebuah tool di sini akan menghilangkannya di sisi osFoundry, apa pun isi konfigurasi Codex.
4. Batasi Codex ke loop pemantauan
# ~/.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",
]
Keenamnya ditandai read-only di server, jadi Codex menjalankannya tanpa bertanya.
5. Beri tahu Codex di mana menyimpan cursor
Codex memulai setiap sesi dari nol, jadi sequence terakhir per resource harus disimpan di tempat yang bisa dibacanya. AGENTS.md di repo sudah cukup:
## 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.
Menulis cursor setelah laporan, bukan sebelumnya, berarti sesi yang mati di tengah jalan akan menampilkan event yang sama lagi di kesempatan berikutnya, bukan kehilangannya.
Contoh run sungguhan
Codex tidak terpasang di mesin tempat tulisan ini dibuat, jadi sesi di bawah adalah contoh simulasi. Nama tool dan nama argumennya berasal dari server live, dengan prefiks mcp__osfoundry__ yang ditambahkan Codex. Project, resource, nomor sequence, dan hasilnya adalah konten demo.
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.
Empat poll, dua kali baca. Tanpa cursor, jawaban yang sama berarti membaca ketiga note dan channel secara penuh lalu membandingkannya dengan apa pun yang diingat Codex, yang isinya kosong.
Di sisi owner, setiap call menjadi satu baris di Recent activity koneksi: nama tool, keputusan, dan waktunya.
Contoh: Tools dan Recent activity koneksi Codex CLI setelah satu pengecekan
Di mana batasnya
Codex hanya melihat apa yang di-list oleh list_granted_resources. Balasan initialize dari server sendiri menyebut "Use list_granted_resources first", dan call itu tidak menerima argumen: Codex tidak bisa menyebut nama project lalu masuk. Message channel yang bukan channel diskusi project tetap tidak terlihat sampai owner mengundang koneksi ke sana. Deskripsi list_project_resources mengulanginya: "Ordinary Message channels require a separate invitation."
Polling itu membaca, bukan berlangganan. Server hanya mengiklankan tools, jadi osFoundry tidak pernah membangunkan Codex. Itu memang cocok dengan cara kerja Codex: ia melihat saat Anda menjalankannya, dan cursor membuat "sejak terakhir kali" jadi murah.
poll_resource_events bekerja pada satu resource per call. Tidak ada cursor untuk "seluruh project". Dengan begitu setiap log tetap kecil dan setiap grant tetap terpisah. Saat owner menghapus project, poll untuk resource-nya berhenti berfungsi, dan list_granted_resources berikutnya tidak lagi mencantumkannya. Codex sebaiknya membuang cursor tersebut, bukan mencobanya lagi.
Session Graph adalah kasus khusus. poll_resource_events menerima graph_session, tetapi Graph tinggal di desktop owner. Graph hanya sampai ke koneksi kalau owner mencentangnya di "Share desktop Graph sessions" dan aplikasi desktop sedang terbuka dan login. Hal lain yang hanya ada di perangkat tetap di sana. Balasan initialize menyebut "Local-only data is unavailable to cloud clients."
Selanjutnya, masukkan ke rutinitas pagi Anda: jalankan codex exec "What changed in the Launch plan project since my last check?" dari repo yang berisi AGENTS.md, sebelum membuka apa pun. Tools apa yang didapat setiap koneksi, dan kenapa akses tetap ditentukan per project, ada di halaman tool scope. Protokol di baliknya dijelaskan di entri glosarium MCP.



Top comments (0)