Kucedr supporta Model Context Protocol, uno standard aperto per collegare strumenti e dati esterni agli assistenti AI, tramite server HTTP remoti o processi stdio locali.
| Trasporto | Configurazione |
|---|---|
| HTTP remoto | ID e nome del server, URL, bearer token facoltativo, ID client OAuth e client secret facoltativi. |
| stdio locale | ID e nome del server, comando, argomenti separati da spazi, variabili d’ambiente KEY=value facoltative e cartella di lavoro facoltativa. |
Configurare Un Server
Le Impostazioni MCP mostrano un unico elenco per servizi remoti, comandi configurati e pacchetti locali rilevati. Puoi aggiungere o modificare un server, abilitarlo o disabilitarlo, vedere la diagnostica del catalogo e della connessione, eseguire un test live con numero di strumenti e latenza e autorizzare nuovamente un server HTTP OAuth senza bearer token.
L’ID e il tipo di trasporto non possono essere modificati dopo la creazione. La pagina di dettaglio permette configurazione, test e rimozione e mostra ID, stato, URL o comando, tipo di autenticazione, date e ultimo errore.
Dopo l'autenticazione o un test del server, Kucedr salva il catalogo completo dei suoi strumenti in locale. Le esecuzioni dell'agente cercano in queste definizioni senza collegarsi a tutti i server o richiedere ogni volta l'elenco degli strumenti. Quando l'agente sceglie uno strumento, Kucedr si collega al relativo server per eseguirlo. Usa Test dopo una modifica agli strumenti del server per aggiornare il catalogo salvato. Dopo un aggiornamento dell'app, i server abilitati senza catalogo salvato vengono elencati una volta in background.
Pacchetti Locali
Kucedr rileva dinamicamente i pacchetti server locali in ~/.kucedr/mcp/servers. Inserisci lì una cartella valida e apri le Impostazioni MCP o avvia l'agente per aggiornare il registro. La pagina attuale non offre caricamento di pacchetti, apertura della cartella o aggiornamento manuale dell'elenco. Puoi verificare un server rilevato dalla sua pagina di dettaglio.
Ogni pacchetto risiede in una propria cartella e contiene un manifest mcp.json:
{
"id": "filesystem",
"name": "Filesystem",
"type": "stdio",
"command": "node",
"args": ["dist/server.js"],
"env": { "MODE": "production" },
"cwd": ".",
"require_approval": "always",
"enabled": true
}
Quando id manca, viene usato il nome della cartella. Gli ID accettano lettere minuscole, numeri e trattini singoli. Le cartelle di lavoro relative vengono risolte dalla cartella del pacchetto. I server configurati esplicitamente hanno la precedenza su un pacchetto rilevato con lo stesso ID; i pacchetti non validi o duplicati vengono segnalati senza bloccare gli altri server.
Autorizzazioni
Il campo salvato require_approval viene applicato e imposta il permesso predefinito dello strumento MCP su Consenti o Chiedi.
Gli strumenti MCP non fanno parte dell’elenco centralizzato degli strumenti protetti, quindi vale la loro impostazione require_approval. Esamina un server prima di abilitarlo.
Limiti Attuali
- Il campo salvato
defer_loadingresta per compatibilità; le esecuzioni dell'agente usano il catalogo salvato indipendentemente dal suo valore. - Gli strumenti caricati dinamicamente non fanno parte dell’elenco integrato degli strumenti protetti; viene applicato il valore predefinito derivato da
require_approval. - Le modifiche all'elenco degli strumenti del server compaiono solo dopo aver aggiornato il catalogo con Test.
Consulta Plugin per il catalogo delle integrazioni, usa le Skill per procedure riutilizzabili e crea un’App quando il flusso di lavoro ha bisogno di una propria interfaccia.