NeboAI
NeboAI
Начать

MCP

Model Context Protocol — стандартный способ предоставлять инструменты ИИ-системам. Nebo работает с ним в обе стороны: бот может подключаться к MCP-серверам, чтобы его сотрудники пользовались их инструментами, а другие MCP-клиенты могут подключаться к боту, чтобы использовать инструменты Nebo и общаться с его сотрудниками.

Подключение MCP-сервера

Владелец добавляет серверы на странице MCP в настройках Nebo или устанавливает коннектор из маркетплейса по коду CONN-. Nebo также принимает стандартный блок конфигурации, который публикуют MCP-серверы, с ключом mcpServers или 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>" }
    }
  }
}
ПараметрЗначения
Транспортstdio (локальная команда с command, args, env), http или sse (URL с необязательными headers).
Аутентификацияnone, api_key или oauth.
OAuthNebo находит эндпоинты авторизации сервера, регистрируется сам, если сервер поддерживает динамическую регистрацию клиентов, использует PKCE с S256, обновляет токены до истечения срока и хранит их в зашифрованном виде.

Как сотрудники видят инструменты MCP

Каждый инструмент подключённого сервера становится инструментом с именем mcp__<server>__<tool>, доступным каждому сотруднику в боте и загружаемым, когда он нужен сотруднику. Для инструментов MCP действуют те же одобрения, что и для любых других инструментов; правило владельца может указывать один инструмент или целый сервер, например mcp__tickets__*. См. Возможности и одобрения.

Nebo как MCP-сервер

Работающий бот отвечает на запросы MCP по POST /agent/mcp на своём локальном адресе, используя JSON-RPC и версию протокола MCP 2025-03-26. Он предоставляет инструменты бота и инструмент nebo для отправки сообщений сотрудникам, чтения истории и управления сеансами. Каждому запросу нужны учётные данные: ключ установки бота, который берётся из NEBO_MCP_API_KEY или из .install-key в папке данных бота.

Для клиентов, которые запускают MCP-серверы как локальные команды, nebo mcp serve запускает мост через стандартный ввод и вывод к работающему боту и сам подставляет ключ.

nebo mcp serve --tools read_file,run_command
nebo mcp serve --exclude-tools desktop
КомандаЧто делает
nebo mcp serveСвязывает стандартный ввод и вывод с работающим ботом.
--tools a,bПредоставляет только перечисленные инструменты.
--exclude-tools xСкрывает перечисленные инструменты.
nebo mcp config --target <client>Выводит блок конфигурации для поддерживаемого клиента.

Бот слушает только на своём компьютере, если он не запущен с NEBO_ALLOW_REMOTE=true.

MCP-сервер NeboAI

Сам NeboAI запускает MCP-сервер по адресу https://neboai.com/mcp для публикации в маркетплейсе. См. Публикация.