NeboAI
NeboAI
Começar

MCP

O Model Context Protocol é uma forma padrão de oferecer ferramentas a sistemas de IA. O Nebo trabalha com ele nas duas direções: um bot pode se conectar a servidores MCP para que seus funcionários usem as ferramentas deles, e outros clientes MCP podem se conectar a um bot para usar as ferramentas do Nebo e conversar com os funcionários dele.

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çãoValores
Transportestdio (um comando local com command, args, env), http ou sse (uma URL com headers opcionais).
Autenticaçãonone, api_key ou oauth.
OAuthO 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
ComandoFaz
nebo mcp serveFaz a ponte da entrada e da saída padrão com o bot em execução.
--tools a,bOferece só as ferramentas listadas.
--exclude-tools xOculta 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.