Cara memperbarui dokumentasi dengan Claude Code setelah setiap rilis

Kode dirilis pada hari Selasa. Changelog ditulis pada hari Jumat, jika ada yang ingat, dan artikel bantuan untuk layar yang berubah tetap salah selama sebulan. Anda bisa memperbarui dokumentasi dengan Claude Code sebagai gantinya: ia sudah ada di dalam repo, jadi ia tahu apa yang dirilis.

Panduan ini menghubungkan Claude Code ke situs dokumentasi Clevera melalui server MCP Clevera. Setelah setiap rilis, Claude Code membaca log git, menyusun draf entri changelog, menemukan artikel bantuan yang terdampak rilis, dan mengusulkan suntingan. Seseorang meninjau dan memublikasikannya. Tidak ada yang sampai ke pembaca secara otomatis.

Apa yang Anda butuhkan terlebih dahulu#

Situs dokumentasi Clevera. Situs dokumentasi adalah pusat bantuan yang dihosting oleh Clevera, dengan changelog dan feed RSS bawaan. Setiap paket menyertakan satu situs.

Pro atau lebih tinggi. Agen AI & API tersedia pada paket Pro ke atas. Pro seharga $86,80 per bulan yang ditagihkan tahunan ($124 bulanan) untuk 2 kreator, dengan 4.000 kredit bersama per bulan. Panggilan API sendiri tidak memakan kredit. Lihat harga.

Claude Code di repo tempat Anda merilis. Ia perlu menjalankan git log, dan gh jika Anda ingin ia membaca judul pull request.

Langkah 1: Buat token Penulis (Writer)#

1. Di Clevera, buka menu ruang kerja dan pilih AI agents & API, lalu Tokens dan New token. 2. Beri nama ("Docs writer (Claude Code)") dan pilih preset Writer: "Agen menyusun draf; seseorang meninjau dan memublikasikan." Ini memiliki 4 izin: membaca konten, menulis draf artikel, menulis draf changelog, dan mengunggah gambar. 3. Pada Limits, pilih situs dokumentasi di bawah Doc sites dan masa berlaku. Token selalu kedaluwarsa, setelah 7 hari, 30 hari, 90 hari, atau 1 tahun. 4. Pada Review, klik Create token dan salin. Clevera menampilkannya sekali saja. Masukkan ke dalam variabel lingkungan bernama CLEVERA_TOKEN, jangan pernah di dalam repo.

Mengapa Penulis dan bukan Penerbit? Token Penulis tidak bisa mengubah apa yang dilihat pembaca. Ia tidak bisa memublikasikan, dan tidak bisa menyunting artikel yang sudah tayang. Batasan kedua itulah yang membentuk seluruh alur kerja, jadi ini dibahas di langkah 3.

Langkah 2: Hubungkan Claude Code#

Jalankan ini di terminal Anda:

claude mcp add --transport http clevera https://app.clevera.ai/mcp --header "Authorization: Bearer $CLEVERA_TOKEN"

Itu menambahkan server untuk Anda, di proyek saat ini. Jika seluruh tim harus mendapatkannya, tambahkan ke .mcp.json di root repo sebagai gantinya. Claude Code memperluas ${VAR} di file tersebut, sehingga token itu sendiri tetap berada di luar git:

{ "mcpServers": { "clevera": { "type": "http", "url": "https://app.clevera.ai/mcp", "headers": { "Authorization": "Bearer ${CLEVERA_TOKEN}" } } } }

Setiap rekan tim kemudian mengatur CLEVERA_TOKEN ke token mereka masing-masing. Claude Code akan bertanya sebelum menggunakan server proyek untuk pertama kalinya. Ketik /mcp atau jalankan claude mcp list untuk memeriksa apakah sudah terhubung. Detailnya ada di dokumentasi MCP Claude Code, dan panduan token lengkap ada di panduan kami tentang membuat video dengan Claude melalui MCP.

Langkah 3: Minta dokumentasi rilis#

Tandai rilis, lalu berikan satu perintah kepada Claude Code. Berikut contoh yang bisa Anda adaptasi:

> "Kami menandai v2.4. Baca commit dan judul PR sejak v2.3. Di situs dokumentasi Clevera kami, periksa changelog agar Anda tidak mengulang entri, lalu susun satu entri untuk v2.4 dengan Baru, Ditingkatkan, dan Diperbaiki. Kemudian cari artikel di situs tentang apa pun yang berubah. Perbarui draf secara langsung. Untuk artikel yang sudah tayang, kirimkan masing-masing untuk ditinjau dengan perubahan yang tepat. Jangan publikasikan apa pun."

Inilah yang dilakukannya dengan alat Clevera:

1. Membaca apa yang dirilis. git log v2.3..v2.4 dan, dengan gh, pull request yang digabungkan. Bagian ini adalah Claude Code biasa. 2. Menemukan situs. list_sites mengembalikan id situs dan apakah publikasi otomatis aktif. 3. Memeriksa changelog. list_changelog menampilkan entri terbaru, sehingga tidak mengumumkan perubahan yang sama dua kali. 4. Menyusun draf entri. create_changelog_entry menyimpannya sebagai draf dengan judul, kategori, dan isi Markdown yang menautkan ke artikel. 5. Menemukan artikel yang terdampak. search_content dan get_site_tree menemukan halaman yang menyebutkan fitur yang diubah. get_page membaca masing-masing halaman. 6. Menulis suntingan. Untuk artikel yang belum tayang, update_article menulis teks baru. Ia memerlukan id revisi yang dibacanya, sehingga tidak bisa menimpa suntingan rekan tim yang dibuat di antaranya. Untuk fitur baru tanpa artikel, create_article membuat draf di bagian yang tepat. 7. Meminta peninjauan. Untuk artikel yang sudah tayang, suntingan ditolak tanpa hak publikasi. Jadi agen memanggil submit_for_review dengan catatan yang menjelaskan apa yang harus diubah dan mengapa. Manajer situs mendapatkan pemberitahuan kotak masuk dengan tautan.

Contoh seperti apa draf entri tersebut (ilustrasi, bukan hasil nyata):

> Pencarian faktur lebih cepat dan aplikasi Slack baru · Ditingkatkan, Baru > Pencarian sekarang menemukan faktur berdasarkan pelanggan, jumlah, atau nomor saat Anda mengetik. Hubungkan aplikasi Slack baru untuk memposting faktur yang dibayar ke saluran. Diperbaiki: Ekspor PDF tetap mempertahankan logo Anda di setiap halaman. Tautan ke dua artikel yang diperbarui menyusul.

Setiap perubahan muncul di riwayat halaman dengan nama agen dan token yang digunakannya.

Langkah 4: Tinjau dan publikasikan#

Buka situs dokumentasi di Clevera. Entri changelog ada di bawah Drafts. Perbaiki kata-katanya, atur Version, lalu klik Publish entry. Buka artikel dari pemberitahuan peninjauan, terapkan atau sesuaikan perubahan, dan publikasikan situs. Entri tersebut akan tayang saat publikasi dilakukan.

Dua pengaturan penting di sini:

• Auto-publish. Jika aktif, perubahan pada halaman yang tayang akan terbit beberapa menit setelah penyuntingan berhenti. Matikan jika Anda ingin satu publikasi yang disengaja per rilis.
• Languages. Di situs dengan lebih dari satu bahasa, memublikasikan entri akan menerjemahkannya ke setiap bahasa. Itu menggunakan kredit.

Jika Anda memercayai agen dengan suntingan langsung, token Publisher dapat menyunting artikel yang tayang dan memublikasikannya. Hanya pemilik, admin, dan editor yang dapat memberikan hak publikasi. Alat-alat tersebut tetap menginstruksikan agen untuk memublikasikan hanya saat Anda memintanya secara eksplisit. Sebagian besar tim sebaiknya mulai dengan Penulis dan memutuskan setelah beberapa rilis.

Opsional: video panduan baru untuk alur yang berubah#

Layar yang berubah biasanya berarti video lama juga salah, dan ada rutinitas untuk memperbarui video tutorial setelah perubahan UI. Claude Code dapat membuat video panduan baru dari rekaman yang sudah ada di pustaka Clevera Anda. Ia tidak bisa merekam layar Anda, jadi rekam alur baru terlebih dahulu.

Ini memerlukan token yang mungkin menghabiskan kredit, seperti preset Producer, yang juga mencakup semua yang dimiliki Penulis. Minta penawaran terlebih dahulu. Video panduan dari rekaman berdurasi hingga 5 menit biasanya memakan biaya 5 hingga 25 kredit. Biarkan Approve automatically below di 0, defaultnya, dan pemilik atau admin menyetujui setiap awal berbayar di Agent requests. Video tersebut kemudian dapat dimasukkan ke dalam artikel sebagai blok video.

Kapan Anda tidak membutuhkan ini#

Jika dokumentasi Anda berupa Markdown di repo yang sama dengan kode Anda, Claude Code dapat menyunting file tersebut secara langsung dan Anda meninjau pull request seperti perubahan lainnya. Anda tidak memerlukan server MCP untuk itu. Alur kerja ini ditujukan untuk tim yang pusat bantuannya dan changelog-nya berada di alat yang dihosting yang juga disunting oleh staf dukungan dan produk. Membandingkan opsi hosting? Lihat rangkuman kami tentang server MCP untuk dokumentasi dan generator changelog AI terbaik.

FAQ#

Bisakah Claude Code memublikasikan changelog saya tanpa saya? Tidak dengan token Penulis. Ia hanya bisa menyusun draf. Token Penerbit bisa memublikasikan, dan alat Clevera menginstruksikan agen untuk memublikasikan hanya saat Anda memintanya.

Apa yang terjadi jika rekan tim menyunting artikel pada saat yang sama? Pembaruan agen gagal karena konflik revisi, dan alat tersebut menginstruksikannya untuk membaca ulang artikel dan menerapkan perubahannya ke versi baru. Suntingan rekan tim Anda tidak akan tertimpa.

Apakah ini memakan kredit? Membaca, menyusun draf, memperbarui, dan permintaan tinjauan tidak memakan kredit. Menerjemahkan entri atau artikel serta membuat video akan memakan kredit.

Paket mana yang saya perlukan untuk memperbarui dokumentasi dengan Claude Code? Paket Pro atau yang lebih tinggi untuk agen AI & API. Situs dokumentasi dan log perubahannya tersedia di semua paket.

Apakah ini berfungsi dengan agen lain? Ya. Codex, Cursor, dan skrip terhubung dengan jenis token yang sama, sementara Claude dan ChatGPT terhubung dengan masuk ke akun. Lihat semua integrasi Clevera.

Jadikan bagian dari rilis#

Simpan prompt Anda di repositori, di samping skrip rilis, dan jalankan setiap kali Anda melakukan penandaan (tag). Penggunaan pertama memerlukan beberapa menit untuk pengaturan. Setelah itu, draf log perubahan dan daftar artikel yang kedaluwarsa sudah siap sebelum ada yang sempat bertanya. Lihat apa lagi yang bisa dilakukan agen dengan server MCP Clevera →