news 2026/9/9 21:24:17

LobeHub 怎么接入自建 MCP 服务器?JSON 导入与手动配置方法

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
LobeHub 怎么接入自建 MCP 服务器?JSON 导入与手动配置方法

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 配置,直接粘贴是最快的方式。

  1. 在「添加自定义技能」对话框中,点击表单顶部的导入 JSON 配置,会出现一个文本输入框。

  2. 粘贴完整的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 服务器配置。

  3. 点击导入。LobeHub 会自动填入标识符、连接类型、URL 或命令等参数。核对自动填入的字段,需要时做调整,然后进入连接测试。

方式二:手动逐项填写

如果不方便使用 JSON 导入,可以选择连接类型后手动填写字段。

Streamable HTTP(远程服务器)

适用于云端托管的 API、SaaS 工具或任何可通过 HTTPS 访问的 MCP 服务器。Web 端和桌面端均可使用。

字段说明
MCP 名称该技能的唯一标识符(仅限字母、数字、连字符)
Endpoint URLMCP 服务器的完整 HTTPS 地址(例如https://mcp.example.com/sse
认证类型无认证,或 API Key(以 Bearer Token 方式传递)
API Key选择 API Key 认证时必填
HTTP 请求头可选的额外请求头(展开「高级」选项设置)
描述可选,备注该 MCP 的用途

STDIO(本地进程)

适用于在本地作为进程运行的 MCP 服务器——命令行工具、脚本或本地安装的包。仅支持 LobeHub 桌面客户端,网页版不支持此连接类型。

字段说明
MCP 名称该技能的唯一标识符
命令要运行的可执行程序(例如npxpythonuv
参数传递给命令的参数(例如-y @modelcontextprotocol/server-github
环境变量注入到进程环境中的键值对(API Key、路径等)
描述可选,备注该 MCP 的用途

测试连接并确认结果

保存前,点击测试连接,验证 LobeHub 能否连接到你的 MCP 服务器并获取工具列表。测试成功的判断依据:右侧预览面板会显示该服务器提供的可用工具列表。

如果测试失败,文档给出两条排查方向:

  • HTTP 类型:检查 URL 是否正确且可访问,以及 API Key 或请求头是否配置正确。
  • STDIO 类型:确认命令已安装并存在于系统 PATH 中,可在终端运行which npx(或相应命令)进行验证。

安装、编辑与管理

点击安装后,自定义 MCP 作为技能添加到工作区,并出现在设置 → 技能自定义 MCP列表中。

后续编辑连接信息(例如 API Key 轮换、服务器 URL 变更):

  1. 进入设置 → 技能
  2. 自定义 MCP下找到该技能;
  3. 点击配置重新打开完整配置对话框;
  4. 修改参数,测试连接,点击更新

如需删除,打开该技能的菜单并选择卸载

为助理启用自定义 MCP

安装完成后该 MCP 在整个工作区可用,但每个助理需要单独开启:

  1. 打开助理设置;
  2. 进入技能
  3. 找到该自定义 MCP 并开启;
  4. 该助理即可使用 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),仅供参考

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/9/9 21:22:51

Android跌倒检测Demo深度解析:从传感器到阈值调优

简介:这是一款面向Android平台的跌倒检测识别Demo,主要面向移动端AI应用开发者、安防及智慧养老领域的技术人员,用于快速验证和应用实时摔倒识别功能。Demo基于YOLOv5检测模型,完整呈现了从模型部署到Android应用构建的工程流程&a…

作者头像 李华
网站建设 2026/9/9 21:22:20

戴森集色体验:从V8到V15,8款配色真实使用与成本分析

把戴森买成一个色卡是什么体验?柜子里那排五颜六色的吸尘器和吹风机摆在一起,说实话第一次看还挺壮观的。关注戴森比较久的人都知道,这个牌子不同型号、不同渠道、不同时间段的配色其实很杂,常规色、礼遇限定色、区域专属色都有&a…

作者头像 李华
网站建设 2026/9/9 21:22:15

JSP+Servlet+JDBC实战:手把手搭建网上购物商城系统

简介:面向Java Web零基础或入门阶段学习者,这份网上购物商城系统完整演示了JSPServletJDBC的原生开发流程,覆盖用户登录、商品展示、购物车管理等核心模块,前端引入layui优化交互,并配有SQL脚本可直接搭建数据库。资源…

作者头像 李华
网站建设 2026/9/9 21:22:10

Vue3核心知识点与工程化实践总结

2026年3月底,我把做Vue3项目过程中反复用到、踩过坑、也在面试中被问过无数次的知识点重新过了一遍,整理成这篇总结。先说清定位:它不是按官方文档目录排下来的教程,而是偏向“开发里高频出现、面试里值得讲清楚、从Vue2迁移时容易…

作者头像 李华
网站建设 2026/9/9 21:22:05

线性代数如何解构Transformer嵌入空间

1. 这不是数学课,是打开大模型黑箱的第一把钥匙你有没有过这种体验:翻遍《The Illustrated Transformer》,图都看懂了,但一到“Embedding层输出的向量为什么能表征语义”,就卡住;调试BERT微调脚本时&#x…

作者头像 李华