全部产品 灵澜终端 CLI 产品帮助
打开文档目录

MCP 接入

灵澜终端 CLI 内置 MCP server,让支持 Model Context Protocol 的同机客户端发现并调用同一套 严格验证与授权工作区能力。当前只开放 stdio:客户端启动子进程,通过标准输入输出交换协议消息。

服务命令是:

lumenlan mcp serve --transport stdio

在支持 MCP 的桌面 Agent 或开发工具中,把 command 设置为 lumenlan,args 设置为 ["mcp", "serve", "--transport", "stdio"]。请先确保该客户端进程的 PATH 可以找到 lumenlan;如果不能,使用已安装二进制的绝对路径。

连接后可以发现 system.capabilitiesverification.run 以及 workspace 的 process、script、 adapter 工具。MCP 只是另一种调用接口:verification 仍只接受严格规格,workspace 仍要求有效 ExecutionGrant 和本机策略,workspace 输出也不能替代规范验收的必选证据。

网络与远程边界

CLI 默认不开独立网络监听,传入非 stdio transport 会被拒绝。不要为了远程访问而给它套一层任意 公网端口或通用命令转发。跨机器身份、机器选择、运输、批准、租约和撤销应由上层控制面负责,CLI 只在目标机器校验授权并执行本机动作。

排查连接

先在普通终端运行 lumenlan versionlumenlan capabilities。如果客户端报告 server 立即 退出,检查命令路径、参数拼写和 stderr;协议数据只走 stdout,任何额外包装脚本都不应向 stdout 打印横幅或日志。修改配置后彻底重启客户端,让它重新拉起 stdio 子进程。仍无法连接时查看 故障排查