--template mcp 将其打包为插件(参见插件格式)。
开始之前
你需要先安装 Node.js 和 npm。本示例使用 TypeScript SDK 的 1.x JavaScript API(固定为 1.29.0)。不同主版本的 SDK 可能使用不同的导入方式和配置方法;如需选择其他版本,请参考官方 MCP 服务器指南。编写一个最小的本地服务器
server.mjs:
console.error),因为 stdout 负责传输 MCP 协议消息。官方指南中详细说明了这一传输要求。
连接到 Enconvo
1
添加服务器
打开 设置 → MCP 服务器,点按 添加服务器。输入 服务器名称,例如
hello-mcp。2
设置启动方式
选择 STDIO。在 命令 中输入
node。在 参数 中输入 server.mjs 的绝对路径。如果 Enconvo 找不到 Node,请填写 Node 可执行文件的绝对路径。3
保存并检查
点按 保存。确认服务器已成功连接并暴露了
greet 工具。4
试一试
将它提供给你的智能体使用,并让它向“Ada”问好。预期的工具返回结果应为
Hello, Ada!。设计好用的工具
- 为每个工具提供清晰具体的操作与描述。
- 在工具入口处校验输入,并返回明确有用的错误信息。
- 将读取数据的操作与发送、删除等修改操作分开。
- 返回紧凑、易于智能体理解的结果。
- 将凭据存放在服务器对应的配置中,不要写入示例代码或日志里。
远程服务器与身份验证
对于远程服务器,请根据其配置说明选择 HTTP 或 SSE 传输方式,并在 Enconvo 表单中选择对应的选项(HTTP 或 SSE,而非 STDIO)。服务器 URL 必须是 MCP 端点地址,而不是普通网页地址。在启用其工具之前,请先完成所需的授权流程并确认连接成功。 远程传输、身份验证发现和会话行为取决于具体的服务器与协议版本。具体实现细节请以官方 SDK 和协议文档为准,不要自行编写 Enconvo 不会读取的auth 清单。
故障排除
如需将 Enconvo 自己的文档暴露给其他 AI 客户端,请使用内置的知识库 MCP 服务器,无需编写自定义服务器。
相关内容
MCP 服务器
在 Enconvo 中安装和管理 MCP 服务器
插件格式
将服务器打包为适用于 Enconvo、Codex 和 Claude Code 的插件