LobeHub 怎么接入自建 MCP 服务器?JSON 导入与手动配置方法
【免费下载链接】lobehub🤯 LobeHub is your Chief Agent Operator, organizing your agents into 7×24 operations by hiring, scheduling, and reporting on your entire AI team.项目地址: https://gitcode.com/GitHub_Trending/lo/lobehub
LobeHub 的 MCP 市场提供了大量现成集成,但如果你要接入的是私有 API、公司内部工具或自己搭建的 MCP 服务器,就需要走自定义 MCP通道,把任何兼容 MCP 协议的服务器直接添加到 LobeHub,而不经过市场。完成本文后,你可以把一个自建 MCP 服务器配置成工作区技能,验证连接、获取工具列表,并为指定助理启用它。两种配置方式都支持:粘贴 JSON 快速导入,或按连接类型手动填写字段。
从哪个入口打开「添加自定义技能」
三个入口都会打开同一个配置对话框,任选其一:
- 设置 → 技能— 点击技能商店,切换到自定义标签页,点击添加自定义技能;
- 助理设置— 打开任意助理的设置,进入技能,点击添加自定义技能;
- 对话输入框— 点击输入框上方的工具按钮,选择添加自定义技能。
方式一:导入 JSON 配置(推荐)
大多数 MCP 服务器的文档都会提供可直接复制的 JSON 配置,直接粘贴是最快的方式。
在「添加自定义技能」对话框中,点击表单顶部的导入 JSON 配置,会出现一个文本输入框。
粘贴完整的
mcpServers配置块或单个服务器的配置。STDIO 类型(本地进程)的文档示例如下:{ "mcpServers": { "my-server": { "command": "npx", "args": ["-y", "my-mcp-package"], "type": "stdio" } } }HTTP 类型的文档示例:
{ "mcpServers": { "my-api": { "url": "https://mcp.example.com/sse", "type": "http" } } }以上代码块均为源文档示例,实际使用时请替换为你自己的 MCP 服务器配置。
点击导入。LobeHub 会自动填入标识符、连接类型、URL 或命令等参数。核对自动填入的字段,需要时做调整,然后进入连接测试。
方式二:手动逐项填写
如果不方便使用 JSON 导入,可以选择连接类型后手动填写字段。
Streamable HTTP(远程服务器)
适用于云端托管的 API、SaaS 工具或任何可通过 HTTPS 访问的 MCP 服务器。Web 端和桌面端均可使用。
| 字段 | 说明 |
|---|---|
| MCP 名称 | 该技能的唯一标识符(仅限字母、数字、连字符) |
| Endpoint URL | MCP 服务器的完整 HTTPS 地址(例如https://mcp.example.com/sse) |
| 认证类型 | 无认证,或 API Key(以 Bearer Token 方式传递) |
| API Key | 选择 API Key 认证时必填 |
| HTTP 请求头 | 可选的额外请求头(展开「高级」选项设置) |
| 描述 | 可选,备注该 MCP 的用途 |
STDIO(本地进程)
适用于在本地作为进程运行的 MCP 服务器——命令行工具、脚本或本地安装的包。仅支持 LobeHub 桌面客户端,网页版不支持此连接类型。
| 字段 | 说明 |
|---|---|
| MCP 名称 | 该技能的唯一标识符 |
| 命令 | 要运行的可执行程序(例如npx、python、uv) |
| 参数 | 传递给命令的参数(例如-y @modelcontextprotocol/server-github) |
| 环境变量 | 注入到进程环境中的键值对(API Key、路径等) |
| 描述 | 可选,备注该 MCP 的用途 |
测试连接并确认结果
保存前,点击测试连接,验证 LobeHub 能否连接到你的 MCP 服务器并获取工具列表。测试成功的判断依据:右侧预览面板会显示该服务器提供的可用工具列表。
如果测试失败,文档给出两条排查方向:
- HTTP 类型:检查 URL 是否正确且可访问,以及 API Key 或请求头是否配置正确。
- STDIO 类型:确认命令已安装并存在于系统 PATH 中,可在终端运行
which npx(或相应命令)进行验证。
安装、编辑与管理
点击安装后,自定义 MCP 作为技能添加到工作区,并出现在设置 → 技能的自定义 MCP列表中。
后续编辑连接信息(例如 API Key 轮换、服务器 URL 变更):
- 进入设置 → 技能;
- 在自定义 MCP下找到该技能;
- 点击配置重新打开完整配置对话框;
- 修改参数,测试连接,点击更新。
如需删除,打开该技能的菜单并选择卸载。
为助理启用自定义 MCP
安装完成后该 MCP 在整个工作区可用,但每个助理需要单独开启:
- 打开助理设置;
- 进入技能;
- 找到该自定义 MCP 并开启;
- 该助理即可使用 MCP 服务器提供的所有工具。
技能的启用是按助理维度的——为某个助理开启技能,不会自动为其他助理开启。
限制与安全提示
- STDIO 连接类型仅在桌面客户端可用,Web 端只能使用 Streamable HTTP;
- 只安装来源可信的 MCP 服务器:恶意的 MCP 服务器可能会以你的身份执行意外操作。
更多背景可参考仓库中的 自定义 MCP 文档 和 技能管理文档。
【免费下载链接】lobehub🤯 LobeHub is your Chief Agent Operator, organizing your agents into 7×24 operations by hiring, scheduling, and reporting on your entire AI team.项目地址: https://gitcode.com/GitHub_Trending/lo/lobehub
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考