Aggiungere un proprio server MCP
Con un proprio server MCP, colleghi AI-Public a un sistema di gestione dei casi, archivio, fonte dati o altro servizio specializzato. Scegli prima il trasporto adatto al luogo di utilizzo.
Scegli il trasporto giusto
| Trasporto | Web | Mobile | Desktop | Uso |
|---|---|---|---|---|
| Streamable HTTP | Sì | Sì | Sì | Raccomandato per server ospitati |
| stdio | No | No | Sì | Processi locali e integrazioni desktop |
| SSE | Solo configurazioni esistenti | Solo configurazioni esistenti | Sì | Trasporto obsoleto; per nuovi server scegli Streamable HTTP |
Requisiti per Streamable HTTP
Usa l’endpoint pubblico completo, incluso il percorso MCP, ad esempio:
https://mcp.organisatie.nl/mcp
L’endpoint deve usare HTTPS, essere raggiungibile tramite DNS pubblico senza redirect e rispondere con un handshake MCP initialize valido. Nomi utente e password non devono essere inclusi nell’URL. Indirizzi locali, indirizzi di rete privata e endpoint di metadata cloud sono bloccati.
Aggiungere un server
- Apri Preferenze → Tools.
- Scegli Aggiungi tool o Aggiungi server MCP.
- Visualizza i preset disponibili.
- Scegli Aggiungi un server MCP personalizzato.
- Inserisci nome, endpoint completo e metodo di autenticazione.
- Salva la configurazione e attendi il controllo di connessione.
- Attiva il server per il tuo set di strumenti predefinito.
Un amministratore può registrare un server per l’intero ambiente tramite Gestione → Tools → MCP.
Autenticazione e segreti
AI-Public supporta connector-OAuth e segreti statici. Token OAuth, token di refresh, chiavi API e password sono conservati in storage accessibile solo al server. Una chat riceve solo il connectorId registrato, mai la configurazione segreta.
Se URL o autenticazione cambiano, la nuova configurazione viene prima verificata nuovamente. Se il controllo fallisce, una configurazione precedentemente approvata può rimanere attiva finché il problema non è risolto.
Permessi degli strumenti e sicurezza delle informazioni
Rilascia solo gli strumenti di cui gli utenti hanno effettivamente bisogno. Un server MCP può offrire azioni di lettura e scrittura. AI-Public filtra gli strumenti scoperti tramite una allowlist lato server e verifica ambiente, proprietario e ruolo ad ogni utilizzo. L’organizzazione resta responsabile di scope adeguati, logging, periodi di conservazione e autorizzazioni nel sistema sorgente.
Server desktop locali
Un server stdio locale si installa nell’app desktop. Comando, argomenti, chiavi di ambiente e accessi richiesti sono limitati e mostrati prima dell’approvazione. I segreti sono crittografati localmente.
Risoluzione dei problemi
- Endpoint non raggiungibile: verifica HTTPS, DNS, firewall e il percorso completo
/mcp. - Necessario riconnettersi: rinnova il permesso OAuth o il segreto salvato.
- Appartiene a un altro ambiente: registra nuovamente il connettore nell’ambiente corrente.
- Nessuno strumento visibile: controlla allowlist, accesso ruolo e stato attivo.
- Funziona solo su desktop: probabilmente il server usa stdio o un indirizzo locale.
