Untuk penyedia layanan terkelola, dokumentasi bukan sekadar hal yang “nice-to-have” - ini adalah produknya. Dengan Trupeer, Anda bisa menghemat waktu berjam-jam untuk menulis dokumentasi MSP dengan memulai dari template dokumentasi MSP gratis, menyesuaikannya dengan panduan brand Anda, lalu mengubah dokumentasi klien menjadi video walkthrough yang bisa digunakan oleh teknisi mana pun.

Apa itu dokumentasi MSP, dan apa yang membuatnya berbeda?

Dokumentasi MSP adalah semua yang dituliskan oleh penyedia layanan terkelola untuk menjalankan teknologi organisasi lain: register aset, diagram jaringan, kredensial, runbook, jalur eskalasi, keunikan khusus klien, serta laporan dan ulasan yang dilihat klien.

Dua hal membuatnya berbeda secara struktural dari dokumentasi TI internal, dan hampir setiap template mengabaikan keduanya.

Anda mendokumentasikan aset yang tidak Anda miliki. Klien memiliki klaim atas sebagian dari apa yang Anda tulis dan tidak atas sisanya, dan garis itu penting secara komersial, kontraktual, dan pada hari hubungan berakhir.

Dan Anda mendokumentasikan prosedur yang sama di banyak aset sekaligus. Tim internal menulis satu runbook restore backup. MSP menulis satu, lalu harus memastikan kebenarannya tetap berlaku di tiga puluh atau empat puluh lingkungan yang berbeda dengan cara yang tidak sepenuhnya diingat siapa pun.

Masalah kedua adalah yang diam-diam menggerus margin MSP, jadi di sinilah halaman ini dimulai. Untuk versi satu aset, template dokumentasi TI kami mencakup kasus umum.

Mengapa empat puluh salinan satu runbook adalah masalah sebenarnya

Hampir setiap MSP memulai dengan cara yang sama. Bangun kumpulan runbook yang bagus. Onboard satu klien. Salin runbook ke folder atau ruang klien tersebut agar engineer yang menangani tiket memiliki semuanya di satu tempat. Ulangi.

Ini adalah naluri yang masuk akal dan menghasilkan bencana yang lambat. Setelah empat tahun menangani sekitar tiga puluh klien, Anda akan memiliki lebih dari seribu dokumen, sebagian besar berupa duplikat yang hampir sama, dan tidak ada cara untuk mengetahui salinan mana yang masih terbaru.

Kegagalannya bukan karena dokumennya buruk. Setiap salinan benar saat dibuat. Kegagalannya adalah perbaikan pada metode sekarang harus diterapkan tiga puluh kali, dan diterapkan lima atau sepuluh kali sebelum seseorang terseret ke sesuatu yang mendesak.

Yang dilakukan engineer setelah itu adalah bagian yang mahal. Setelah seorang teknisi dua kali “terbakar” oleh runbook yang tidak sesuai dengan lingkungan, mereka berhenti membaca runbook. Mereka bekerja dari prinsip dasar, yang lebih lambat, kurang konsisten, dan sepenuhnya tidak terlihat di pelaporan Anda, karena tiket tetap ditutup.

Jadi struktur dokumentasi MSP harus membuat pembaruan standar bisa dilakukan di satu tempat. Semua yang ada di bawah ini mengikuti itu.

Cara menyesuaikan template ini di Trupeer

Langkah 1: Buka Bagian Templates

Buka bagian Templates dari navigasi utama.

Langkah 2: Pilih dan Buka Template

Klik pada template apa pun yang ingin Anda gunakan untuk membukanya.

Langkah 3: Perluas Tampilan Template

Jika perlu, perluas tampilan template untuk melihat tata letak dan detail secara jelas.

Langkah 4: Edit Template

Klik Edit untuk mulai memodifikasi template yang dipilih.

Di dalam editor, Anda bisa:

• Menambahkan bagian baru

• Menentukan atau memperbarui aturan pemformatan

• Menambahkan logo serta menyesuaikan posisinya dan pengaturan terkait

Langkah 5: Simpan Template yang Anda Sesuaikan

Setelah membuat semua perubahan yang diperlukan, klik Save untuk menyimpan template yang diperbarui sebagai milik Anda.

Langkah 6: Pratinjau dan Penyempurnaan Template

Saat Anda ingin melihat seperti apa tampilan template yang Anda sesuaikan, buka Preview.

Dari layar pratinjau, Anda bisa terus melakukan penyesuaian langsung jika diperlukan, sehingga template tampil persis seperti yang Anda inginkan.

Dengan template dokumentasi MSP, Anda bisa:

• Menghemat waktu untuk menulis: Lewati halaman kosong dengan struktur yang dibuat untuk operasi MSP.

• Kurangi MTTR: Dokumentasi yang jelas membantu dukungan teknis apa pun untuk klien mana pun, dengan cepat.

• Tetap sesuai brand: Terapkan logo, font, dan warna Anda menggunakan brand kit Trupeer.

• Onboard teknisi lebih cepat: Teknisi baru siap lebih cepat dengan dokumentasi yang jelas berbasis video.

• Tetap siap audit: Bagian bawaan mendukung SOC 2, ISO 27001, dan audit klien.

• Jangkau tim global: Terjemahkan dokumen MSP ke 65+ bahasa hanya dengan satu klik.

Dokumentasi MSP yang hebat adalah yang membuat bisnis layanan terkelola bisa diskalakan. Gunakan template ini untuk menangkap setiap klien, setiap sistem, setiap prosedur dengan jelas dan konsisten.

Dokumentasikan standar sekali, catat hanya penyimpangannya

Satu perpustakaan standar. Satu salinan untuk setiap dokumen. Versi yang dikelola, dimiliki, dan satu-satunya tempat metode itu ada.

Lalu, untuk setiap klien, satu dokumen singkat yang mencatat di mana klien tersebut berbeda dari standar, dan tidak yang lain. Bukan salinan runbook dengan edit. Hanya daftar pengecualian.

Register penyimpangan klien adalah kuncinya. Jika klien menggunakan produk backup yang berbeda, itu satu baris. Jika firewall mereka vendor yang berbeda, itu satu baris. Jika direktur keuangan mereka harus menyetujui pekerjaan di luar jam kerja, itu satu baris. Semua yang tidak ada di register adalah standar menurut definisi, yang berarti seorang engineer membaca dua dokumen alih-alih mencari satu folder sambil berharap salinannya masih terbaru.

Register tetap kecil. Dalam praktiknya, klien yang sudah matang berada di kisaran delapan hingga dua puluh baris, dan proses menulis satu register biasanya memunculkan tiga atau empat penyimpangan yang tidak pernah dicatat di mana pun.

Ada manfaat kedua yang baru terlihat kemudian. Daftar singkat semua hal yang tidak standar tentang klien adalah dokumen penjualan dan margin yang sangat baik. Penyimpangan adalah tempat waktu Anda habis.

Register penyimpangan klien, dan apa yang masuk di dalamnya

Satu baris per penyimpangan, lima kolom.

Apa yang berbeda. Dinyatakan terhadap standar, jadi “backup adalah Datto, bukan Veeam standar kami” alih-alih “menggunakan Datto”.

Dokumen standar mana yang terdampak. Referensinya, sehingga engineer yang membaca runbook bisa diarahkan ke sini.

Alasannya. Preferensi klien, diwarisi dari penyedia sebelumnya, kebutuhan kepatuhan, atau kendala teknis. Kolom ini menentukan apakah penyimpangan layak dihapus.

Sejak kapan, dan ditinjau kapan. Tanggal. Penyimpangan yang diwarisi saat onboarding sering bertahan selama bertahun-tahun karena tidak ada yang meninjau ulang.

Upaya atau risiko. Catatan singkat tentang biaya yang ditimbulkannya. Ini yang mengubah register menjadi dokumen komersial sekaligus dokumen teknis.

Tambahkan header yang mencantumkan nama klien, versi perpustakaan standar yang menjadi acuan register ini, dan pemilik akun. Tinjau register setiap kuartal. Penyimpangan tanpa alasan dan tanpa biaya adalah kandidat untuk distandarkan, dan biasanya ini adalah pekerjaan dokumentasi dengan hasil tertinggi yang bisa dilakukan MSP.

Dokumen apa yang sebenarnya dibutuhkan MSP, berdasarkan kategori

Kebanyakan MSP kuat di baris pertama dan kelima serta lemah di baris ketiga, yang persis terbalik, karena baris ketiga adalah yang membuat baris kedua bisa digunakan.

Dua di antaranya memiliki template sendiri yang layak digunakan langsung. Kredensial dan inventaris lisensi memiliki tempat yang natural di application and credentials register kami, dan runbook itu sendiri mengikuti struktur di template IT SOP kami.

Template dokumentasi MSP gratis: perpustakaan standar untuk dibangun

Salin dari sini. Ini adalah perpustakaan standar minimum, dan ukurannya lebih kecil daripada yang biasanya diharapkan oleh kebanyakan MSP.

Onboarding pack. Checklist discovery, audit situs, pengambilan aset, pengambilan kredensial, pengisian awal register penyimpangan, tinjauan bulan pertama. Satu dokumen, dijalankan sekali per klien.

Runbooks, satu untuk setiap tugas berulang. Restore backup, membuat dan menonaktifkan user, restore mailbox, rebuild endpoint, reset password, akses VPN, deployment printer, perpanjangan sertifikat, pengecualian patch. Mulailah dari sepuluh tugas yang menghasilkan paling banyak tiket, bukan mencoba mencakup semuanya.

Eskalasi dan on-call. Cara tiket diekskalasi, siapa yang dihubungi di setiap level, apa yang dianggap darurat, dan aturan otorisasi di luar jam kerja.

Insiden dan perubahan. Format ulasan pascainsiden, serta format metode prosedur untuk perubahan terencana pada infrastruktur klien.

Laporan yang menghadap klien. Laporan bulanan, tinjauan bisnis kuartalan, dan output audit situs. Format tetap, data klien diisi.

Offboarding pack. Apa yang diterima klien, apa yang Anda simpan, dalam format apa, dan sampai kapan. Ditulis sebelum Anda membutuhkannya.

Template register penyimpangan. Lima kolom di atas.

Salin ke sini. Sepuluh hingga lima belas runbook plus enam dokumen tetap adalah perpustakaan yang berfungsi. Naluri untuk menulis empat puluh runbook terlebih dahulu adalah alasan sebagian besar proyek dokumentasi MSP mandek di bulan kedua.

Dokumentasi MSP internal dan eksternal, serta siapa yang memilikinya

Perbedaan yang paling sering dibuat oleh panduan adalah internal versus menghadap klien, yang berguna untuk menentukan gaya bahasa. Perbedaan yang lebih penting adalah kepemilikan, dan ini menjadi nyata saat offboarding.

Secara umum, dan ini bervariasi berdasarkan kontrak dan yurisdiksi, data klien adalah milik klien: register aset yang menjelaskan peralatan mereka, topologi jaringan mereka, kredensial mereka, hak lisensi mereka, konfigurasi mereka. Anda menyimpannya sebagai penyedia layanan, bukan sebagai pemilik.

Metode Anda adalah milik Anda: runbook standar, format laporan, standar build Anda, model penetapan harga Anda, prosedur internal Anda. Klien yang pergi tidak berhak atas perpustakaan runbook Anda.

Register penyimpangan berada di antara keduanya dengan canggung, itulah sebabnya layak disebutkan secara eksplisit dalam kontrak Anda. Register ini mendeskripsikan lingkungan klien, yang mendukung “milik mereka”, tetapi ditulis berdasarkan standar Anda, yang mendukung versi yang disunting.

Tetapkan ini secara tertulis dalam perjanjian layanan, bukan saat titik keluar. Halaman ini bukan nasihat hukum dan posisinya berbeda menurut kontrak dan yurisdiksi, jadi minta pengacara Anda meninjau kepemilikan dokumentasi dan klausul pengembalian. Melakukannya sekali biayanya satu jam. Melakukannya saat offboarding biayanya jauh lebih besar, seperti di bawah ini.

MSP dengan 1.360 dokumen dan sembilan runbook yang sudah usang

Thornbury IT menjalankan layanan terkelola untuk tiga puluh empat klien dengan dua puluh dua staf, sembilan di antaranya engineer. Pada setiap onboarding, mereka menyalin set runbook mereka ke ruang klien baru, yang pada tahun keempat berarti sekitar empat puluh dokumen per klien dan sekitar seribu tiga ratus enam puluh secara total.

Masalah muncul saat sebuah insiden. Seorang engineer mengerjakan backup yang gagal untuk satu klien dengan mengikuti runbook restore klien tersebut, yang merujuk pada konvensi penamaan job Veeam. Klien tersebut sudah pindah ke produk backup yang berbeda empat belas bulan sebelumnya. Runbook standar sudah diperbarui. Salinan di folder klien itu tidak.

Mereka kemudian mengambil sampel dua belas runbook restore dari klien. Sembilan di antaranya berbeda dari standar yang terbaru, dan lima dari sembilan perbedaan itu hanya usang, bukan disengaja.

Biaya yang bisa diukur ada pada waktu penanganan. Rata-rata waktu penanganan tier dua di seluruh bisnis adalah empat puluh tujuh menit. Untuk klien yang runbook-nya sudah usang, waktunya tujuh puluh satu menit, karena engineer pada akun-akun tersebut berhenti mempercayai dokumentasi dan mengerjakannya ulang setiap kali.

Secara terpisah, seorang klien keluar pada tahun ketiga dan meminta dokumentasi mereka. Thornbury mengirim folder klien tersebut, yang berisi runbook standar mereka sendiri bercampur dengan register aset dan kredensial milik klien. Tidak ada yang pernah menarik garis. Perdebatan tentang apa yang berhak diterima klien memakan waktu enam minggu dan melibatkan pengacara dari kedua firma.

Proses rebuild memakan waktu satu orang selama satu bulan. Satu perpustakaan standar, satu salinan, versi yang dikelola. Per klien, hanya register penyimpangan. Panjang median register adalah sebelas baris.

Seribu tiga ratus enam puluh dokumen menjadi empat puluh dokumen standar dan tiga puluh empat register, jadi total tujuh puluh empat. Waktu penanganan tier dua menyatu menjadi empat puluh empat menit di semua akun. Dan offboarding pack didefinisikan dalam kontrak sejak saat itu: klien menerima register aset, kredensial, diagram, dan register penyimpangan mereka, sementara Thornbury menyimpan perpustakaan standar.

Apakah ada template dokumentasi MSP gratis di GitHub?

Ya, dan layak dilihat dengan ekspektasi yang realistis.

Yang akan Anda temukan adalah repositori komunitas berisi kumpulan runbook, pustaka skrip PowerShell dengan dokumentasi tertanam, framework dokumentasi berbasis markdown, dan sesekali struktur dokumentasi lengkap yang dipublikasikan oleh MSP sebagai bagian rekrutmen atau latihan pemasaran. Mencari runbook MSP atau dokumentasi TI bersama markdown atau docs-as-code akan menampilkan sebagian besar hasilnya.

Yang benar-benar berguna di repositori tersebut adalah struktur dan cakupannya: daftar runbook yang dipelihara oleh MSP yang kompeten adalah checklist yang bagus untuk dibandingkan dengan milik Anda. Yang jarang berguna adalah kontennya, karena runbook spesifik untuk tumpukan alat, dan prosedur restore untuk produk backup dan RMM milik orang lain lebih mirip contoh yang dikerjakan daripada template.

Ada dua peringatan. Periksa lisensi sebelum Anda memasukkan apa pun ke dalam perpustakaan dokumentasi komersial, karena lisensi permisif itu umum tetapi tidak universal. Dan jangan pernah mengadaptasi repositori yang berisi pengenal klien yang nyata, detail jaringan, atau apa pun yang menyerupai kredensial, karena itu memang muncul di repositori publik lebih sering daripada seharusnya.

Pendekatan docs-as-code itu sendiri, yaitu markdown dalam version control, adalah opsi yang sah untuk MSP dan menyelesaikan masalah single-copy dengan elegan. Kelemahannya adalah engineer yang bekerja di bawah tekanan waktu tidak akan berkomitmen pada repositori, jadi faktor pembatasnya cenderung adopsi, bukan alatnya.

Perangkat lunak dokumentasi MSP dan masalah vendor lock-in

Platform dokumentasi yang ditujukan untuk MSP bagus dalam hal-hal yang sulit Anda bangun sendiri: hubungan aset yang terstruktur, integrasi dengan RMM dan PSA Anda, penanganan kredensial dengan audit trail, serta pemisahan per klien dengan izin.

Tukarannya adalah dokumentasi Anda akan dibentuk oleh model data mereka, dan mengeluarkannya lagi dalam format yang bisa digunakan sering kali lebih buruk daripada yang disiratkan proses penjualan. Ekspor biasanya berarti sekumpulan catatan, bukan dokumen yang bisa dibaca yang benar-benar digunakan engineer Anda.

Sebelum berkomitmen, ada dua pertanyaan yang layak diajukan. Apakah Anda bisa mengekspor semuanya, termasuk relasi dan lampiran, dalam format yang tetap bisa digunakan jika Anda tidak pernah membeli produk lain. Dan apakah Anda bisa memelihara satu dokumen standar yang berlaku untuk semua klien, atau apakah model tersebut memaksa salinan per klien, yang menghidupkan kembali masalah persis yang dibahas halaman ini.

Pertanyaan kedua itu menyingkirkan lebih banyak produk daripada yang Anda kira. Jika sebuah platform memaksa salinan per klien, simpan perpustakaan standar di luar platform tersebut, dalam sesuatu yang lebih sederhana, dan gunakan platform untuk data aset klien, yang memang itu yang paling bagus. template knowledge base kami mencakup cara menyusun perpustakaan standar tersebut di mana pun ia berada.

Apa yang terjadi pada dokumentasi saat klien pergi?

Offboarding adalah saat kualitas dokumentasi menjadi terlihat, biasanya oleh orang-orang yang sudah tidak puas.

Tetapkan pack dalam kontrak. Posisi yang masuk akal adalah klien menerima register aset mereka, diagram jaringan, inventaris lisensi, kredensial yang ditransfer secara aman, register penyimpangan mereka, serta dokumentasi apa pun yang mereka bayar sebagai deliverable. Anda menyimpan runbook standar, format laporan, dan prosedur internal Anda.

Tetapkan tenggat waktu dan format dalam klausul yang sama, karena “dokumentasi akan disediakan” adalah tempat sengketa dimulai. Tiga puluh hari dan format yang ditentukan adalah hal yang normal.

Lakukan serah terima kredensial melalui proses yang benar, bukan spreadsheet, dan catat apa yang ditransfer dan kapan, karena catatan itu melindungi kedua pihak jika nanti ada akses.

Jika perpindahan terjadi karena transfer ke penyedia lain, bukan in-house, serah terima yang terstruktur jauh lebih murah daripada “dump” dokumen, dan knowledge transfer SOP kami membahas cara menjalankannya.

Bisakah saya mendapatkan template dokumentasi MSP sebagai PDF?

PDF cocok untuk dua dari ini dan tidak cocok untuk sisanya.

Cocok untuk dokumen yang menghadap klien: laporan bulanan, tinjauan kuartalan, output audit situs. Itu adalah snapshot dari suatu momen, dan membekukannya adalah hal yang benar, serta harus membawa branding Anda.

Tidak cocok untuk runbook, register penyimpangan, dan register aset, semuanya berubah dan semuanya perlu bisa dicari. Perpustakaan runbook dalam PDF adalah versi yang lebih lambat dari masalah pada contoh yang dikerjakan di atas, karena PDF tidak bisa memberi tahu pembaca bahwa dokumen tersebut sudah tidak terbaru.

Untuk perpustakaan standar, gunakan apa pun yang benar-benar akan dicari engineer Anda saat tekanan, dan simpan satu salinan. Untuk deliverable klien, buat PDF dari sumber tersebut, bukan memelihara salinan terpisah.

Cara menjaga perpustakaan standar tetap terbaru di setiap klien

Seluruh struktur bergantung pada perpustakaan standar yang benar-benar dipelihara, dan alasan biasanya tidak demikian adalah karena memperbarui runbook berarti seseorang melakukan screenshot, memotong, lalu menulis ulang langkah untuk alat yang sudah mereka tahu cara menggunakannya.

Trupeer AI menghilangkan sebagian besar itu. Seorang engineer menjalankan tugas sekali di kamera dan output-nya adalah runbook yang sudah diformat dengan langkah dan layar yang sudah disiapkan, siap untuk ditinjau daripada ditulis. Refresh sepuluh runbook menjadi satu hari, bukan satu kuartal.

Catat. Beri branding. Terjemahkan. Trupeer-kan.

Untuk materi yang menghadap klien, branding penting secara komersial, dan brand kits berarti laporan dan panduan yang diterima klien terlihat seperti berasal dari Anda, bukan dari template. Documentation dan technical documentation menjaga perpustakaan standar dan catatan aset klien tetap bersama, dan SOP creator mencakup runbook itu sendiri. Instruksi setup ada di document template setup guide.

Pertanyaan yang Sering Diajukan

Apakah ada template dokumentasi MSP gratis dalam PDF?

Struktur di halaman ini gratis untuk disalin, dan pemisahan yang masuk akal adalah menyimpan runbook dan register dalam sesuatu yang bisa dicari, sambil mengekspor laporan yang menghadap klien ke PDF. Tidak ada unduhan berpagar dan tidak ada formulir. Jika Anda ingin PDF dari perpustakaan standar untuk referensi, buat dari salinan live Anda, bukan memeliharanya secara terpisah.

Apa template dokumentasi MSP gratis terbaik?

Kumpulan terbaik adalah yang paling kecil dan akan Anda jaga tetap terbaru: sepuluh hingga lima belas runbook yang mencakup volume tiket tertinggi Anda, satu onboarding pack, satu dokumen eskalasi, format register penyimpangan, serta tiga format laporan yang menghadap klien. Nilai setiap kumpulan template berdasarkan apakah ia memisahkan standar dari pengecualian per klien, karena bagian itulah yang menentukan apakah ia bertahan untuk tiga puluh klien.

Di mana MSP harus menyimpan dokumentasinya?

Data aset klien sebaiknya ada di platform yang terintegrasi dengan RMM dan PSA Anda serta menangani kredensial dengan benar. Perpustakaan standar sebaiknya ada di mana engineer akan mencarinya paling cepat, yang mungkin platform yang sama atau sesuatu yang lebih sederhana. Pertanyaan penentu adalah apakah platform memungkinkan Anda memelihara satu dokumen yang berlaku untuk semua klien.

Berapa banyak dokumentasi yang harus diterima klien baru saat onboarding?

Tidak ada dari perpustakaan standar Anda, dan semua data aset mereka sendiri. Dalam praktiknya, deliverable onboarding yang paling bernilai bagi klien adalah register aset, diagram jaringan, serta ringkasan sederhana tentang apa yang Anda temukan dan apa yang Anda rekomendasikan. Mengirim runbook saat onboarding adalah naluri yang umum, dan itu memberi away metode Anda tanpa imbal hasil komersial.

Apakah klien memiliki dokumentasi yang kami tulis tentang sistem mereka?

Biasanya data mereka ya, metode Anda biasanya tidak, dan batasnya harus ditulis ke dalam perjanjian layanan, bukan diperdebatkan saat keluar. Register aset, diagram, kredensial, dan konfigurasi menggambarkan properti mereka. Runbook standar dan format laporan Anda adalah kekayaan intelektual Anda. Minta klausul tersebut ditinjau oleh pengacara Anda sendiri, karena posisinya bervariasi menurut kontrak dan yurisdiksi.

Bagaimana cara menghentikan engineer melewati dokumentasi?

Buat perpustakaan standar menjadi tepercaya terlebih dahulu. Engineer melewati dokumentasi karena sebelumnya pernah salah, bukan karena mereka tidak suka membaca. Perbaiki masalah single-copy, samakan waktu penanganan, dan perilakunya berubah dengan sendirinya. Mewajibkan pembaruan dokumentasi hanya saat penutupan tiket hanya bekerja sekali jika perpustakaan tersebut memang layak diperbarui.