Di akhir panduan ini, percakapan Claude melakukan risetnya sendiri, lalu membuka salah satu Note osFoundry kamu, menambahkan tab Slides baru di samping deck yang sudah ada, mengisinya dengan deck singkat, dan memasukkan setiap halaman yang dipakainya ke tab Sources milik Note itu. Deck yang sudah dibuat tim kamu tetap seperti semula. Sumbernya tersimpan di Note, bukan di chat, jadi orang berikutnya yang membuka deck bisa mengecek dari mana setiap angka berasal.
Siapa mengerjakan apa
| Sisi Claude | Sisi osFoundry | |
|---|---|---|
| Riset | Pencarian web dan penalaran Claude sendiri, di chat Claude kamu | Tidak ada apa-apa sampai Claude menulis |
| Note yang mana | Claude memilihnya dari daftar yang diberikan server | Hanya Note di proyek yang sudah ditambahkan ke koneksi |
| Deck yang mana | Claude harus mengirim ID tab yang persis |
list_note_tabs mengembalikan setiap instance tab, jadi dua tab Slides berarti dua ID |
| Deck baru | Claude mengirim kerangka, hingga 20 slide per panggilan |
create_note_tab menambahkan tab Slides dan mengembalikan ID barunya |
| Sumber | Claude mengirim judul dan URL HTTP atau HTTPS |
add_note_source menambahkan satu baris ke tab Sources |
| Persetujuan | Prompt izin tool dari Claude sebelum setiap penulisan | Hak edit kamu saat ini atas Note, dicek di setiap panggilan |
| Catatan | Transkrip chat | Recent activity milik koneksi, satu baris per panggilan tool |
Persiapan
Panduan ini mengasumsikan custom connector Claude sudah ada: ikon kunci → Connected → Add assistant di osFoundry, lalu https://api.osfoundry.io/api/v1/external-mcp ditambahkan sebagai connector di Claude, dan koneksinya ditambahkan ke sebuah proyek.
1. Masukkan Note ke proyek yang terhubung
Buka Note, buka panel kanan, lalu masuk ke Config → Settings. Kalau kolom Project menampilkan "Add to project", pilih proyek tempat koneksi Claude berada. Note yang hanya ada di perangkat ini tidak punya salinan di cloud, jadi koneksi tidak bisa melihatnya.
2. Biarkan tiga tool tulis tetap aktif
Di ikon kunci → Connected, pilih koneksi Claude dan lihat bagian Tools. Untuk panduan ini Claude membutuhkan tool berikut:
read list_note_tabs read_note_tab list_note_attachments
write create_note_tab edit_note_tab add_note_source
Semua tool yang didukung aktif secara default. Kalau kamu menghapus centang tool tulis lalu klik Save tools, Claude tetap bisa membaca Note dan daftar Sources, tetapi tidak bisa menambahkan deck atau sumber.
3. Sebutkan Note, deck, dan tab Sources di prompt
Claude mengubah nama menjadi ID tab sendiri, tetapi menyuruhnya membuat tab baru, bukan "memperbarui deck", membuatnya tidak menyentuh deck yang sudah ada.
Riset bagaimana harga API untuk large language model berubah kuartal ini.
Lalu, di osFoundry, buka Note "Q4 pricing research". Baca dulu tab Research
notes dan Sources yang sudah ada. Tambahkan tab Slides BARU bernama
"API price cuts" dengan sekitar lima slide, akhiri dengan slide Sources, dan
tambahkan setiap halaman yang kamu jadikan acuan ke tab Sources milik Note. Jangan sentuh
deck Pricing dan Launch status.
Contoh nyata
Note, halaman, dan jawaban Claude adalah data contoh. Nama tool dan argumennya adalah yang didaftarkan server live di tools/list. Di Claude Code, tool yang sama muncul sebagai mcp__osfoundry__create_note_tab dan seterusnya.
Example
[Claude runs its own web searches and reads three pages]
Claude → list_note_tabs {"note_id": "…"}
← version "…12:41.118Z"
Research notes (markdown) id "markdown"
Pricing (slides) id "slides-3-mh1q…"
Launch status (slides) id "slides-5-mh4c…"
… plus Files and Sources
Claude → read_note_tab {"note_id": "…", "tab_id": "markdown"}
← the team's notes, 1,240 characters
Claude → list_note_attachments {"note_id": "…", "kind": "sources"}
← 1 source: "Vendor pricing page (Q3 snapshot)"
Claude → create_note_tab {"note_id": "…", "tab_type": "slides",
"label": "API price cuts",
"slides": [{"title": "API prices this quarter", "body": "…"},
{"title": "Who cut, by how much", "body": "…"},
{"title": "Cached input pricing", "body": "…"},
{"title": "What it means for our plan", "body": "…",
"notes": "Pause here for questions"},
{"title": "Open questions", "body": "…"}],
"expected_version": "…12:41.118Z",
"idempotency_key": "deck-api-price-cuts"}
[Claude asks you to allow this tool call → Allow]
← tab ID "slides-9-mh8z…"
Claude → read_note_tab {"note_id": "…", "tab_id": "slides-9-mh8z…"}
← 5 slides, version "…13:02.540Z"
Claude → edit_note_tab {"note_id": "…", "tab_id": "slides-9-mh8z…",
"operation": "slide_add", "title": "Sources",
"body": "Three pages, listed in the Sources tab",
"expected_version": "…13:02.540Z",
"idempotency_key": "deck-api-price-cuts-sources-slide"}
← saved, 6 slides
Claude → list_note_tabs → add_note_source {"title": "…", "url": "https://…",
"description": "Price table, used on slide 2",
"expected_version": "…",
"idempotency_key": "src-…"}
(three times, one page each, a fresh version before each)
← source IDs
Claude → list_note_attachments {"note_id": "…", "kind": "sources"}
← 4 sources
Claude: "API price cuts" adalah tab Slides baru di Q4 pricing research,
enam slide termasuk slide Sources di bagian akhir. Tiga halaman
yang saya pakai ada di tab Sources, masing-masing dengan catatan
slide mana yang didukungnya. Pricing dan Launch status tidak diubah.
Contoh: Deretan tab Note dengan dua deck yang sudah ada dan deck baru API price cuts dalam keadaan terbuka
Di Note itu sudah ada dua deck, dan keduanya bertipe slides. Kalau Claude meminta "tab slides", tidak akan ada jawaban yang benar. list_note_tabs memberikan satu ID per instance, create_note_tab mengembalikan ID tab yang dibuatnya, dan setiap edit berikutnya menyebut ID itu. Karena itulah slide penutup masuk ke deck baru, bukan ke Pricing yang berada paling depan di deretan tab.
Kerangkanya dikirim bersama panggilan create. Satu kali penulisan langsung membuat tab beserta lima slidenya. Slide Sources datang sesudahnya, sebagai edit pada deck yang kini sudah ada. slide_add menambahkan satu slide ke deck yang ditunjuknya, dan skemanya tidak punya kolom posisi, jadi kalau urutan penting, masukkan slidenya ke dalam kerangka.
Contoh: Tab Sources setelah dijalankan, dengan tiga halaman yang ditambahkan Claude di bawah sumber yang sudah ada
Setiap sumber adalah satu baris di tab Sources berisi judul, tautan, nama host, dan deskripsi satu baris dari Claude. Kamu bisa membuka, mengedit, menyegarkan, atau menghapusnya di sana seperti sumber yang ditambahkan orang. Arahkan kursor ke sebuah baris, dan tombol salin memberi tautan langsung ke catatan sumber itu, yang bisa kamu tempel ke teks slide.
Contoh: Recent activity untuk koneksi Claude, satu baris per panggilan tool
Recent activity milik koneksi di ikon kunci → Connected mencantumkan setiap panggilan beserta keputusan dan waktunya, jadi kamu bisa melihat apa yang dilakukan Claude di Note tanpa membaca chat.
Di mana batasnya
Riset tetap di sisi Claude. osFoundry tidak melihat pencarian Claude maupun halaman yang dibacanya. osFoundry hanya menerima apa yang Claude pilih untuk ditulis: slide, serta judul, URL, dan deskripsi untuk setiap sumber. Kalau sebuah klaim di slide tidak punya baris di Sources, hal itu terlihat di Note, dan memang itulah alasan meminta sumbernya ditaruh di sana.
Claude bisa menambahkan deck, bukan mengambil alih deck. create_note_tab hanya membuat tab Slides atau Sheet baru, jadi kerangka tidak bisa menimpa deck buatan orang lain. slide_add dan slides_add_outline bekerja pada satu deck yang ID-nya disebut Claude, dan setiap penulisan membawa versi Note yang terakhir dibaca Claude, jadi kalau seseorang mengubah deck di sela-sela itu, penulisan ditolak sampai Claude membaca ulang.
Sumber masuk, file tetap tertutup. add_note_source hanya menerima tautan HTTP dan HTTPS. list_note_attachments menampilkan Files dan Sources sebagai metadata, paling banyak 50 per halaman, tanpa isi file dan tanpa tautan unduhan. Tautan unduhan yang ditempel di chat bisa diteruskan ke mana saja dan tetap berfungsi setelah kamu mencabut koneksi. Mengedit atau menghapus sumber dan file diserahkan kepada orang di aplikasi desktop, karena edit_note_tab tidak menyentuh keduanya.
Slide dari connector itu sederhana. Setiap slide di kerangka berisi judul, isi, dan catatan pembicara. Tema, gambar, dan tata letak menjadi urusan orang yang membuka deck itu di osFoundry setelahnya.
Mencoba ulang itu aman. Setiap penulisan membawa idempotency_key. Kalau balasan untuk Claude hilang dan Claude memanggil lagi dengan key yang sama, osFoundry mengembalikan hasil pertama, jadi kamu tetap mendapat satu tab "API price cuts" dan satu baris per sumber, bukan dua.
Akses berakhir di panggilan berikutnya begitu kamu mengubahnya. Keluarkan Note dari proyek, hapus proyek dari koneksi, atau klik Revoke connection, dan pembacaan Claude berikutnya akan ditolak.
Selanjutnya
Minta Claude membaca deck Pricing dengan read_note_tab, membandingkannya dengan deck baru API price cuts, lalu menambahkan koreksinya sebagai tab Slides ketiga dengan sumbernya sendiri, supaya deck aslinya tetap utuh untuk ditinjau. Isi tab Sources dan cara orang menambahkannya secara manual ada di halaman tab Sources, dan editor deck-nya sendiri ada di halaman Note Slides.



Top comments (0)