Guida all’installazione di Gebo.ai · Integrazioni · Pagina 16
Esporre Gebo.ai come server MCP
Pubblica strumenti, basi di conoscenza e prompt di Gebo.ai come server MCP per Claude Desktop, Cursor, estensioni IDE e automazioni. Ogni client agisce con i diritti dell’utente che si collega, tramite una chiave API personale.
- Tempo
- 10 minuti.
- Ti serve
- Niente al di fuori di Gebo.ai. Ogni utente che collega un client genera la propria chiave API.
1Crea il server
In Impostazioni → Modelli AI, agenti e interoperabilità clicca Configure Exposed MCP Servers, poi Add MCP Server Configuration.

- Descrizione.
- URL relativo univoco esportato: il nome del server nel suo indirizzo, per esempio
conoscenza-aziendale: il server risponde a/mcp/conoscenza-aziendale. - Abilitato: togli la spunta per pubblicarlo più tardi.
- Salva.
2Scegli cosa esporta

In Strumenti esportati (1) spunta gli strumenti che i client possono chiamare, per categoria o uno a uno: data e ora, profilo e colleghi dell’utente, lettura di una pagina web, ricerca approfondita sulle basi di conoscenza. Risorse esportate sceglie basi di conoscenza, progetti e fonti dati che i client possono sfogliare; Prompt esportati i prompt salvati. Anche agenti e reti di agenti possono essere esportati come strumenti, ognuno risponde a una richiesta in linguaggio naturale.

In Impostazioni di accesso e sicurezza (1) il server serve tutti (2) oppure solo i gruppi (3) e gli utenti (4) scelti. Qualunque cosa esporti il server, un client non vede mai più di quanto il suo utente vede in Gebo.ai.
3Collega un client
Ogni utente trova i server che può usare in Chiavi API/MCP nel menu in alto.

In Chiavi API personali (2) clicca Genera nuova chiave:

- Descrizione: per quale client è la chiave.
- Scadenza: 7, 30 o 90 giorni, oppure una data.
- Genera chiave: la chiave viene mostrata una volta sola, copiala.
Il client si configura con l’indirizzo del server sotto /mcp/, il trasporto Streamable HTTP e la chiave come bearer token. Per Claude Desktop o Cursor:
{
"mcpServers": {
"gebo": {
"type": "streamable-http",
"url": "http://<indirizzo del server>:12999/mcp/conoscenza-aziendale",
"headers": { "Authorization": "Bearer <la tua chiave API>" }
}
}
}http://<indirizzo del server>:12999/mcp/<url relativo univoco esportato>, in HTTPS quando Gebo.ai è dietro un reverse proxy. I client si collegano con il trasporto Streamable HTTP.