MBCL Cohort 2 · Internal Tooling

mcp-mbcl

MCP server untuk Instructor Assistant & Teaching Assistant MBCL — penilaian assignment/final project, QnA history, rekap nilai, cek live prototype, semuanya lewat Claude Code.

01Install

Butuh Node.js 18+, git, dan SSH key kamu sudah terdaftar sebagai collaborator/deploy key di repo MBCL-Cohort-2 (private). Belum punya akses? Lihat bagian eskalasi.

curl -fsSL https://mcp.mbcl.site/install.sh | bash

Script ini akan: clone/pull repo ke ~/MBCL-Cohort-2 (bisa diubah lewat env MBCL_DIR) → npm install di mcp-mbcl/ → daftarkan otomatis ke Claude Code lewat claude mcp add.

Setelah install: restart Claude Code / mulai sesi baru supaya tool mbcl-ta ke-load. Cek dengan claude mcp list — harus muncul mbcl-ta: ... ✔ Connected.

Belum punya akses SSH ke repo?

ssh-keygen -t ed25519 -C "emailmu@example.com"
cat ~/.ssh/id_ed25519.pub

Kirim output id_ed25519.pub ke admin repo untuk di-add sebagai collaborator atau deploy key.

Install manual (tanpa script)

git clone git@github.com:shafry00/MBCL-Cohort-2.git
cd MBCL-Cohort-2/mcp-mbcl
npm install
claude mcp add mbcl-ta -- node "$(pwd)/index.js"

02Semua Tools

10 tools, dipanggil langsung dari percakapan Claude Code setelah mcp-mbcl terpasang.

get_rubric penilaian

Ambil isi panduan penilaian (rubric) untuk assignment atau final project.

Args: type ("assignment" | "fp")

grade_submission penilaian

Gabungkan isi submission peserta + rubric terkait dalam satu paket untuk didraft nilainya oleh Claude.

Args: nama, type ("assignment" | "fp")

guide_scoring penilaian

Sesi scoring terpandu: rubric dipecah per kriteria supaya TA mengisi skor satu-satu, bukan langsung dapat draft nilai sekaligus.

Args: type ("assignment" | "fp")

search_qna qna

Cari pertanyaan/jawaban di history QnA kelas (sheet Day 3/4, QnA Asistensi, dll) berdasarkan kata kunci.

Args: query

search_external qna

Fallback ketika query tidak ada di history QnA — arahkan ke WebSearch, dan untuk pertanyaan di luar jam kelas arahkan ke bot WA Bang Sapri.

Args: query

draft_final_feedback feedback

Kumpulkan submission final project + rubric FP + feedback sebelumnya (jika ada) untuk didraft jadi feedback akhir peserta.

Args: nama

get_course_material materi

Ambil isi materi kelas (Materi Day N, Pre-Study, Glosarium) untuk cross-check jawaban ke peserta.

Args: query

recap_grades rekap

Rekap semua nilai peserta (assignment/fp/semua) dari file feedback + submission yang ada.

Args: type ("assignment" | "fp" | "semua")

recap_notes rekap

Rekap catatan kritik/saran manual TA yang disimpan di folder notes/ — di luar feedback form CSV resmi.

Args: —

check_live_prototype final project

Ekstrak link live prototype dari submission peserta (kalau url tidak diberikan langsung), lalu fetch untuk cek status hidup/mati.

Args: nama (opsional), url (opsional)

03Konfigurasi

Env var	Default	Fungsi
`COURSE_DIR`	folder parent dari `mcp-mbcl/`	Root folder course — tempat file rubric, materi, submissions dibaca
`MBCL_DIR`	`~/MBCL-Cohort-2`	Hanya dipakai oleh `install.sh`, lokasi clone repo

Struktur folder yang diharapkan:

MBCL-Cohort-2/
├── MBCL 2 Panduan Penilaian Assignment.md
├── MBCL 2 Panduan Penilaian Final Project.md
├── submissions/
│   └── [nama-peserta]/assignment.pdf, final-project.pptx
├── mcp-mbcl/
│   ├── index.js
│   └── notes/          ← catatan manual TA (recap_notes)
└── ...materi lain (Glosarium, Pre-Study, dst)

04Troubleshooting

Tool `mbcl-ta` tidak muncul / status "Failed"

Cek registrasi: claude mcp list
Cek server bisa jalan manual: node ~/MBCL-Cohort-2/mcp-mbcl/index.js — kalau error di sini, baca pesan errornya (biasanya module belum ke-install → jalankan ulang npm install di folder mcp-mbcl/)
Restart Claude Code sepenuhnya setelah install/registrasi ulang — tool baru tidak auto-load di sesi yang sedang berjalan

`git clone` gagal: `Permission denied (publickey)`

SSH key kamu belum terdaftar di repo. Lihat bagian install → belum punya akses SSH
Cek koneksi: ssh -T git@github.com — harus muncul "successfully authenticated"

`grade_submission` / `check_live_prototype` bilang "tidak ditemukan"

Pastikan file submission ada di submissions/[nama-peserta]/ dengan nama peserta yang cocok (fuzzy-match, tapi tetap harus mirip)
Nama file harus salah satu dari .pdf, .docx, .doc, .pptx, .ppt

`npm install` gagal

Cek versi Node: node -v — minimal 18
Hapus node_modules dan package-lock.json lalu install ulang kalau masih gagal

Rubric/materi yang dibaca tool ternyata versi lama

Jalankan git -C ~/MBCL-Cohort-2 pull untuk sinkron ke commit terbaru — dokumen course diedit langsung di repo.

05Eskalasi

Kendala teknis (install, error tool, bug mcp-mbcl)

Buka issue di repo: github.com/shafry00/MBCL-Cohort-2/issues

Butuh akses SSH / belum jadi collaborator

Hubungi admin repo (Shafry) langsung untuk di-add-collaborator atau ditambahkan sebagai deploy key

QnA konten kelas / kebingungan materi MBCL 2

Bot WA Bang Sapri: wa.me/628811083771

Data sensitif / nilai peserta ke-expose

Jangan commit hasil penilaian ke repo public. Repo MBCL-Cohort-2 harus tetap private — laporkan ke admin repo kalau ada kebocoran akses.

01Install

Belum punya akses SSH ke repo?

Install manual (tanpa script)

02Semua Tools

get_rubric penilaian

grade_submission penilaian

guide_scoring penilaian

search_qna qna

search_external qna

draft_final_feedback feedback

get_course_material materi

recap_grades rekap

recap_notes rekap

check_live_prototype final project

03Konfigurasi

04Troubleshooting

Tool mbcl-ta tidak muncul / status "Failed"

git clone gagal: Permission denied (publickey)

grade_submission / check_live_prototype bilang "tidak ditemukan"

npm install gagal

Rubric/materi yang dibaca tool ternyata versi lama

05Eskalasi

Tool `mbcl-ta` tidak muncul / status "Failed"

`git clone` gagal: `Permission denied (publickey)`

`grade_submission` / `check_live_prototype` bilang "tidak ditemukan"

`npm install` gagal