NeboAI
NeboAI
Inizia

MCP

Il Model Context Protocol è un modo standard per offrire strumenti ai sistemi di IA. Nebo lo usa in entrambe le direzioni: un bot può collegarsi a server MCP perché i suoi dipendenti ne usino gli strumenti, e altri client MCP possono collegarsi a un bot per usare gli strumenti di Nebo e parlare con i suoi dipendenti.

Collega un server MCP

Il titolare aggiunge i server nella pagina MCP delle impostazioni di Nebo, oppure installa un connettore dal marketplace con il suo codice CONN-. Nebo accetta anche il blocco di configurazione standard pubblicato dai server MCP, con una chiave mcpServers oppure servers.

{
  "mcpServers": {
    "files": {
      "command": "example-files-mcp",
      "args": ["--root", "/Users/me/Documents"],
      "env": { "LOG_LEVEL": "info" }
    },
    "tickets": {
      "type": "http",
      "url": "https://mcp.example.com/mcp",
      "headers": { "Authorization": "Bearer <token>" }
    }
  }
}
ImpostazioneValori
Trasportostdio (un comando locale con command, args, env), http o sse (un URL con headers facoltativi).
Autenticazionenone, api_key o oauth.
OAuthNebo individua gli endpoint di autorizzazione del server, si registra quando il server supporta la registrazione dinamica dei client, usa PKCE con S256, aggiorna i token prima che scadano e li salva cifrati.

Come i dipendenti vedono gli strumenti MCP

Ogni strumento di un server collegato diventa uno strumento chiamato mcp__<server>__<tool>, disponibile per ogni dipendente del bot e caricato quando un dipendente ne ha bisogno. Gli strumenti MCP seguono le stesse approvazioni di tutti gli altri strumenti; una regola del titolare può indicare un solo strumento o un intero server, come mcp__tickets__*. Vedi Capability e approvazioni.

Usa Nebo come server MCP

Un bot in esecuzione risponde alle richieste MCP su POST /agent/mcp al suo indirizzo locale, usando JSON-RPC e la versione 2025-03-26 del protocollo MCP. Offre gli strumenti del bot e uno strumento nebo per inviare messaggi ai dipendenti, leggere la cronologia e gestire le sessioni. Ogni richiesta richiede una credenziale: la chiave di installazione del bot, letta da NEBO_MCP_API_KEY oppure da .install-key nella cartella dei dati del bot.

Per i client che avviano i server MCP come comandi locali, nebo mcp serve esegue un ponte tra standard input e standard output e il bot in esecuzione, e fornisce la chiave da solo.

nebo mcp serve --tools read_file,run_command
nebo mcp serve --exclude-tools desktop
ComandoCosa fa
nebo mcp serveCollega standard input e standard output al bot in esecuzione.
--tools a,bOffre solo gli strumenti elencati.
--exclude-tools xNasconde gli strumenti elencati.
nebo mcp config --target <client>Stampa il blocco di configurazione per un client supportato.

Un bot resta in ascolto solo sul proprio computer, a meno che non venga avviato con NEBO_ALLOW_REMOTE=true.

Il server MCP di NeboAI

NeboAI stessa gestisce un server MCP all’indirizzo https://neboai.com/mcp per pubblicare nel marketplace. Vedi Pubblicazione.