Integrasi Pemalam·Pelayan MCP
Cara menyambungkan pelayan MCP yang anda bina sendiri ke Keural dan mencipta pakej pemalam untuk aplikasi desktop.
Pemalam dalam Keural ialah pelayan MCP (Model Context Protocol). Dokumen ini ialah spesifikasi untuk pembangun yang menyambungkan pelayan MCP mereka ke Keural atau mencipta pakej pemalam untuk aplikasi desktop.
Pengangkutan
| Platform | Pengangkutan yang boleh dipilih | Kegunaan |
|---|---|---|
| Web·mudah alih | HTTP(Streamable HTTP) · SSE | Pelayan MCP jauh yang boleh diakses melalui internet |
| Aplikasi desktop | STDIO · HTTP | Pelayan yang dijalankan pada komputer ini, pelayan HTTP dalam rangkaian dalaman |
- Perbualan web hanya menggunakan pelayan HTTP·SSE jauh. Pelayan STDIO dijalankan dalam aplikasi desktop.
- Jika alamat pelayan berakhir dengan
/mcp, ia biasanya pelayan Streamable HTTP, jadi pilih pengangkutan HTTP. - HTTP pada desktop adalah untuk alamat rangkaian dalaman. Alamat internet awam didaftarkan sebagai HTTP pada web.
Nilai input tambah secara manual
Dalam Tetapan → Pemalam → ＋ Tambah MCP tersuai, ruangan berikut dipaparkan.
| Ruangan | Kandungan |
|---|---|
| Nama | Wajib |
| Penerangan | Pilihan |
| Pengangkutan | Lihat jadual di atas |
| Kategori | Pengelasan dalam senarai |
| URL pelayan | Wajib untuk HTTP·SSE. Contoh: https://example.com/mcp |
| Arahan | Wajib untuk STDIO. Contoh: npx |
| Argumen | Argumen STDIO (tatasusunan JSON). Contoh: ["-y", "@scope/server"] |
| Gunakan pemalam ini untuk carian web | Jika dihidupkan, pemalam ini digunakan dan bukannya carian web. |
| Pengesahan | Tiada pengesahan · Kunci API |
| Nama pengepala · nilai kunci API | Apabila menggunakan kunci API. Contoh: nama pengepala Authorization, nilai Bearer … |
Apabila kunci API dipilih, Keural melampirkan <nama pengepala>: <nilai> pada setiap permintaan.
Pelayan pengesahan OAuth
Pemalam yang didaftarkan oleh pentadbir organisasi dengan kaedah OAuth akan log masuk oleh pengguna selepas menekan Sambung.
| Item | Nilai |
|---|---|
| Penemuan pelayan | /.well-known/oauth-protected-resource (dengan laluan → akar), kemudian /.well-known/oauth-authorization-server |
| Pendaftaran klien | Pendaftaran klien dinamik (DCR) |
| URI ubah hala | https://api.keural.ai/api/user-connectors/oauth/callback |
| Pengepala permintaan | Authorization: Bearer <access token> |
Tetingkap log masuk dibuka sebagai pop timbul, dan senarai pemalam dikemas kini apabila log masuk selesai.
Kebenaran alat
Tentukan cara setiap alat pemalam dijalankan.
| Kebenaran | Gelagat |
|---|---|
| Sentiasa benarkan | Dijalankan tanpa pengesahan. |
| Tanya setiap kali | Memaparkan kad kelulusan sebelum dijalankan. Argumen alat turut dipaparkan pada kad. |
| Disekat | Ejen tidak menggunakan alat ini. |
Pakej pemalam desktop
Aplikasi desktop memasang pemalam melalui Fail ZIP pemalam… atau Folder pemalam…. Pakej memerlukan manifest plugin.json.
{
"id": "my-plugin",
"name": "My Plugin",
"version": "1.0.0",
"description": "Carian sistem dalaman",
"mcpServers": {
"my-server": {
"command": "node",
"args": ["server.js"],
"env": { "API_BASE": "https://intranet.example.com" }
}
}
}| Medan | Wajib | Kandungan |
|---|---|---|
id | Ya | Huruf kecil, nombor, dan sengkang dalam bahasa Inggeris |
name | Tidak | Nama paparan. Jika tiada, id digunakan. |
version | Tidak | Lalai 1.0.0 |
description | Tidak | Penerangan |
minAppVersion | Tidak | Versi aplikasi minimum yang diperlukan |
mcpServers | Tidak | Takrifan pelayan MCP. Bagi setiap pelayan: command, args, env |
requests | Tidak | Kebenaran yang diminta (capabilities, commands, connectors, secrets, permissions). Tatasusunan rentetan |
Pemalam STDIO yang didaftarkan pada web dipasang ke aplikasi desktop dengan Pasang pada PC ini. Selepas dipasang, masukkan sendiri token pengesahan dan pembolehubah persekitaran.