Hubungkan Oprex ke asisten AI Anda

Apa itu Oprex MCP?

MCP adalah standar terbuka yang membuat model AI bisa memanggil "tools" pada layanan eksternal. Oprex MCP mengekspos data SDLC Anda sebagai tools, sehingga asisten AI dapat menjawab pertanyaan seperti "isu open severity tinggi ada berapa?" atau menjalankan aksi seperti "buatkan requirement baru" — langsung di dalam workspace Oprex Anda, terikat pada tenant dan izin Anda.

Endpoint: POST https://api.oprex.id/mcp — JSON-RPC 2.0 (Streamable HTTP, stateless). Autentikasi: OAuth 2.1 (tanpa API key) atau header Authorization: Bearer oprex_pk_….

Alamat lama https://oprex.id/mcp tetap berfungsi identik — tidak perlu mengubah konfigurasi yang sudah jalan.

Yang bisa dilakukan

• Telusuri projects & groups, resolve path seperti indohrm/enterprise
• Baca & filter issues, requirements, milestones, releases, specs, tickets, tests, pipelines
• Buat & ubah issue (bug) dan requirement
• Lihat coverage matrix (traceability requirement→test)

Aksi tulis butuh API key ber-scope write scope.

Versi & rilis

Autentikasi: OAuth atau API key

Ada dua cara menghubungkan klien, pilih sesuai kebutuhan:

• OAuth 2.1 — untuk aplikasi AI yang dipakai orang (Claude.ai, ChatGPT, Gemini). Tidak perlu menempel key sama sekali: klien mendaftar sendiri lewat Dynamic Client Registration, Anda login via SSO Kinexa, lalu menyetujui di layar persetujuan Oprex. Token akses berlaku 1 jam, refresh 30 hari dengan rotasi.
• API key — untuk CI/CD, skrip, dan klien berbasis file konfigurasi (Claude Code, Cursor, VS Code, Gemini CLI). Milik tenant, berlaku sampai dicabut.

Endpoint OAuth (untuk yang ingin memeriksa sendiri): /.well-known/oauth-authorization-server, /.well-known/oauth-protected-resource, /oauth/register, /oauth/authorize, /oauth/token, /oauth/revoke.

1. Buat API key

Buka member.oprex.id/panel/settings/api-keys → buat key. Pilih scope read (aman, hanya baca) atau write. Salin key oprex_pk_… — hanya ditampilkan sekali.

Claude Code (CLI)

Jalankan perintah ini di terminal:

claude mcp add --transport http oprex https://api.oprex.id/mcp \
  --header "Authorization: Bearer oprex_pk_XXXXXXXX"

Claude Desktop

Settings → Developer → Edit Config, lalu tambahkan (memakai bridge mcp-remote untuk jembatan ke server remote):

{
  "mcpServers": {
    "oprex": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.oprex.id/mcp",
               "--header", "Authorization: Bearer oprex_pk_XXXXXXXX"]
    }
  }
}

Claude.ai (web) — Settings → Connectors

Buka Settings → Connectors → Add custom connector, isi Nama (mis. "Oprex") dan URL server MCP jarak jauh https://api.oprex.id/mcp.

Kosongkan saja OAuth Client ID/Secret — Oprex mendukung Dynamic Client Registration, jadi Claude mendaftar sendiri. Setelah disimpan, Claude akan mengarahkan Anda ke halaman login Kinexa lalu ke layar persetujuan Oprex; klik Izinkan dan connector langsung aktif.

Tidak perlu API key sama sekali untuk jalur ini. Izin yang sudah diberikan bisa dilihat dan dicabut kapan saja di Pengaturan → Aplikasi Terhubung di member.oprex.id.

Cursor

Buat ~/.cursor/mcp.json (global) atau .cursor/mcp.json (per-project):

{
  "mcpServers": {
    "oprex": {
      "url": "https://api.oprex.id/mcp",
      "headers": { "Authorization": "Bearer oprex_pk_XXXXXXXX" }
    }
  }
}

VS Code (GitHub Copilot)

Buat .vscode/mcp.json di workspace Anda:

{
  "servers": {
    "oprex": {
      "type": "http",
      "url": "https://api.oprex.id/mcp",
      "headers": { "Authorization": "Bearer oprex_pk_XXXXXXXX" }
    }
  }
}

Ekstensi Cline / Continue juga mendukung MCP — tambahkan URL & header yang sama di setelan MCP-nya.

Google Gemini CLI

Edit ~/.gemini/settings.json:

{
  "mcpServers": {
    "oprex": {
      "httpUrl": "https://api.oprex.id/mcp",
      "headers": { "Authorization": "Bearer oprex_pk_XXXXXXXX" }
    }
  }
}

ChatGPT

ChatGPT mendukung MCP lewat Developer Mode / Custom Connectors (Plus/Pro/Enterprise). Masukkan URL https://api.oprex.id/mcp.

UI connector ChatGPT mengutamakan OAuth ketimbang header API-key statis — dan itu justru sudah didukung Oprex sekarang: masukkan URL-nya saja, biarkan field OAuth kosong, lalu setujui di layar persetujuan Oprex.

Catatan jujur: kami sudah menguji alur OAuth Oprex end-to-end (registrasi, persetujuan, token, refresh, pencabutan), tapi belum menguji langsung lewat UI ChatGPT. Bila ada kendala, jalur API-key via Agents/Responses API tetap tersedia.

Ollama

Ollama menjalankan model lokal tapi bukan klien MCP sendiri. Pakai aplikasi yang mendukung MCP dengan model Ollama Anda — mis. Cline atau Continue di VS Code (arahkan ke model Ollama), atau LibreChat — lalu tambahkan Oprex sebagai server MCP di aplikasi itu (URL & header sama seperti di atas).

Untuk klien berbasis stdio, gunakan bridge:

npx -y mcp-remote https://api.oprex.id/mcp \
  --header "Authorization: Bearer oprex_pk_XXXXXXXX"

Antigravity

Buka Settings → MCP → Add server, pilih tipe HTTP, isi URL https://api.oprex.id/mcp dan header Authorization: Bearer oprex_pk_…. Jika hanya mendukung stdio, pakai konfigurasi bridge mcp-remote seperti pada Claude Desktop.

Xcode

Xcode belum punya klien MCP bawaan. Cara termudah: jalankan agen coding (mis. Claude Code di Terminal, atau Cursor) di folder project Xcode Anda — agen itu bisa membaca kode Anda sekaligus memakai Oprex MCP untuk mengelola issue/requirement. Ikuti bagian Claude Code atau Cursor di atas.

Klien MCP lain / bridge universal

Klien MCP apa pun yang mendukung Streamable HTTP: pakai URL + header di atas. Untuk klien yang hanya mendukung stdio, jembatani dengan mcp-remote:

npx -y mcp-remote https://api.oprex.id/mcp \
  --header "Authorization: Bearer oprex_pk_XXXXXXXX"

Daftar tools

Keamanan & scope

• Setiap panggilan terikat ke tenant pemilik API key — tak ada akses lintas-tenant.
• Scope: read (hanya baca), write (buat/ubah). Beri key seminimal mungkin.
• Cabut key kapan saja di panel bila bocor.
• Perlakukan key seperti password — jangan commit ke repo publik.
• Untuk OAuth: izin bersifat per-pengguna (anggota tenant lain tidak bisa melihat atau mencabut izin Anda), PKCE S256 wajib, refresh token dirotasi setiap kali dipakai, dan mencabut aplikasi di Pengaturan → Aplikasi Terhubung langsung mematikan seluruh token-nya termasuk refresh token lama.

Masuk direktori connector resmi (Claude/ChatGPT/Gemini)

Ini status jujur, bukan janji — kami belum pernah mengajukan Oprex ke direktori resmi mana pun, jadi ini panduan berdasarkan syarat yang diketahui publik, bukan pengalaman langsung.

1. Kepatuhan protokol — sudah terpenuhi: MCP 2025-06-18, Streamable HTTP, tools/list + tools/call standar.
2. OAuth 2.1 — sudah terpenuhi sejak 3 Agustus 2026. Oprex kini menjadi authorization server-nya sendiri: metadata discovery (RFC 8414 & 9728), Dynamic Client Registration (RFC 7591), authorization code + PKCE S256 wajib, refresh token dengan rotasi, dan revocation (RFC 7009). Login tetap lewat SSO Kinexa yang ada — Oprex hanya menambah lapisan persetujuan di atasnya.
3. Kebijakan & keamanan — penyedia direktori biasanya mensyaratkan kebijakan privasi publik, deskripsi data yang diakses, dan proses review keamanan/pengajuan resmi (form/proses submission ada di dokumentasi developer masing-masing platform — Anthropic, OpenAI, Google — cek langsung di sana untuk syarat & langkah terbaru, karena ini bisa berubah dan kami tidak ingin menebak URL yang mungkin sudah usang).

Ringkasnya: penghalang teknis utama sudah hilang. Yang tersisa adalah kebijakan privasi publik dan mengikuti proses pengajuan masing-masing platform.

FAQ

Apakah gratis? Ya, termasuk dalam langganan Oprex Anda.

Bisa dipakai banyak AI sekaligus? Bisa — endpoint & key yang sama bekerja di semua klien MCP.

Bagaimana dengan OAuth untuk claude.ai / ChatGPT web? Sudah tersedia — cukup masukkan URL server MCP, tanpa API key. Lihat bagian Claude.ai (web) di atas.

Apa bedanya API key dan OAuth? API key cocok untuk CI/CD dan skrip (milik tenant, tidak kedaluwarsa sampai dicabut). OAuth cocok untuk aplikasi AI yang dipakai orang (milik per-user, access token 1 jam, refresh 30 hari dengan rotasi, bisa dicabut di Pengaturan → Aplikasi Terhubung).