MBCL Cohort 2 · Internal Tooling

mcp-mbcl

MCP server untuk Instructor & Teaching Assistant — penilaian, QnA, rekap nilai, cek prototype. Satu perintah, langsung jalan.

01Sebelum Install — Pastikan Ini Ada

Tool	Cek	Install
Node.js 18+	`node -v`	nodejs.org — pilih LTS
Git	`git --version`	git-scm.com
SSH key	`ssh -T git@github.com` → "successfully authenticated"	Lihat di bawah

Ketiga tools di atas sudah ada? Langsung ke langkah install.

Belum punya SSH key? Jalankan:

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

Kirim output id_ed25519.pub ke admin repo (Shafry) untuk di-add sebagai deploy key. Tunggu sampai ssh -T git@github.com bilang "successfully authenticated" sebelum lanjut install.

02Install — Satu Perintah

macOS / Linux

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

Windows (PowerShell)

irm https://mcp.mbcl.site/install.ps1 | iex

Yang dilakukan script:

Clone / update repo MBCL-Cohort-2 ke ~/MBCL-Cohort-2
Jalankan npm install di folder mcp-mbcl/
Daftarkan MCP server ke Claude Code (via claude mcp add di macOS/Linux, via config file langsung di Windows)

Verifikasi

Restart Claude Code (close terminal, buka baru), lalu jalankan:

claude mcp list

Harus muncul:

mbcl-ta: ... ✔ Connected

Kalau tidak muncul, lihat Troubleshooting.

03Troubleshooting

`claude mcp list` tidak muncul `mbcl-ta`

Cek isi config Claude Code

# macOS/Linux
cat ~/.claude/claude_code_config.json

# Windows PowerShell
Get-Content "$env:USERPROFILE\.claude\claude_code_config.json"

Harus ada "mbcl-ta" di dalam mcpServers. Kalau kosong atau tidak ada, daftar manual — lihat di bawah.

Cek server bisa jalan manual

# macOS/Linux
node ~/MBCL-Cohort-2/mcp-mbcl/index.js

# Windows PowerShell
node "$env:USERPROFILE\MBCL-Cohort-2\mcp-mbcl\index.js"

Kalau error "module not found" → jalankan npm install di folder mcp-mbcl/

Kalau error lain → baca pesan errornya, catat lalu hubungi admin.

Restart Claude Code — tutup terminal sepenuhnya, buka baru. Tool baru tidak auto-load di sesi yang sedang berjalan.

`claude` tidak ditemukan di PATH (Windows)

Claude Code CLI perlu ada di PATH supaya bisa dipanggil dari terminal. Kalau install.ps1 bilang "claude CLI tidak ditemukan":

Install Claude Code: docs.anthropic.com/en/docs/claude-code
Setelah install, tutup terminal lalu buka baru — PATH biasanya auto-update setelah restart
Cek: claude --version

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

SSH key belum terdaftar. Cek: ssh -T git@github.com — harus "successfully authenticated"
Belum punya key? Lihat bagian SSH key
Sudah ada key tapi tetap gagal? Mungkin key belum di-add ke repo. Hubungi admin.

`npm install` gagal

Cek versi: node -v — minimal 18
Hapus node_modules dan package-lock.json, lalu npm install ulang
Windows EPERM/EACCES: jalankan PowerShell sebagai Administrator, atau npm cache clean --force dulu

Daftar manual via config (Windows — jika script tidak auto-daftar)

Bug diketahui: claude mcp add di Windows kadang tidak write ke config file. Install script sudah bypass bug ini — tapi kalau perlu daftar manual:

File: ~/.claude/claude_code_config.json. Isi harus seperti ini:

{
  "mcpServers": {
    "mbcl-ta": {
      "command": "node",
      "args": ["C:\\Users\\USERNAME\\MBCL-Cohort-2\\mcp-mbcl\\index.js"]
    }
  }
}

Ganti USERNAME dengan username Windows kamu. Restart Claude Code setelah edit.

Copy-paste langsung (PowerShell):

$dir = "$env:USERPROFILE\.claude"; if (!(Test-Path $dir)) { New-Item -ItemType Directory -Path $dir }; @{ mcpServers = @{ "mbcl-ta" = @{ command = "node"; args = @("$env:USERPROFILE\MBCL-Cohort-2\mcp-mbcl\index.js") } } } | ConvertTo-Json -Depth 5 | Out-File -Encoding utf8 "$dir\claude_code_config.json"; Get-Content "$dir\claude_code_config.json"

MCP server tidak auto-update (Windows)

MCP server menjalankan git pull otomatis tiap startup. Kalau rubrik/materi versi lama:

Cek repo: git -C "$env:USERPROFILE\MBCL-Cohort-2" status
Pull manual: git -C "$env:USERPROFILE\MBCL-Cohort-2" pull
Kalau ada conflict: git -C "$env:USERPROFILE\MBCL-Cohort-2" pull --ff-only (hanya fast-forward, gak force)

04Tools yang Tersedia

11 tools, dipanggil langsung dari percakapan Claude Code.

get_rubric penilaian

Ambil isi rubrik. Args: type ("assignment" | "fp")

grade_submission penilaian

Gabung submission + rubrik untuk didraft nilainya. Args: nama, type

guide_scoring penilaian

Scoring terpandu per kriteria. Args: type

search_qna qna

Cari QnA history kelas. Args: query

search_external qna

Fallback web search + arahkan ke Bang Sapri. Args: query

draft_final_feedback feedback

Draft feedback akhir peserta. Args: nama

get_course_material materi

Ambil materi kelas. Args: query

recap_grades rekap

Rekap nilai semua peserta. Args: type ("assignment" | "fp" | "semua")

recap_notes rekap

Rekap catatan manual TA dari folder notes/.

check_live_prototype final project

Cek status live prototype. Args: nama (opsional), url (opsional)

get_site_modules materi

Fetch modul tutorial dari mbcl.site. Args: query, category, id (opsional)

05Konfigurasi Lanjutan

Env var	Default	Fungsi
`COURSE_DIR`	folder parent `mcp-mbcl/`	Root folder course — rubric, materi, submissions
`MBCL_DIR`	`~/MBCL-Cohort-2` (macOS/Linux) `%USERPROFILE%\MBCL-Cohort-2` (Windows)	Lokasi clone repo — hanya untuk install.sh/ps1

Struktur folder

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/
└── ...materi lain

06Eskalasi

Bug / error teknis

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

Belum punya akses SSH

Hubungi admin repo (Shafry) untuk di-add sebagai deploy key

QnA materi MBCL

Bot WA Bang Sapri: wa.me/628811083771

Data sensitif ke-expose

Repo harus tetap private. Laporkan ke admin kalau ada kebocoran.