MMyPlanDokumentasi
MCP

Hubungkan Claude

Tambahkan MyPlan sebagai custom connector di claude.ai dan aplikasi Claude, lalu izinkan aksesnya lewat OAuth.

Di claude.ai (dan aplikasi desktop atau seluler Claude yang memakai akun yang sama), MyPlan ditambahkan sebagai custom connector. Anda tidak perlu membuat atau menyalin token: Claude meminta izin lewat halaman persetujuan MyPlan.

Menambahkan connector

Buka pengaturan connector di Claude

Di claude.ai, buka Settings → Connectors, lalu pilih Add custom connector. Label menu bisa sedikit berbeda antar versi Claude. Di organisasi Claude Team atau Enterprise, connector kustom biasanya ditambahkan oleh pemilik organisasi lebih dulu.

Isi alamat server

Beri nama, misalnya MyPlan, dan isi URL:

https://mcp.myplan.my.id/mcp

Biarkan pengaturan OAuth lanjutan (client ID dan secret) kosong. MyPlan mendaftarkan Claude secara otomatis.

Hubungkan dan masuk

Pilih Connect. Claude membuka halaman persetujuan MyPlan di myplan.my.id/oauth/authorize. Jika belum masuk, pilih Masuk dan masuk dengan akun MyPlan Anda.

Pilih akses dan izinkan

Halaman persetujuan menampilkan nama aplikasi dan Terverifikasi: claude.ai (atau claude.com). Pilih Akses:

  • Baca dan tulis: Claude bisa membaca dan mengubah data.
  • Hanya baca: Claude hanya bisa membaca.

Pilih Izinkan. Anda kembali ke Claude dan connector siap dipakai. Pilih Tolak jika batal.

Koneksi ini menjangkau semua workspace yang Anda ikuti. Jika Anda punya lebih dari satu workspace, sebut namanya di permintaan, misalnya "di workspace Acme, ...". Claude juga bisa memanggil list_workspaces untuk melihat pilihannya.

Memakai connector di percakapan

Aktifkan connector MyPlan di menu alat percakapan (ikon pengaturan alat di kolom pesan), lalu minta seperti biasa:

Tampilkan work item saya yang jatuh tempo minggu ini di workspace Acme.

Untuk tool yang mengubah data, Claude biasanya meminta konfirmasi sebelum menjalankannya. Lihat Contoh prompt untuk ide lain.

Memperbarui daftar tool

Server MyPlan menambah tool dari waktu ke waktu. Jika tool baru belum terlihat, putuskan lalu hubungkan ulang connector di Settings → Connectors, atau mulai percakapan baru.

Memutus koneksi

Ada dua cara:

  • Di Claude: hapus atau putuskan connector di Settings → Connectors.
  • Di MyPlan: buka Pengaturan akun → Token API. Koneksi Claude tampil dengan label Aplikasi. Pilih Putuskan. Claude langsung kehilangan akses.

Cara kerjanya

  1. Claude menemukan server otorisasi dari https://mcp.myplan.my.id/.well-known/oauth-protected-resource dan mendaftarkan dirinya secara otomatis (dynamic client registration).
  2. Claude membuka https://mcp.myplan.my.id/authorize, yang meneruskan Anda ke halaman persetujuan https://myplan.my.id/oauth/authorize.
  3. Setelah Anda memilih Izinkan, MyPlan mengirim kode sekali pakai (berlaku 5 menit) kembali ke Claude.
  4. Claude menukar kode itu, bersama bukti PKCE (S256), dengan token akun mpa_ yang diberi nama sesuai aplikasi.
  5. Setiap pemanggilan tool membawa token itu. Jika token dicabut, server membalas 401 dan Claude meminta Anda menghubungkan ulang.

MyPlan hanya mengirim kode ke alamat yang dipercaya (claude.ai, claude.com, dan subdomainnya) atau ke aplikasi di komputer Anda sendiri (localhost). Permintaan dari alamat lain dihentikan dengan pesan Aplikasi tidak diizinkan dan tidak ada data yang dibagikan.

Masalah umum

GejalaPenyebab dan solusi
Aplikasi tidak diizinkanKlien mengirim alamat kembali yang tidak dipercaya MyPlan. Pakai token bearer, lihat Klien lain.
Permintaan tidak validKlien tidak mengirim permintaan masuk yang lengkap. Mulai hubungkan lagi dari Claude.
Claude bilang tidak boleh mengubah dataKoneksi dibuat dengan Hanya baca, atau peran Anda di proyek itu tidak mengizinkan. Hubungkan ulang dengan Baca dan tulis jika perlu.
Workspace tidak munculWorkspace mewajibkan autentikasi dua langkah dan akun Anda belum mengaktifkannya.

Di halaman ini