别从零写,先看有没有现成的
接 MCP 的第一步不是「自己写 Server」,而是先看这个服务有没有现成的适配器。常用服务大多已有现成的 MCP Server,直接用,省时省力。
这一节讲「连接外部服务」的完整流程,并把它用在 mcp-hub 的第一个真实接入上。
接入的四个步骤
1. 明确要接什么
先想清楚:要接哪个服务?要它的什么能力?
例:接数据库 MySQL,让 AI 能查业务表。
对 mcp-hub:先接哪个?建议选团队里最常被问到、且最适合只读的服务——比如订单库。因为只读服务风险低,适合做第一个接入练手。
2. 找/搭建 MCP Server
- 有现成:找到对应的 MCP Server,直接用
- 没有:才考虑自己写(下一节)
3. 配置并授权
把 MCP Server 接到 Claude Code:
- 配置 Server 的地址/命令
- 提供认证信息(账号、密钥)
- 声明它能暴露哪些工具
对 mcp-hub:这里有一个关键动作——把这份配置登记进 mcp-hub 的服务清单。这样团队以后不是各自配置,而是统一从 mcp-hub 拿。
4. 用自然语言调用
配置好后,直接对 Claude Code 说:
用 MCP 查一下 users 表,最近 7 天新增了多少用户
它会通过 MCP Server 调数据库,返回真实数据。
一个「查数据库」的完整示例
假设你有一个现成的 MySQL MCP Server。配置后:
你:帮我在 orders 表里查今天成交总额。
Claude:已连接数据库,查询 `SELECT SUM(amount) FROM orders WHERE date = CURDATE()`,结果 ¥12,350。
它不只是「建议」,而是真的查了,给你的是真实数字。
这个示例,就是 mcp-hub 接入成功后,你团队成员每天会遇到的日常:一句人话,拿到真实业务数据。mcp-hub 的价值在这一刻兑现。
可复制:给 mcp-hub 接一个数据库的配置片段
下面是一份可照抄的接入脚本思路,帮你把「接入一个服务」登记进 mcp-hub:
# 1. 找到可用的 MCP Server(假设是数据库的现成适配器)
# 2. 在 mcp-hub 服务清单里登记
/mcp-hub add db-mysql \
--name orders \
--command "mcp-server-mysql" \
--env "DB_HOST=10.0.0.5 DB_USER=reader"
# 3. 校验配置是否可用
/mcp-hub validate orders
# 4. 让 Claude Code 去查
# 「用 orders 服务查一下今天的成交总额」
注意:--env 里的凭据走环境变量,不要写明文密钥。这是接入外部服务时的安全红线。
配置时的注意点
- 认证要安全:密钥别硬编码进明文文件,用环境变量
- 权限要收敛:给 Server 最小必要权限,别给全库读写
- 先小额度试:接上一个服务先小规模验证,再正式用
对 mcp-hub:这三个注意点直接写进 mcp-hub 的校验逻辑。/mcp-hub add 时,就要检查「有没有把密钥硬编码」「这个服务暴露的工具是不是太多」——让安全在接入时就卡住,而不是事后救火。
什么时候需要自己写 Server
接外部服务时先判断:
- 有现成 Server → 直接用 ✅
- 没有、或现成的不合适 → 自己写(下一节)
别一上来就重造轮子,先用现成的,确实没有再说。
对 mcp-hub:第一版接入,尽量都选「有现成 Server」的服务,先把流程跑顺。等 mcp-hub 稳定了,再碰那些「得自己写」的。
落地练习:给 mcp-hub 接第一个真实服务
这一节动手,给 mcp-hub 接上一个能干活的服务。
跟着这三步走:
- 选一个团队里适合「只读」的服务(比如订单库),先查有没有现成 MCP Server
- 按上面四个步骤接进来,并把配置登记进 mcp-hub 的服务清单
- 用一句自然语言让 Claude Code 通过它查一个真实数据
你会怎么判断做对了?——Claude Code 通过 mcp-hub 里的这个 Server 返回了真实业务数据(不是编的),并且凭据走的是环境变量、权限是只读,就算过关。
卡住了怎么办? 找不到现成 Server?那就等下一节学自己写,先在本节把「登记清单 + 配置安全」练会。连接失败?先检查地址可达性、再查认证,把错误信息丢给 Claude Code 一起排查。
常见坑:接了服务却不知道「接上了什么」
一个很常见的坑:照着教程把服务接上了,也查到了数据,但完全没记录这个 Server 暴露了哪些工具、用了什么权限。过两周要复用、要审计时,一脸懵。
接入时就把「这个 Server 暴露了哪些工具、什么权限、凭据存哪」写进 mcp-hub 的服务清单。接入 = 接入 + 记录,缺一不可。 不然 mcp-hub 只是堆了一堆「能连但说不清」的服务,出了安全问题都无从查起。
小结
- 接入四步:明确服务 → 找/搭 Server → 配置授权 → 自然语言调用
- 优先用现成 MCP Server,别重造轮子
- 认证安全、权限收敛、先小额度试
- 没有现成的才自己写
- mcp-hub 的第一次真实接入,让「骨架」有了血肉
下一节,学怎么构建自定义 MCP Server。