MCP 工具接入

MCP（Model Context Protocol，模型上下文协议）是一套开放标准，让海慧智擎能连接外部工具和数据源——比如企业内部系统、数据库、第三方服务。接好之后，这些外部能力就变成海慧智擎可以直接调用的"工具"，你照常说人话，它会在需要时自动用上。

举几个企业场景：把内部工单系统接进来，"查一下三月华东区的开口工单，汇总成表"；把财务数据库接进来，"拉本季度各事业部费用，做成对比图"；接上某个行业数据 API，"查这家供应商的工商风险，写进尽调备忘"。

MCP、技能、插件有什么区别

海慧智擎有三种扩展方式，分工不同，可以叠加使用：

扩展方式	解决什么	典型例子
技能 Skills	给它一套专业做法（怎么写合同、怎么排版、怎么 OCR）	出厂内置 23 项，含 skill-creator 自建技能
插件 Plugin	一键打包分发技能、命令、MCP 配置，团队统一安装	通过 /plugin 接入插件市场
MCP	接通外部工具和数据源，把外部系统变成可调用的工具	内部工单系统、数据库、第三方 API

简单说：技能教它"怎么做"，MCP 给它"动手的接口和数据"，插件把前两者成套发给团队。三者互不冲突——一个插件里就可以同时带技能和 MCP 配置。

扩展能力总览

• 用 skill-creator 把贵司业务知识沉淀为专属技能；
• 用 /plugin 接入插件市场与技能（市场地址 git.hi-engine.cn）；
• 用本页讲的 MCP 接入外部工具与数据源。

更多扩展方式见常见问题 · 怎么扩展它的能力。

三种连接方式

海慧智擎支持三种 MCP 传输方式，按对方服务器的形态选：

传输方式	适用场景	标识
stdio	本机以子进程方式运行的 MCP 服务（默认）	-t stdio
http	远端 HTTP 接口的 MCP 服务	-t http
sse	远端 SSE（Server-Sent Events）接口的 MCP 服务	-t sse

不指定 -t 时默认按 stdio（本机子进程）处理。

添加一个 MCP 服务

用 hi mcp add 命令添加。基本格式：

hi mcp add <名称> <命令或URL> [参数...]

HTTP 远端服务

# 接一个远端 HTTP MCP 服务，名字叫 erp
hi mcp add --transport http erp https://mcp.内网域名/api/mcp

带鉴权头

# 远端服务需要 Token 时，用 --header 传鉴权头
hi mcp add --transport http erp https://mcp.内网域名/api/mcp \
  --header "Authorization: Bearer 你的Token"

本机 stdio 服务

# 本机子进程方式，命令前用 -- 分隔，后面是要执行的命令
hi mcp add 内部工具 -- npx 内部工具-mcp-server

带环境变量

# 用 -e 给本机服务传环境变量（如密钥）
hi mcp add -e API_KEY=xxx 行情 -- npx 行情-mcp-server

常用选项：

选项	作用
-t, --transport <stdio|sse|http>	指定传输方式，默认 stdio
-s, --scope <local|user|project>	配置作用范围，默认 local（见下文）
-e, --env KEY=value	给 stdio 服务设置环境变量，可重复
-H, --header "名: 值"	给 http/sse 服务设置请求头，可重复

远端服务别漏写 --transport

如果 <命令或URL> 看起来是个网址（http://、https:// 开头），但你没写 --transport，它会被当成本机命令处理并给出提示。接远端服务时务必带上 --transport http 或 --transport sse。

配置作用范围（scope）

--scope 决定这个 MCP 配置在哪里生效、是否随项目共享：

scope	含义	存放位置
local（默认）	只在当前项目对你自己生效，不共享	写入 ~/.hi（按项目区分）
user	对你所有项目生效	写入 ~/.hi
project	随项目共享给团队所有人	写入项目目录下的 .mcp.json

团队要共用同一套 MCP 接入时，用 --scope project——配置落在项目根目录的 .mcp.json，提交进版本库后，同事拉到代码即自动带上。

# 把一个 MCP 服务加进项目，团队共享
hi mcp add --scope project --transport http erp https://mcp.内网域名/api/mcp

管理已接入的服务

进入交互界面后，用 /mcp 打开 MCP 设置面板，查看每个服务的连接状态、可用工具，以及完成需要授权的服务的登录。

常用子命令：

命令	作用
/mcp	打开 MCP 设置面板
/mcp reconnect <名称>	重连指定服务（连接异常时用）
/mcp enable <名称>	启用某个服务（all 表示全部）
/mcp disable <名称>	停用某个服务（all 表示全部）

接好的 MCP 服务，它的工具会自动进入海慧智擎的可用工具集——你不用记工具名，正常用自然语言下任务即可，需要时它会自己调用。

用 @ 引用 MCP 资源

有些 MCP 服务会暴露资源（文档、记录、数据集）。在输入框里敲 @，可以从这些资源里挑选并引用进当前对话，让它基于这份数据干活。

数据与安全须知

第三方 MCP 服务是外部连接

海慧智擎自身数据不出域（模型走企业自有网关、OCR 在本机）。但 MCP 是连接外部系统的通道——当你接入一个远端 MCP 服务并调用它时，相关请求会发往该服务。接入前请确认：

• 只接可信来源的 MCP 服务，优先用企业内网部署的服务；
• 远端服务的鉴权 Token、密钥通过 --header、-e 传入，不要硬编码进共享的 .mcp.json；
• --scope project 的 .mcp.json 会随版本库共享，不要把密钥写进去，密钥用 local/user 范围或环境变量管理。

相关

• 概览 —— 界面、对话方式与常用操作
• 斜杠命令 —— /mcp、/plugin 等命令速查
• 常见问题 —— 数据安全、配置文件、能力扩展