Plugin- und MCP-Server-Integration
So verbinden Sie einen eigenen MCP-Server mit Keural und erstellen ein Plugin-Paket für die Desktop-App.
Die Plugins von Keural sind MCP-Server (Model Context Protocol). Diese Seite beschreibt die Spezifikation für Entwickler, die einen eigenen MCP-Server mit Keural verbinden oder ein Plugin-Paket für die Desktop-App erstellen.
Transportarten
| Plattform | Transport | Verwendung |
|---|---|---|
| Web und Mobil | HTTP (Streamable HTTP) · SSE | Über das Internet erreichbare entfernte MCP-Server |
| Desktop-App | STDIO · HTTP | Auf diesem Computer laufende Server, HTTP-Server im Firmennetz |
- In Web-Unterhaltungen werden nur entfernte HTTP- oder SSE-Server verwendet. STDIO-Server laufen in der Desktop-App.
- Endet die Serveradresse auf
/mcp, handelt es sich meist um einen Streamable-HTTP-Server. Wählen Sie dann als Transport HTTP. - HTTP in der Desktop-App ist für Adressen im Firmennetz gedacht. Öffentliche Internetadressen registrieren Sie im Web mit HTTP.
Eingabewerte für eigene Server
Die Eingabefelder unter Einstellungen → Plugins → ＋ Eigenen MCP hinzufügen sind:
| Feld | Inhalt |
|---|---|
| Name | Pflichtfeld |
| Beschreibung | Optional |
| Transport | Siehe Tabelle oben |
| Kategorie | Einordnung in der Liste |
| Server-URL | Pflicht bei HTTP oder SSE. Beispiel: https://example.com/mcp |
| Startbefehl | Pflicht bei STDIO. Beispiel: npx |
| Argumente | STDIO-Argumente (JSON-Array). Beispiel: ["-y", "@scope/server"] |
| Dieses Plugin für die Websuche verwenden | Ist die Option aktiv, nutzt die Websuche dieses Plugin statt der Standardsuche. |
| Authentifizierung | Keine · API-Schlüssel |
| Headername · Wert des API-Schlüssels | Bei API-Schlüssel. Beispiel: Headername Authorization, Wert Bearer … |
Wählen Sie einen API-Schlüssel, sendet Keural bei jeder Anfrage den Header <Headername>: <Wert> mit.
OAuth-Authentifizierung
Plugins, die ein Organisationsadministrator mit OAuth registriert hat, verlangen, dass der Benutzer auf Verbinden klickt und sich anmeldet.
| Element | Wert |
|---|---|
| Serverermittlung | /.well-known/oauth-protected-resource (mit Pfad, danach ohne Pfad), dann /.well-known/oauth-authorization-server |
| Client-Registrierung | Dynamische Client-Registrierung (DCR) |
| Redirect-URI | https://api.keural.ai/api/user-connectors/oauth/callback |
| Anfrage-Header | Authorization: Bearer <Zugriffstoken> |
Das Anmeldefenster öffnet sich als Pop-up. Nach Abschluss der Anmeldung wird die Plugin-Liste aktualisiert.
Werkzeugberechtigungen
Legen Sie für jedes Werkzeug des Plugins fest, wie es ausgeführt wird.
| Berechtigung | Verhalten |
|---|---|
| Immer erlauben | Wird ohne Rückfrage ausgeführt. |
| Freigabe erforderlich | Zeigt vor der Ausführung eine Freigabekarte an. Auf der Karte werden auch die Argumente des Werkzeugs angezeigt. |
| Blockiert | Der Agent verwendet dieses Werkzeug nicht. |
Plugin-Paket für den Desktop
Die Desktop-App installiert Plugins über Plugin-ZIP-Datei… oder Plugin-Ordner…. Das Paket muss das Manifest plugin.json enthalten.
{
"id": "my-plugin",
"name": "My Plugin",
"version": "1.0.0",
"description": "Abfrage interner Systeme",
"mcpServers": {
"my-server": {
"command": "node",
"args": ["server.js"],
"env": { "API_BASE": "https://intranet.example.com" }
}
}
}| Feld | Pflicht | Inhalt |
|---|---|---|
id | Ja | Kleine lateinische Buchstaben, Ziffern und Bindestriche |
name | Nein | Anzeigename. Fehlt er, wird id verwendet. |
version | Nein | Standard 1.0.0 |
description | Nein | Beschreibung |
minAppVersion | Nein | Mindestversion der App |
mcpServers | Nein | Definitionen der MCP-Server. Je Server command, args und env. |
requests | Nein | Angeforderte Berechtigungen (capabilities, commands, connectors, secrets, permissions). Array aus Zeichenketten |
Ein im Web registriertes STDIO-Plugin installieren Sie in der Desktop-App über Auf diesem PC installieren. Danach geben Sie Authentifizierungstoken und Umgebungsvariablen manuell ein.