Integrasi Plugin·Server MCP
Cara menghubungkan server MCP buatan sendiri ke Keural dan membuat paket plugin untuk aplikasi desktop.
Plugin di Keural adalah server MCP (Model Context Protocol). Spesifikasi ini berlaku saat Anda menghubungkan server MCP ke Keural atau membuat paket plugin untuk aplikasi desktop.
Transport
| Platform | Transport yang bisa dipilih | Kegunaan |
|---|---|---|
| Web·mobile | HTTP(Streamable HTTP) · SSE | Server MCP jarak jauh yang bisa diakses dari internet |
| Aplikasi desktop | STDIO · HTTP | Server yang berjalan di komputer ini, server HTTP di jaringan internal |
- Di percakapan web, hanya server HTTP·SSE jarak jauh yang dapat digunakan. Server STDIO dijalankan di aplikasi desktop.
- Jika alamat server berakhiran
/mcp, server biasanya berjenis Streamable HTTP, sehingga pilih transport HTTP. - HTTP di desktop ditujukan untuk alamat jaringan internal. Alamat internet publik didaftarkan sebagai HTTP di web.
Input saat menambah manual
Kolom input di Pengaturan → Plugin → ＋ Tambah MCP kustom adalah sebagai berikut.
| Kolom | Isi |
|---|---|
| Nama | Wajib |
| Deskripsi | Opsional |
| Transport | Lihat tabel di atas |
| Kategori | Pengelompokan dalam daftar |
| URL server | Wajib untuk HTTP·SSE. Contoh: https://example.com/mcp |
| Perintah | Wajib untuk STDIO. Contoh: npx |
| Argumen | Argumen STDIO (array JSON). Contoh: ["-y", "@scope/server"] |
| Gunakan plugin ini untuk pencarian web | Jika aktif, plugin ini dipakai sebagai pengganti pencarian web. |
| Autentikasi | Tanpa autentikasi · API key |
| Nama header · nilai API key | Jika memakai API key. Contoh: nama header Authorization, nilai Bearer … |
Jika memilih API key, setiap permintaan dikirim dengan header <nama header>: <nilai>.
Server autentikasi OAuth
Plugin yang didaftarkan admin organisasi dengan metode OAuth akan login oleh pengguna setelah menekan Hubungkan.
| Item | Nilai |
|---|---|
| Penemuan server | /.well-known/oauth-protected-resource (dengan path → root), lalu /.well-known/oauth-authorization-server |
| Pendaftaran klien | Dynamic Client Registration (DCR) |
| Redirect URI | https://api.keural.ai/api/user-connectors/oauth/callback |
| Header permintaan | Authorization: Bearer <access token> |
Jendela login terbuka sebagai popup dan daftar plugin diperbarui setelah login selesai.
Izin alat
Tentukan cara menjalankan setiap alat plugin.
| Izin | Perilaku |
|---|---|
| Selalu izinkan | Dijalankan tanpa konfirmasi. |
| Tanya setiap kali | Menampilkan kartu persetujuan sebelum dijalankan. Argumen alat juga ditampilkan di kartu. |
| Diblokir | Agen tidak memakai alat ini. |
Paket plugin desktop
Aplikasi desktop memasang plugin melalui File ZIP plugin… atau Folder plugin…. Paket memerlukan manifes plugin.json.
{
"id": "my-plugin",
"name": "My Plugin",
"version": "1.0.0",
"description": "Pencarian sistem internal",
"mcpServers": {
"my-server": {
"command": "node",
"args": ["server.js"],
"env": { "API_BASE": "https://intranet.example.com" }
}
}
}| Field | Wajib | Isi |
|---|---|---|
id | Ya | Huruf kecil, angka, dan tanda hubung dalam bahasa Inggris |
name | Tidak | Nama tampilan. Jika kosong, id dipakai. |
version | Tidak | Default 1.0.0 |
description | Tidak | Deskripsi |
minAppVersion | Tidak | Versi aplikasi minimum yang dibutuhkan |
mcpServers | Tidak | Definisi server MCP. Untuk setiap server: command, args, env |
requests | Tidak | Izin yang diminta (capabilities, commands, connectors, secrets, permissions). Array string |
Plugin STDIO yang didaftarkan di web dipasang di aplikasi desktop melalui Instal di PC ini. Setelah dipasang, isi token autentikasi dan variabel lingkungan secara manual.