Tool MCP Oprex
Agen AI yang terhubung ke Oprex tidak lagi menebak-nebak struktur data atau URL internal. Ia memanggil tool yang sudah didefinisikan, dan Oprex menjalankannya di dalam tenant serta izin Anda.
Daftar tool
Tool dibagi menjadi kelompok. Yang paling sering dipakai:
| Kelompok | Contoh tool | Apa yang dilakukan |
|---|---|---|
| Baca lifecycle | oprex_list_projects, oprex_get_requirement, oprex_list_releases | Mengembalikan daftar atau satu objek dari requirements, tests, releases, milestones, coverage, dan memory. |
| Defect & work | oprex_list_bugs, oprex_create_bug, oprex_add_comment | Membuat bug, mengubah status, menambah komentar, dan menutup tiket helpdesk. |
| Memory | oprex_create_memory, oprex_remember, oprex_recall_memory | Menyimpan ringkasan sesi, fakta, dan konteks yang bisa dibaca sesi berikutnya. |
| Nama & lookup | oprex_resolve_project | Mengubah path manusia seperti acme/checkout menjadi id yang dibutuhkan tool lain. |
Toolsets: batasi apa yang bisa dilakukan agent
Anda tidak harus memberi agent akses ke seluruh lifecycle. Saat membuat API key, pilih toolset:
full— semua tool.read-only— hanya tool baca.bugs-only— hanya defect tracking.requirements-tests— hanya requirement, spec, test, coverage.
Toolset dicegah di lapisan auth, bukan oleh konvensi. Agent tidak bisa memanggil tool di luar toolset yang Anda pilih.
Cara melihat tool yang aktif
Setelah terhubung, minta agent menjalankan tools/list. Itu mengembalikan definisi tool yang sedang aktif, termasuk deskripsi dan parameter. Jika tool yang Anda harapkan tidak ada, toolset-nya terlalu sempit.
Kesalahan umum
- Key salah scope. Key yang di-bind ke satu project tidak bisa membaca project lain. Cek
oprex_list_projectsterlebih dulu. - Toolset terlalu lebar. Berikan read-only dulu saat evaluasi. Aktifkan write hanya setelah Anda yakin.
- Mengandalkan ingatan agent tanpa MCP. Tanpa MCP, agent menjawab dari pengetahuan umum, bukan dari data Anda.