MCP 与 CLI

iKho MCP

现在可用:把 iKho 的记忆接进兼容 MCP 的 AI 客户端(记忆检索与图谱)。录音与逐字稿类工具、一键安装器与独立域名规划中。

本 Tab 的一键安装器、命令行工具与录音／逐字稿类工具尚未开放,相关章节描述的是规划中的接口形态,不代表当前可用的功能。正式开放时间、安装方式与包名将通过官网公告与开通邮件告知。

现在已经可用的是:记忆 MCP(填地址加密钥即可接入,见该页第一节),以及iKho Embedded 的服务端接口(认证、文件上传、转写)。

现在就能用:记忆 MCP

虽然一键安装器与录音类工具还在规划中,iKho 已经有一个可用的 MCP 服务端:它把你在 iKho 里的记忆(记忆块与知识图谱)暴露给任何支持远程 MCP 的客户端,例如 Claude Desktop、Cursor。不需要安装任何包,填地址加密钥即可。

在 iKho 里生成 API Key

打开 iKho 工作台的设置 → API Keys,新建一个密钥(形如 ikho_ 开头)。密钥明文只显示一次,请当场保存。按需选择读或读写范围。

在客户端里添加远程 MCP 服务

服务地址填 https://ikho.cn/api/v1/mcp,鉴权用 HTTP 头 Authorization: Bearer <你的 ikho_ 密钥>。传输为 Streamable HTTP,无需本机常驻进程。

在对话里直接用

连接成功后,客户端会看到下表四个工具,可以直接让它「搜一下我关于某个主题的记忆」「把这条记进 iKho」。

工具	作用	所需范围
`memory_search`	按关键词检索你的记忆块	`memory.read`
`memory_get`	按标识取单条记忆的详情	`memory.read`
`memory_graph`	取知识图谱的节点与关系	`memory.read`
`memory_create`	写入一条新的记忆	`memory.write`

所有工具都按密钥所属账号强制过滤,只能读写你自己的数据。密钥可在同一页面随时吊销;吊销后立即失效。

这一节描述的是当前已上线的能力,与本页其余「规划中」的内容(一键安装器、命令行工具、录音与逐字稿类工具、独立域名)不是同一件事,请勿混淆。

计划支持的客户端

正式开放后,安装器计划自动探测本机的 AI 客户端,写入 MCP 配置并引导完成登录。下表是规划中的支持范围。

客户端	计划自动配置	配置后重启方式
Claude Desktop	是	⌘Q 退出后重新打开
Claude Code	是	退出后新开一个 `claude` 会话
Cursor	是	按客户端提示重新加载
Windsurf	是	按客户端提示重新加载
VS Code	是	按客户端提示重新加载
任何 MCP 兼容客户端	手动配置	见下方「手动配置」与「远程接入」

前置条件

Node.js 20 或更高版本
一个 iKho 账号(开放后的开通方式以开通邮件为准,见联系我们)

安装

当前没有可安装的 MCP 服务端,本文档也不提供可执行的安装命令。安装命令、包名与安装源将随开通邮件提供,请以邮件中的说明为准。

请不要凭猜测安装任何名称相近的第三方包。iKho 尚未发布 MCP 相关的公开包,任何声称是 iKho MCP 的现有安装源都与我们无关。

手动配置

规划中的配置形态如下。启动命令与参数在正式开放时由开通邮件给出,下面的占位不可直接使用:

json

{
  "mcpServers": {
    "ikho": {
      "command": "<开通邮件中提供的启动命令>",
      "args": ["<开通邮件中提供的参数>"]
    }
  }
}

远程接入(HTTP 客户端)

规划中的远程接入地址尚未开放,现在还没有可填写的地址。开放后,网页端等基于 HTTP 的客户端无需本地安装,在客户端的「自定义连接器 / Remote MCP」设置里填入我们公布的地址并完成授权即可;具体地址通过官网公告与开通邮件告知。

远程接入开放后,录音数据的处理只在境内节点进行,请求完成后不留存内容数据(仅保留用于排障的请求日志),数据不出境。

规划中的使用方式

以下为开放后的预期交互形态。先在 AI 客户端里登录:

登录 iKho

浏览器会打开 iKho 授权页,点「授权」后回到客户端即完成登录。随后可以尝试:

列出我最近的录音

把周一例会整理成跟进邮件

工具

规划中的工具集如下,名称与参数以正式发布为准:

工具	说明
`login`	打开浏览器完成 OAuth 登录
`logout`	退出登录并吊销授权
`get_current_user`	显示当前登录的账号信息
`list_files`	列出你的录音,支持可选筛选
`get_file`	返回单条录音的完整详情
`get_note`	返回 iKho 智能引擎生成的摘要、待办事项与关键议题
`get_transcript`	返回带时间戳与说话人标注的完整逐字稿

用 list_files 筛选录音

参数	说明
`query`	对录音名称做大小写不敏感的关键词匹配
`date_from`	起始日期,格式 `YYYY-MM-DD`
`date_to`	结束日期,格式 `YYYY-MM-DD`
`page` / `page_size`	分页参数(设置了筛选条件时忽略)

数据字段参考

以下字段为拟定契约,以正式发布为准。

list_files 与 get_file 返回的字段

字段	类型	说明
`id`	string	录音的唯一标识
`name`	string	录音名称
`created_at`	string	创建时间(ISO 8601)
`start_at`	string	录音开始时间(ISO 8601)
`duration`	number	时长(毫秒)
`serial_number`	string	设备序列号

仅 get_file 返回的字段

字段	类型	说明
`presigned_url`	string	临时音频下载地址(24 小时内有效)
`source_list`	array	带时间戳与说话人标注的逐字稿分段
`note_list`	array	iKho 智能引擎生成的笔记(Markdown)

技能

技能是预置好的操作说明,帮助 AI 客户端完成常见的 iKho 工作流。规划中的技能随安装器一并加载,无需额外配置;下表的技能名与触发语句同样以正式发布为准。

技能	触发语句示例
`ikho-browse`	「列出我的录音」「显示最近的文件」
`ikho-find`	「找一下周一的销售拜访」「上周三的门诊随访」
`ikho-read`	「显示这段逐字稿」「把这条录音总结一下」
`ikho-digest`	「本周工作周报」「这周我开了哪些会」
`ikho-followup`	「起草一封跟进邮件」「列出待办事项」

升级与卸载

尚未开放,因此没有可升级或可卸载的组件。正式发布后的升级与卸载方式随开通邮件与文档一并提供。

故障排查

MCP 尚未开放,现阶段没有可复现的故障场景,本页也不列出排查命令。正式开放后,故障排查指引随文档一并提供;接入过程中的问题可通过联系我们反馈。

这一页有帮助吗?