Aggiungere un proprio server MCP
Con un proprio server MCP, colleghi AI-Corporate a un'applicazione interna, una fonte di dati o un servizio specializzato. Scegli prima il trasporto più adatto al luogo di utilizzo.
Scegli il trasporto giusto
| Trasporto | Web | Mobile | Desktop | Uso |
|---|---|---|---|---|
| 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 scegli Streamable HTTP |
Requisiti per Streamable HTTP
Usa l'endpoint pubblico completo, incluso il percorso MCP, ad esempio:
https://mcp.example.com/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 adatti all'organizzazione.
- 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-Corporate supporta connector-OAuth e segreti statici. Token OAuth, token di refresh, chiavi API e password sono memorizzati in storage accessibile solo al server. Una chat riceve solo il connectorId registrato, mai la configurazione segreta.
Se l'URL o l'autenticazione cambiano, la nuova configurazione viene prima verificata nuovamente. Se il controllo fallisce, una configurazione precedentemente approvata può rimanere attiva finché il problema non viene risolto.
Permessi degli strumenti e governance
Rilascia solo gli strumenti di cui i dipendenti hanno effettivamente bisogno. Un server MCP può offrire azioni di lettura e scrittura. AI-Corporate filtra gli strumenti scoperti tramite una allowlist lato server e verifica tenant, proprietario e ruolo a ogni utilizzo. L'organizzazione rimane responsabile di scope appropriati, logging, periodi di conservazione e autorizzazioni nel sistema di origine.
Server desktop locali
Un server stdio locale si installa nell'app desktop. Il renderer non può avviare comandi shell arbitrari: 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. - Richiesta di riconnessione: 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.
