MCP 服务器
通过 MCP 把外部工具连接到 EvoX。可以启动本机工具进程，也可以连接远程服务；选择哪种方式取决于服务器提供方的说明。
选择连接方式
选择服务器连接方式
启动本地工具进程
命令和脚本需要先安装在本机。以下仅展示字段如何分工。
- 命令
- node
- 参数
- /absolute/path/to/server.mjs
- 环境变量
- SERVICE_TOKEN=YOUR_TOKEN
| 连接方式 | 需要准备 |
|---|---|
| stdio | 本地可执行命令、参数、运行依赖及环境变量 |
| streamable-http | 服务提供方给出的 MCP 地址，必要时提供请求头 |
网页首页通常不是 MCP 服务地址。本地命令也不能只写一个未安装的包名；应按提供方说明准备运行环境。
添加本地服务器
- 在扩展管理中添加 MCP 服务器。
- 填写便于识别的名称，连接类型选择 stdio。
- 填写启动命令，将启动参数放到参数字段。
- 按服务要求填写环境变量，保存并测试。
- 检查工具列表，再执行一个只读任务。
例如，提供方要求运行一个本地脚本时，命令可以是 node，参数可以是已安装脚本的绝对路径。具体命令必须来自该服务器的可信安装说明。
添加远程服务器
- 选择 streamable-http。
- 填写服务器提供的完整 MCP 地址。
- 如需请求头，按字段提示逐行填写
Header=value。 - 完成该服务要求的认证，保存并测试连接。
- 核对当前账号能够访问的数据范围。
不要把示例中的占位符当作真实凭证，也不要向陌生地址发送已有账号密钥。
字段说明
| 字段 | 用途 |
|---|---|
| 名称 | 区分连接；已有连接和市场引导安装使用固定名称，编辑时不能改名 |
| 命令与参数 | 启动本地工具进程 |
| URL | 远程 MCP 服务端点 |
| 环境变量 | 为进程提供服务器需要的配置 |
| 请求头 | 远程服务需要的认证或额外信息 |
| 停用 | 保留配置，但不加载该连接 |
一个示例环境变量条目是 SERVICE_TOKEN=YOUR_TOKEN，仅在提供方明确要求这个变量时使用。不要把密码放在连接名称里。
连接成功之后
查看工具名称和描述，确认确实提供了任务所需能力。先读取一项允许访问的数据，再考虑创建、修改或发送。
/mcp 可打开统一状态面板。已连接不代表所有工具都得到授权，也不代表服务端账号能访问所有文件。
常见问题
| 现象 | 检查顺序 |
|---|---|
| 本地进程无法启动 | 命令是否存在、参数路径、运行依赖、环境变量 |
| 远程地址不可达 | URL、网络与代理、服务器状态 |
| 认证失败 | 当前账号、凭证和服务要求的认证方式 |
| 没有预期工具 | 工具列表、服务器版本、账号权限 |
| 读取成功但写入失败 | 是否有写工具、写权限，以及任务确认范围 |