Intégration des plugins et des serveurs MCP
Comment connecter votre propre serveur MCP à Keural et créer un paquet de plugin pour l'application de bureau.
Les plugins de Keural sont des serveurs MCP (Model Context Protocol). Cette spécification s'applique lorsque vous connectez votre propre serveur MCP à Keural ou créez un paquet de plugin pour l'application de bureau.
Modes de transport
| Plateforme | Mode de transport | Usage |
|---|---|---|
| Web et mobile | HTTP (Streamable HTTP) · SSE | Serveurs MCP distants accessibles depuis Internet |
| Application de bureau | STDIO · HTTP | Serveurs exécutés sur cet ordinateur, serveurs HTTP du réseau interne |
- Dans les conversations web, seuls les serveurs HTTP ou SSE distants sont utilisés. Les serveurs STDIO s'exécutent dans l'application de bureau.
- Si l'adresse du serveur se termine par
/mcp, il s'agit en général d'un serveur Streamable HTTP. Choisissez HTTP comme transport. - Le HTTP de l'application de bureau est destiné aux adresses du réseau interne. Les adresses publiques sur Internet s'enregistrent en HTTP depuis le web.
Valeurs de l'ajout direct
Les champs de Paramètres → Plugins → ＋ Ajouter un MCP personnalisé sont les suivants.
| Champ | Contenu |
|---|---|
| Nom | Obligatoire |
| Description | Facultatif |
| Mode de transport | Voir le tableau ci-dessus |
| Catégorie | Classement dans la liste |
| URL du serveur | Obligatoire pour HTTP ou SSE. Exemple : https://example.com/mcp |
| Commande d'exécution | Obligatoire pour STDIO. Exemple : npx |
| Arguments | Arguments STDIO (tableau JSON). Exemple : ["-y", "@scope/server"] |
| Utiliser ce plugin pour la recherche web | Si activé, la recherche web utilise ce plugin au lieu de la recherche par défaut. |
| Authentification | Aucune · Clé d'API |
| Nom de l'en-tête · Valeur de la clé d'API | Lorsque la méthode est Clé d'API. Exemple : en-tête Authorization, valeur Bearer … |
Si vous choisissez une clé d'API, Keural ajoute l'en-tête <nom de l'en-tête>: <valeur> à chaque requête.
Serveurs OAuth
Les plugins qu'un administrateur de l'organisation a enregistrés avec OAuth demandent à l'utilisateur de cliquer sur Connecter et de se connecter.
| Élément | Valeur |
|---|---|
| Découverte du serveur | /.well-known/oauth-protected-resource (avec le chemin, puis la racine), puis /.well-known/oauth-authorization-server |
| Enregistrement du client | Enregistrement dynamique du client (DCR) |
| URI de redirection | https://api.keural.ai/api/user-connectors/oauth/callback |
| En-tête de requête | Authorization: Bearer <jeton d'accès> |
La fenêtre de connexion s'ouvre en pop-up, et la liste des plugins est actualisée une fois la connexion terminée.
Autorisations des outils
Définissez le mode d'exécution de chaque outil du plugin.
| Autorisation | Comportement |
|---|---|
| Toujours autoriser | Exécution sans confirmation. |
| Approbation requise | Affiche une carte d'approbation avant l'exécution. Les arguments de l'outil s'affichent aussi sur la carte. |
| Bloqué | L'agent n'utilise pas cet outil. |
Paquet de plugin pour le bureau
L'application de bureau installe les plugins via Fichier ZIP du plugin… ou Dossier du plugin…. Le paquet doit contenir le manifeste plugin.json.
{
"id": "my-plugin",
"name": "My Plugin",
"version": "1.0.0",
"description": "Consultation du système interne",
"mcpServers": {
"my-server": {
"command": "node",
"args": ["server.js"],
"env": { "API_BASE": "https://intranet.example.com" }
}
}
}| Champ | Obligatoire | Contenu |
|---|---|---|
id | Oui | Lettres minuscules, chiffres et tirets |
name | Non | Nom affiché. S'il est absent, id est utilisé. |
version | Non | Par défaut 1.0.0 |
description | Non | Description |
minAppVersion | Non | Version minimale de l'application requise |
mcpServers | Non | Définitions des serveurs MCP. Pour chaque serveur : command, args et env. |
requests | Non | Autorisations demandées (capabilities, commands, connectors, secrets, permissions). Tableau de chaînes |
Un plugin STDIO enregistré sur le web s'installe depuis l'application de bureau avec Installer sur ce PC. Après l'installation, saisissez vous-même le jeton d'authentification et les variables d'environnement.