Aggiungere un server MCP personalizzato
Con un server MCP personalizzato, si collega AI-Public a un sistema gestionale, archivio, fonte dati o altro servizio specializzato. Per prima cosa, scelga quale trasporto si adatta al contesto d’uso.
Scegliere il trasporto corretto
| Trasporto | Web | Mobile | Desktop | Utilizzo |
|---|---|---|---|---|
| Streamable HTTP | Sì | Sì | Sì | Consigliato 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 scegliere Streamable HTTP |
Requisiti per Streamable HTTP
Usi 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 a un handshake MCP initialize valido. Nomi utente e password non devono trovarsi nell’URL. Gli indirizzi locali, gli indirizzi di rete privati e gli endpoint dei metadati cloud vengono bloccati.
Aggiungere un server
- Aprire Preferenze → Tools.
- Scegliere Aggiungi Tools o Aggiungi server MCP. Questo pulsante è visibile solo se si dispone dell’accesso MCP.
- Esaminare i preset disponibili.
- Scegliere Aggiungi un server MCP personalizzato.
- Inserire nome, endpoint completo e metodo di autenticazione.
- Salvare la configurazione e attendere il controllo della connessione.
- Attivare il server per il set di strumenti predefinito.
Un amministratore può registrare un server per l’intero ambiente tramite Amministrazione → Tools → MCP.
Autenticazione e secret
AI-Public supporta OAuth del connettore e secret statici. I token OAuth, i refresh token, le chiavi API e le password sono archiviati in uno storage server-only. Una chat riceve solo il connectorId registrato, mai la configurazione segreta.
Se l’URL o l’autenticazione cambiano, la nuova configurazione viene prima verificata di nuovo. Se il controllo fallisce, una configurazione precedentemente approvata può rimanere attiva finché il problema non viene risolto.
Permessi dei tool e sicurezza delle informazioni
Conceda l’accesso solo ai tool di cui gli utenti hanno davvero bisogno. Un server MCP può offrire azioni di lettura e di scrittura. AI-Public filtra i tool scoperti tramite una allowlist lato server e controlla ambiente, proprietario e ruolo a ogni utilizzo. L’organizzazione resta responsabile di scope adeguati, logging, tempi di conservazione e autorizzazione 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 secret vengono crittografati localmente.
Risoluzione dei problemi
- Endpoint non raggiungibile: controlli HTTPS, DNS, firewall e l’intero percorso
/mcp. - Riconnessione richiesta: rinnovi il consenso OAuth o il secret salvato.
- Appartiene a un altro ambiente: registri di nuovo il connettore nell’ambiente corrente.
- Nessun tool visibile: verifichi allowlist, accesso per ruolo e stato attivo.
- Funziona solo su desktop: probabilmente il server usa stdio o un indirizzo locale.
Risorse di sviluppo
Vedi anche
Durante la modifica, viene recuperata la configurazione del server registrato. La chiave salvata rimane nascosta: lasci il campo della chiave vuoto per conservarla. In caso di URL o metodo di autenticazione diverso, è necessario ricollegare. Un errore in un singolo tool MCP non significa che tutti i tool di quel server siano inaccessibili.