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

CapabilityDescription
List AssessmentsTampilkan daftar assessment terbaru di sistem
Get Assessment DetailAmbil detail lengkap satu assessment berdasarkan nama atau ID
List Test CasesLihat test case beserta statusnya untuk fitur atau assessment tertentu
Get MandaysTarik data mandays beserta link referensi dari solution IDs terkait
Search AssessmentCari 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

  1. Buka web Odoo perusahaan di browser dan login
  2. Klik foto profil di pojok kanan atas → pilih My Profile
  3. Pindah ke tab Account Security
  4. Scroll ke bagian API Key → klik New API Key
  5. Beri nama yang jelas, misal: MCP Claude Demo atau Integrasi AI Claude
  6. 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 → SettingsDeveloper SettingsEdit 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 args sesuai 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 MCP
untuk 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

MasalahSolusi
Request ditolak / timeoutPastikan VPN aktif dan koneksi stabil
kiskas-assessment tidak muncul di ConnectorsValidasi JSON di jsonlint.com, restart Claude penuh
Error autentikasi OdooCek ODOO_USERNAME dan ODOO_API_KEY sudah benar
API Key tidak validKey mungkin sudah dihapus. Buat API Key baru di Odoo
Claude pakai tools yang salahTambahkan instruksi eksplisit di prompt: “Pakai Kiskas Assessment MCP”
Data mandays tidak munculProses multi-tahap — beri waktu lebih lama, atau coba prompt ulang dengan nama assessment yang lebih spesifik