Cara Pasang MCP ke ChatGPT: Hubungkan PapanAjar ke AI dalam 5 Langkah

PapanAjar menyediakan MCP server remote yang mengikuti protokol MCP standar (JSON-RPC 2.0 di atas Streamable HTTP). Artinya, kamu bisa menghubungkannya langsung ke ChatGPT sebagai connector, tanpa aplikasi tambahan.

Endpoint : https://www.papanajar.id/mcp
Auth     : OAuth 2.1 (bukan API key statis)
Transport: Streamable HTTP (POST, JSON-RPC 2.0)

Sebelum mulai: siapkan dua hal

1. Akun PapanAjar yang sudah aktif. Login ke dashboard untuk memastikan akunmu berfungsi.
2. Email yang sama antara akun PapanAjar dan akun login OAuth (misalnya WorkOS). PapanAjar mencocokkan identitas lewat profiles.email, jadi email yang berbeda akan ditolak.

5 langkah memasang MCP di ChatGPT

1. Buka ChatGPT lalu masuk ke Settings → Plugins/Connectors.
2. Klik Create / +, lalu pilih Custom.
3. Isi Name dengan nama bebas (misalnya PapanAjar), lalu isi Endpoint URL dengan https://www.papanajar.id/mcp.
4. Pada bagian Authentication, pilih OAuth. ChatGPT akan menjalankan alur OAuth 2.1 (PKCE) dan membuka halaman login penyedia identitas WorkOS pastikan email sama dengan akun di PapanAjar .
5. Setelah tersambung, uji dengan perintah sederhana seperti "Tampilkan materi saya". Jika daftar materi muncul, koneksi berhasil.

Grok.com juga bisa memakai cara yang sama

Karena PapanAjar memakai protokol MCP standar, platform AI apa pun yang mendukung konektor MCP kustom bisa disambungkan dengan cara yang sama—termasuk Grok.com. Endpoint, skema autentikasi OAuth, dan langkah pemasangannya identik dengan ChatGPT:

• Tambahkan custom connector / MCP server baru di pengaturan Grok.
• Gunakan URL endpoint https://www.papanajar.id/mcp.
• Pilih autentikasi OAuth, lalu login dengan email yang sama seperti akun PapanAjar.

Jadi tidak perlu konfigurasi berbeda per platform. Selama platform tersebut mengikuti spesifikasi MCP (Streamable HTTP + OAuth 2.1), kamu cukup menempelkan satu endpoint yang sama.

Klien lain: pakai Personal Access Token

Untuk klien yang mendukung header Authorization: Bearer—seperti Claude Desktop, MCP Inspector, atau script sendiri—kamu bisa memakai Personal Access Token yang dibuat di dashboard PapanAjar (menu Pengaturan). Contoh handshake-nya:

curl -sS -X POST https://www.papanajar.id/mcp \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-06-18",
      "capabilities": {},
      "clientInfo": { "name": "curl", "version": "1" }
    }
  }'

Untuk MCP lokal (stdio) saat pengembangan, jalankan MCP_API_TOKEN=<TOKEN> pnpm mcp:dev.

Hal yang bisa dilakukan setelah tersambung

• Melihat daftar materi, koleksi, link, dan latihan soal.
• Membuat dan mengubah materi Markdown langsung dari chat.
• Membuat bank soal lengkap (wacana + soal + kunci) lewat satu perintah.
• Melihat hasil/nilai siswa (read-only).

Jika gagal tersambung

• 403 email tidak cocok — daftar akun PapanAjar memakai email yang sama dengan akun OAuth-mu.
• 401 di endpoint MCP — pastikan URL benar (/mcp, bukan /api) dan domain memakai HTTPS serta tidak terlindungi login.
• Connector tidak muncul — pastikan fitur connector MCP aktif di paket/akun ChatGPT yang kamu pakai.