Conecte um servidor MCP
O proprietário adiciona servidores na página MCP das configurações do Nebo, ou instala um conector da loja com o código CONN- dele. 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>" }
}
}
} | Configuração | Valores |
|---|---|
| Transporte | stdio (um comando local com command, args, env), http ou sse (uma URL com headers opcionais). |
| Autenticação | none, api_key ou oauth. |
| OAuth | O Nebo descobre os endpoints de autorização do servidor, se registra quando o servidor aceita registro dinâmico de clientes, usa PKCE com S256, renova os tokens antes que expirem e os armazena criptografados. |
Como os funcionários veem as ferramentas MCP
Cada ferramenta de um servidor conectado vira 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 de qualquer outra ferramenta; uma regra do proprietário pode nomear uma ferramenta ou um servidor inteiro, como mcp__tickets__*. Veja Capacidades e aprovações.
Use o Nebo como servidor MCP
Um bot em execução responde a requisições MCP em POST /agent/mcp no endereço local dele, usando JSON-RPC e a versão 2025-03-26 do protocolo MCP. Ele oferece as ferramentas do bot e uma ferramenta nebo para enviar mensagens aos funcionários, ler o histórico e gerenciar sessões. Toda requisição precisa 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 com o bot em execução e fornece a chave sozinho.
nebo mcp serve --tools read_file,run_command nebo mcp serve --exclude-tools desktop
| Comando | Faz |
|---|---|
nebo mcp serve | Faz a ponte da entrada e da saída padrão com o bot em execução. |
--tools a,b | Oferece só as ferramentas listadas. |
--exclude-tools x | Oculta as ferramentas listadas. |
nebo mcp config --target <client> | Exibe o bloco de configuração de um cliente compatível. |
Um bot só escuta na própria máquina, a menos que seja iniciado com NEBO_ALLOW_REMOTE=true.
O servidor MCP da NeboAI
A própria NeboAI roda um servidor MCP em https://neboai.com/mcp para publicar na loja. Veja Publicação.