Panduan Instalasi TriPay MCP ke AI Client

Panduan ini menjelaskan cara menghubungkan TriPay Admin MCP Server ke Claude, ChatGPT, Gemini, dan AI client lainnya.

Informasi Server

Tools yang Tersedia

OAuth — Hal Penting

1. Saat pertama kali Connect, browser akan membuka halaman login TriPay (jika belum login).
2. Login dengan akun User (bukan Admin) — token akan terikat ke akun tersebut.
3. Kembali ke AI client, lakukan koneksi ulang.
4. Klik tombol Approve, kamu akan di-redirect ke AI client
5. AI client akan menyimpan token dan siap dipakai.

Redirect URI

1. Claude Web (claude.ai)

Langkah Instalasi

1. Buka claude.ai dan login
2. Klik ikon profil → Settings → Connectors
3. Klik "Add custom connector"
4. Isi Name: TriPay Admin MCP
5. Isi URL Server MCP: https://tripay.co.id/mcp/tripay
6. Klik Advanced Setting
7. Tambahkan OAuth Client ID dan Client Secret (tanya mas-mas programmer)
8. Klik "Add"
9. Klik "Connect" — browser akan buka halaman authorize TriPay
10. Login dengan akun admin, lalu approve di halaman authorize
11. Opsional, selalu izinkan penggunaan tools MCP

Mengaktifkan per Percakapan

1. Buka chat baru
2. Klik "+" di kiri bawah → Connectors
3. Aktifkan toggle TriPay Admin Server

Catatan untuk Team/Enterprise

Owner tambahkan connector dulu di Organization Settings → Connectors, baru anggota bisa mengaktifkan dari Settings mereka.

2. Claude Code (CLI)

Instalasi

claude mcp add --transport http --scope user tripay-admin-mcp https://tripay.co.id/mcp/tripay

OAuth

Saat pertama connect, Claude Code akan buka browser untuk OAuth. Login dan approve di halaman TriPay.

Verifikasi

1. Masuk ke Claude CLI (buka terminal, jalankan claude atau aplikasi Claude Code)
2. Ketik /mcp untuk melihat daftar server MCP
3. Pilih tripay-admin-mcp dari daftar
4. Pilih Authenticate atau Reconnect untuk menyelesaikan OAuth (jika belum terhubung)

3. ChatGPT Web (chatgpt.com)

Prasyarat

• Akun ChatGPT (Pro/Business/Enterprise untuk admin connector)
• Developer Mode aktif
• Redirect URI ChatGPT sudah didaftarkan di OAuth client Passport (URI berbeda-beda)
• Sudah menambahkan Laravel Passport Client di server TriPay

Langkah Instalasi (Admin)

1. Login ke chatgpt.com sebagai Admin
2. Settings → Apps & Connectors → Advanced settings
3. Aktifkan Developer Mode
4. Klik Create → Isi form:
   • Nama: TriPay Admin MCP
   • URL Server MCP: https://tripay.co.id/mcp/tripay
   • Autentikasi: OAuth
5. Di Pengaturan lanjutan (jika ChatGPT tidak auto-detect):
   • URL Autentikasi: https://tripay.co.id/authorize
   • URL Token: https://tripay.co.id/token
   • Metode: Manual — masukkan Client ID & Secret dari Passport
6. Klik Buat → Connect → Login dan approve di TriPay

Mengaktifkan per Percakapan

1. Chat baru → "+" → More
2. Pilih connector TriPay Admin dan aktifkan toggle

4. ChatGPT Codex (CLI)

Instalasi

codex mcp add tripay-admin --url https://tripay.co.id/mcp/tripay

OAuth

codex mcp login tripay-admin-mcp

Browser akan buka halaman authorize TriPay. Login dan approve.

Verifikasi

Jalankan codex → ketik /mcp → pastikan tripay-admin terdaftar dan terhubung.

5. Gemini Web (gemini.google.com)

Saat ini Gemini Web belum mendukung custom MCP connector lewat UI. Gunakan Gemini CLI untuk koneksi MCP.

6. Gemini CLI

Instalasi

gemini mcp add --transport http tripay-admin-mcp https://tripay.co.id/mcp/tripay

Atau edit ~/.gemini/settings.json:

{
  "mcpServers": {
    "tripay-admin": {
      "httpUrl": "https://tripay.co.id/mcp/tripay"
    }
  }
}

OAuth

Saat pertama connect, Gemini CLI akan buka browser untuk OAuth. Login dan approve di halaman TriPay.

Verifikasi

Jalankan gemini → ketik /mcp → pastikan tripay-admin terdaftar dan terhubung.

Troubleshooting

"Integration rejected the credentials"

• Login saat OAuth: Pastikan login dengan akun member milik Admin (Rekber P-Store), bukan ke halaman admin.
• Token: Coba disconnect lalu connect ulang untuk dapat token baru

"Gagal terhubung ke MCP server"

1. Cloudflare Bot Fight Mode: Request dari Claude/ChatGPT bisa diblokir
   • Security → Bots → Matikan Bot Fight Mode atau Super Bot Fight Mode
   • Atau buat Custom Rule Skip untuk path /mcp/, /oauth, /authorize, /token, /register, well-known
   • Buat IP Access Allow untuk setiap IP address AI Client, misal setiap request MCP dari Claude
2. Proxy OAuth: Claude.ai memakai /authorize dan /token di root. Pastikan proxy ke /oauth/authorize dan /oauth/token ada di web.php