Aggiungere un proprio server MCP
Con un proprio server MCP, collegate AI-Corporate a un'applicazione interna, una fonte dati o un servizio specializzato. Per prima cosa scegliete quale trasporto si adatta al luogo d'uso.
Scegliere il trasporto giusto
| 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
Usate 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 a un handshake MCP initialize valido. Nomi utente e password non devono essere presenti nell'URL. Gli indirizzi locali, gli indirizzi di rete privati e gli endpoint di metadata del cloud vengono bloccati.
Aggiungere un server
- Aprite Preferenze → Tools.
- Scegliete Aggiungi tools oppure Aggiungi server MCP. Questo pulsante è visibile solo se avete accesso MCP.
- Esaminate i preset disponibili adatti all'organizzazione.
- Scegliete Aggiungi da soli un server MCP.
- Inserite nome, endpoint completo e metodo di autenticazione.
- Salvate la configurazione e attendete il controllo della connessione.
- Attivate il server per il vostro set di strumenti predefinito.
Un amministratore può registrare un server per l'intero ambiente tramite Amministrazione → Tools → MCP.
Autenticazione e secret
AI-Corporate supporta OAuth del connettore e secret statici. I token OAuth, i refresh token, le chiavi API e le password sono archiviati solo lato server. Una chat riceve solo il connectorId registrato, mai la configurazione segreta.
Se l'URL o l'autenticazione cambiano, la nuova configurazione viene verificata di nuovo per prima. Se questo controllo fallisce, una configurazione precedentemente approvata può rimanere attiva finché il problema non viene risolto.
Permessi degli strumenti e governance
Concedete l'accesso solo agli strumenti realmente necessari ai dipendenti. Un server MCP può offrire azioni di lettura e scrittura. AI-Corporate filtra gli strumenti rilevati tramite una allowlist lato server e controlla tenant, proprietario e ruolo a ogni utilizzo. L'organizzazione rimane 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. Il renderer non può avviare comandi shell arbitrari: command, argomenti, chiavi di ambiente e accesso richiesto vengono limitati e mostrati prima dell'approvazione. I secret vengono crittografati localmente.
Risoluzione dei problemi
- Endpoint non raggiungibile: controllate HTTPS, DNS, firewall e il percorso completo
/mcp. - Richiesta di nuova connessione: rinnovate il consenso OAuth o il secret salvato.
- Appartiene a un altro ambiente: registrate di nuovo il connettore nell'ambiente corrente.
- Nessuno strumento visibile: controllate allowlist, accesso ai ruoli e stato attivo.
- Funziona solo su desktop: probabilmente il server usa stdio o un indirizzo locale.
Risorse per lo sviluppo
Vedi anche
Durante la modifica viene recuperata la configurazione del server registrato. La chiave salvata rimane nascosta: lasciate vuoto il campo della chiave per mantenerla. Se l'URL o il metodo di autenticazione sono diversi, è necessario ricollegarsi. Un errore in uno strumento MCP non significa che tutti gli strumenti di quel server non siano raggiungibili.