Ligar um servidor MCP
O proprietário adiciona servidores na página MCP das definições do Nebo, ou instala um conector da loja com o seu código CONN-. O Nebo também aceita o bloco de configuração padrão que os servidores MCP publicam, com uma chave mcpServers ou 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>" }
}
}
} | Definição | Valores |
|---|---|
| Transporte | stdio (um comando local com command, args, env), http ou sse (um URL com headers opcionais). |
| Autenticação | none, api_key ou oauth. |
| OAuth | O Nebo descobre os endpoints de autorização do servidor, regista-se quando o servidor suporta registo dinâmico de clientes, usa PKCE com S256, renova os tokens antes de expirarem e guarda-os encriptados. |
Como os funcionários veem as ferramentas MCP
Cada ferramenta de um servidor ligado torna-se uma ferramenta chamada mcp__<server>__<tool>, disponível para todos os funcionários do bot e carregada quando um funcionário precisa dela. As ferramentas MCP seguem as mesmas aprovações que todas as outras; uma regra do proprietário pode indicar uma ferramenta ou um servidor inteiro, como mcp__tickets__*. Ver Capacidades e aprovações.
Usar o Nebo como servidor MCP
Um bot em execução responde a pedidos MCP em POST /agent/mcp no seu endereço local, usando JSON-RPC e a versão 2025-03-26 do protocolo MCP. Disponibiliza as ferramentas do bot e uma ferramenta nebo para enviar mensagens aos funcionários, ler o histórico e gerir sessões. Todos os pedidos precisam de uma credencial: a chave de instalação do bot, lida de NEBO_MCP_API_KEY ou de .install-key na pasta de dados do bot.
Para clientes que iniciam servidores MCP como comandos locais, nebo mcp serve executa uma ponte de entrada e saída padrão para o bot em execução e fornece ela própria a chave.
nebo mcp serve --tools read_file,run_command nebo mcp serve --exclude-tools desktop
| Comando | Faz |
|---|---|
nebo mcp serve | Faz a ponte entre a entrada e saída padrão e o bot em execução. |
--tools a,b | Disponibiliza apenas as ferramentas listadas. |
--exclude-tools x | Oculta as ferramentas listadas. |
nebo mcp config --target <client> | Mostra o bloco de configuração para um cliente suportado. |
Um bot só escuta na sua própria máquina, a menos que seja iniciado com NEBO_ALLOW_REMOTE=true.
O servidor MCP da NeboAI
A própria NeboAI tem um servidor MCP em https://neboai.com/mcp para publicar na loja. Ver Publicação.