OPREX MCP · v1.1.0

Hubungkan Oprex ke asisten AI Anda

Server Model Context Protocol (MCP) untuk Oprex ALM/SDLC. Beri Claude, ChatGPT, Gemini, atau IDE Anda akses langsung ke projects, issues, requirements, milestones, releases, tests, dan pipelines — untuk membaca maupun mengelola, cukup dengan satu API key.

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://oprex.id/mcp — JSON-RPC 2.0 (Streamable HTTP, stateless). Autentikasi: header Authorization: Bearer oprex_pk_….

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

v1.1.0 · saat ini

+6 tools: get_project, list_tickets, list_test_cases, list_pipelines, list_release_plans, coverage_matrix
Halaman dokumentasi multi-klien (dual EN/ID)

v1.0.0

Rilis awal: 12 tools (projects, groups, resolve, issues CRUD, requirements, milestones, releases, specs)
Streamable HTTP + auth API key

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://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://oprex.id/mcp",
               "--header", "Authorization: Bearer oprex_pk_XXXXXXXX"]
    }
  }
}

Cursor

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

{
  "mcpServers": {
    "oprex": {
      "url": "https://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://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://oprex.id/mcp",
      "headers": { "Authorization": "Bearer oprex_pk_XXXXXXXX" }
    }
  }
}

ChatGPT

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

Catatan jujur: UI connector ChatGPT saat ini mengutamakan OAuth / tanpa-auth dan belum menyediakan field header API-key statis. Untuk sekarang, gunakan Oprex MCP dari ChatGPT via Agents/Responses API (di mana header bisa diset), atau tunggu dukungan OAuth Oprex (dalam roadmap). Untuk pemakaian tanpa kode, Claude Code/Desktop, Cursor, atau Gemini CLI adalah jalur termudah.

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://oprex.id/mcp \
  --header "Authorization: Bearer oprex_pk_XXXXXXXX"

Antigravity

Buka Settings → MCP → Add server, pilih tipe HTTP, isi URL https://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://oprex.id/mcp \
  --header "Authorization: Bearer oprex_pk_XXXXXXXX"

Daftar tools

Tool	Scope	Deskripsi
`oprex_list_projects`	read	List all projects in your Oprex tenant (GitLab-style). Returns id, name, slug, groupId, visibility.
`oprex_list_groups`	read	List all groups (namespaces) in your Oprex tenant. Returns id, name, path.
`oprex_resolve_project`	read	Resolve a GitLab-style path <group>/<project> to its group + project records. Use to turn a human path like 'indohrm/enterprise' into ids.
`oprex_list_issues`	read	List issues (bugs) — optionally scoped to a project and filtered by status/severity/text.
`oprex_get_issue`	read	Get a single issue (bug) by id, with full detail.
`oprex_create_issue`	write	Create a new issue (bug). Requires a write-scoped API key.
`oprex_update_issue`	write	Update an issue (bug): status, severity, title, or description. Requires a write-scoped API key.
`oprex_list_requirements`	read	List requirements — optionally scoped to a project and filtered by status/type/text.
`oprex_create_requirement`	write	Create a new requirement. Requires a write-scoped API key.
`oprex_list_milestones`	read	List milestones — optionally scoped to a project and filtered by status.
`oprex_list_releases`	read	List releases (Staging → RC → Stable) — optionally scoped to a project.
`oprex_list_specifications`	read	List specifications (technical designs) — optionally scoped to a project.
`oprex_get_project`	read	Get a single project by id, with full detail (visibility, group, git repo, type).
`oprex_list_tickets`	read	List support/helpdesk tickets — optionally scoped to a project and filtered by status/text.
`oprex_list_test_cases`	read	List test cases (TestLink-style scenarios) — optionally scoped to a project.
`oprex_list_pipelines`	read	List CI/CD pipelines and their runs — optionally scoped to a project.
`oprex_list_release_plans`	read	List release plans (roadmap of planned releases) — optionally scoped to a project.
`oprex_coverage_matrix`	read	Get the requirement→test coverage matrix for a project (traceability).

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.

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? Dalam roadmap. Sekarang gunakan klien yang mendukung header API-key.