MCP 集成

Keenkind 可以连接实现 Model Context Protocol 的本地或远程 Server。接入前，请先让 Server 在其官方客户端或测试工具中正常启动。

选择连接方式

方式	适用场景	需要提供
stdio	本机程序、开发中的 Server	命令、参数、环境变量
HTTP	已部署的共享服务	URL、认证信息

stdio 示例

在 设置 > 扩展 > MCP > 手动添加 中填写：

名称：My MCP
方式：stdio
命令：my-mcp-server
参数：--workspace C:/projects/demo

命令必须能在当前系统中启动。需要密钥时使用环境变量字段，不要把密钥放在参数、名称或描述中。

HTTP 示例

名称：Team MCP
方式：HTTP
URL：https://mcp.example.com

远程服务应使用 HTTPS，并采用最小权限账户。共享服务的管理员需要自行管理访问控制、限流和审计。

工具设计

为了让模型稳定使用 MCP 工具：

• 工具名称简短且含义明确；
• 描述说明使用条件和结果，不写内部实现；
• 输入 Schema 尽量小，字段名保持稳定；
• 对必填、枚举和格式添加清楚说明；
• 返回结构化结果，并提供可读的错误信息；
• 修改性操作应清楚表达影响范围。

不要把多个无关操作塞入一个工具，也不要要求模型拼接难以验证的命令字符串。

验证

1. 添加并启用 Server。
2. 确认详情页能够列出工具。
3. 在 请求审批 模式调用一个只读工具。
4. 验证成功结果和错误结果都能被模型理解。
5. 测试取消、重启和缺少凭据的情况。
6. 最后再测试写入或外部操作。

连接失败时，先在终端单独验证 Server，再检查 Keenkind 中的命令、URL、环境变量和平台支持。