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.

Un nuovo server MCP esposto.
Un nuovo server MCP esposto.
  1. Descrizione.
  2. URL relativo univoco esportato: il nome del server nel suo indirizzo, per esempio conoscenza-aziendale: il server risponde a /mcp/conoscenza-aziendale.
  3. Abilitato: togli la spunta per pubblicarlo più tardi.
  4. Salva.

2Scegli cosa esporta

La scheda Strumenti esportati.
La scheda Strumenti esportati.

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.

La scheda Impostazioni di accesso e sicurezza.
La scheda Impostazioni di accesso e sicurezza.

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.

La pagina dell'utente: i server MCP (1) e le chiavi API personali (2).
La pagina dell’utente: i server MCP (1) e le chiavi API personali (2).

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

Una nuova chiave API personale.
Una nuova chiave API personale.
  1. Descrizione: per quale client è la chiave.
  2. Scadenza: 7, 30 o 90 giorni, oppure una data.
  3. 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>" }
    }
  }
}
L’indirizzoL’endpoint è sempre 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.
Una chiave è l’utenteChi possiede la chiave agisce come quell’utente. Le chiavi scadono da sole; cancellare una chiave dalla pagina la revoca subito. Le chiavi per script e servizi le genera invece un amministratore, vedi la pagina 19.