NeboAI
NeboAI
Começar

MCP

O Model Context Protocol é uma forma padrão de disponibilizar ferramentas a sistemas de IA. O Nebo funciona com ele nos dois sentidos: um bot pode ligar-se a servidores MCP para que os seus funcionários usem as respetivas ferramentas, e outros clientes MCP podem ligar-se a um bot para usar as ferramentas do Nebo e falar com os seus funcionários.

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