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>" }
}
}
} | Impostazione | Valori |
|---|---|
| Trasporto | stdio (un comando locale con command, args, env), http o sse (un URL con headers facoltativi). |
| Autenticazione | none, api_key o oauth. |
| OAuth | Nebo 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
| Comando | Cosa fa |
|---|---|
nebo mcp serve | Collega standard input e standard output al bot in esecuzione. |
--tools a,b | Offre solo gli strumenti elencati. |
--exclude-tools x | Nasconde 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.