NeboAI
NeboAI
开始使用

MCP

Model Context Protocol 是一种向 AI 系统提供工具的标准方式。Nebo 支持双向使用:机器人可以连接 MCP 服务器,让它的员工使用这些服务器的工具;其他 MCP 客户端也可以连接到机器人,使用 Nebo 的工具并与它的员工对话。

连接 MCP 服务器

所有者可以在 Nebo 设置的 MCP 页面添加服务器,或者用 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(带有可选 headers 的 URL)。
身份验证none、api_key 或 oauth。
OAuthNebo 会发现服务器的授权端点,在服务器支持动态客户端注册时自行注册,使用带 S256 的 PKCE,在令牌过期前刷新,并加密存储令牌。

员工如何看到 MCP 工具

已连接服务器的每个工具都会成为一个名为 mcp__<server>__<tool> 的工具,可供该机器人上的每位员工使用,并在员工需要时加载。MCP 工具与其他所有工具遵循相同的审批规则;所有者的规则可以指定单个工具或整个服务器,例如 mcp__tickets__*。参见能力与审批。

把 Nebo 当作 MCP 服务器使用

运行中的机器人会在其本地地址的 POST /agent/mcp 上响应 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 启动,否则机器人只在本机上监听。

NeboAI MCP 服务器

NeboAI 自己在 https://neboai.com/mcp 运行一个 MCP 服务器,用于发布到市场。参见发布。