Odoo Assessment MCP
Tarik data Assessment, Test Case, dan Mandays dari Odoo langsung lewat obrolan di Claude — tanpa buka terminal atau script CLI.
Overview
Odoo Assessment MCP menghubungkan Claude langsung ke data Assessment, Test Case, dan Mandays di Odoo internal Qiscus. Kamu bisa minta Claude mencari, merangkum, atau mengecek status assessment cukup lewat chat biasa — tanpa perlu buka terminal, jalankan script CLI, atau login ke Odoo secara manual.
Integrasi ini bersifat Read-Only — kamu tidak bisa mengubah, mengedit, atau menghapus data Odoo melalui MCP ini.
Wajib: VPN perusahaan harus aktif dan stabil sebelum menggunakan MCP ini. Sistem Odoo berada di jaringan tertutup — tanpa VPN, semua request akan ditolak atau timeout.
Capabilities
| Capability | Description |
|---|---|
| List Assessments | Tampilkan daftar assessment terbaru di sistem |
| Get Assessment Detail | Ambil detail lengkap satu assessment berdasarkan nama atau ID |
| List Test Cases | Lihat test case beserta statusnya untuk fitur atau assessment tertentu |
| Get Mandays | Tarik data mandays beserta link referensi dari solution IDs terkait |
| Search Assessment | Cari assessment berdasarkan nama atau keyword |
Install Steps
Sebelum Mulai
- VPN perusahaan aktif dan koneksi stabil
- Claude Desktop ter-install — download
- Node.js v18+ — cek dengan
node --version. Belum ada? Install dari nodejs.org (pilih LTS) - Akses login ke Odoo internal Qiscus
1. Buat API Key di Odoo
- Buka web Odoo perusahaan di browser dan login
- Klik foto profil di pojok kanan atas → pilih My Profile
- Pindah ke tab Account Security
- Scroll ke bagian API Key → klik New API Key
- Beri nama yang jelas, misal:
MCP Claude DemoatauIntegrasi AI Claude - Klik Generate
Penting: Langsung copy API Key yang muncul dan simpan di password manager (Bitwarden, 1Password, dll). Odoo hanya menampilkan kode ini sekali — kalau terlewat, kamu harus hapus key tersebut dan buat ulang.
2. Atur Konfigurasi di Claude Desktop
Buka Claude Desktop → Settings → Developer Settings → Edit Config.
Tambahkan snippet berikut ke dalam mcpServers. Ganti semua bagian [...] dengan data kamu:
{ "mcpServers": { "kiskas-assessment": { "command": "npx", "args": ["-y", "[NAMA_PACKAGE_MCP]"], "env": { "ODOO_URL": "[URL_ODOO_PERUSAHAAN]", "ODOO_DB": "[NAMA_DATABASE_ODOO]", "ODOO_USERNAME": "[EMAIL_ANDA_DI_ODOO]", "ODOO_API_KEY": "[API_KEY_DARI_LANGKAH_1]" } } }}Pastikan nama package di
argssesuai dengan instruksi terbaru dari tim developer. Salah ketik satu karakter pun akan membuat Claude gagal terhubung ke MCP.
Kalau config sudah ada MCP server lain, gabungkan entry kiskas-assessment ke dalam mcpServers yang sudah ada — jangan timpa seluruh file.
Save file (Cmd+S / Ctrl+S).
3. Restart Claude Desktop
Quit Claude Desktop sepenuhnya — jangan hanya tutup window:
- macOS:
Cmd+Q, atau menu Claude di menu bar → Quit - Windows: system tray kanan bawah → ikon Claude → klik kanan → Quit. Atau lewat Task Manager
- Linux: system tray → ikon Claude → Quit
Buka Claude Desktop lagi. Kalau setup berhasil, ikon tools tambahan akan muncul — tandanya MCP sudah aktif.
Contoh Prompt
Claude kadang bisa salah pilih tools dan malah pakai tools bawaannya sendiri. Beri instruksi yang spesifik agar Claude menggunakan MCP yang tepat:
Jangan pakai skill assessment validation bawaanmu. Pakai tools Kiskas Assessment MCPuntuk list 5 assessment terbaru di sistem.Cariin data mandays beserta link referensinya untuk assessment [Nama_Assessment].Pakai Kiskas Assessment MCP, cek status detail test case untuk [Nama_Fitur]dan buatin rangkumannya.Catatan Teknis: Pencarian Mandays
Data mandays tidak berada di level permukaan database Odoo — datanya tersimpan jauh di dalam tabel Solution IDs. Saat kamu meminta data mandays, Claude perlu melakukan proses multi-tahap: mencari tiket assessment → menelusuri solution ID → baru menarik angka mandays. Beri waktu sebentar agar prosesnya selesai dengan lengkap dan akurat.
Troubleshooting
| Masalah | Solusi |
|---|---|
| Request ditolak / timeout | Pastikan VPN aktif dan koneksi stabil |
kiskas-assessment tidak muncul di Connectors | Validasi JSON di jsonlint.com, restart Claude penuh |
| Error autentikasi Odoo | Cek ODOO_USERNAME dan ODOO_API_KEY sudah benar |
| API Key tidak valid | Key mungkin sudah dihapus. Buat API Key baru di Odoo |
| Claude pakai tools yang salah | Tambahkan instruksi eksplisit di prompt: “Pakai Kiskas Assessment MCP” |
| Data mandays tidak muncul | Proses multi-tahap — beri waktu lebih lama, atau coba prompt ulang dengan nama assessment yang lebih spesifik |