# iKho MCP

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

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

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

## 现在就能用:记忆 MCP

虽然一键安装器与录音类工具还在规划中,iKho 已经有一个可用的记忆 MCP 服务端:使用有效的 iKho 账号与有效的 API Key,可按密钥范围通过支持 Streamable HTTP 与 Bearer 鉴权的客户端访问自己的记忆块与知识图谱。不需要安装本地包,填地址加密钥即可;接入还受账户状态与归属区域限制。

  
    1

    在 iKho 里生成 API Key
打开 iKho 工作台的设置 → API Keys,新建一个密钥(形如 `ikho_` 开头)。密钥明文只显示一次,请当场保存。按需选择 `memory.read` 与 `memory.write`,并非每把密钥都具备这两种范围。

  

  
    2

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

  

  
    3

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

  

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

所有工具都按密钥所属账号与归属区域过滤,只能在所需范围内访问自己的数据。密钥可在同一页面吊销;吊销后,后续请求不能再用这把密钥通过校验。仅有 `memory.read` 的密钥不能新建记忆。

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

## 计划支持的客户端

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

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

## 规划中的安装器前置条件

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

## 规划中的一键安装器

当前尚未提供本地一键安装器,本文档也不提供可执行的安装命令。安装命令、包名与安装源将随开通邮件提供,请以邮件中的说明为准。当前记忆 MCP 使用上文的远程服务,无需本地安装。

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

## 手动配置

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

  json
    
  

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

## 规划中的录音工具远程接入

录音／逐字稿类工具的远程接入尚未开放,具体地址与授权方式通过官网公告与开通邮件告知。上文的 `https://ikho.cn/api/v1/mcp` 是当前记忆 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` | 「起草一封跟进邮件」「列出待办事项」 |

## 升级与卸载

本地一键安装器与 CLI 尚未开放,因此没有对应的可升级或可卸载组件。正式发布后的方式随开通邮件与文档一并提供。当前记忆 MCP 的远程接入不需要安装本地包。

## 故障排查

当前记忆 MCP 接入失败时,请先核对服务地址、Bearer 鉴权头、密钥有效性与工具所需的 `memory.read` 或 `memory.write` 范围。一键安装器、CLI 与录音／逐字稿类工具的排查指引在这些组件开放后提供。接入问题可通过[联系我们](/docs/mcp-cli/contact/)反馈,请勿发送密钥明文。