# 数据与安全

> 当前记忆 MCP 的 API Key、读写范围与撤销方式,以及规划中的录音类工具与 CLI 的安全设计。

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

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

## 当前记忆 MCP 的密钥与权限

记忆 MCP 使用工作台设置 → API Keys生成的 API Key,明文仅在创建时返回一次。需要有效的 iKho 账号、有效密钥与对应范围;请求还受账户状态与归属区域限制,只访问自己的数据。

| 工具 | 操作 | 所需范围 |
|---|---|---|
| `memory_search` | 按关键词检索自己的记忆块 | `memory.read` |
| `memory_get` | 读取自己的单条记忆 | `memory.read` |
| `memory_graph` | 读取自己的知识图谱 | `memory.read` |
| `memory_create` | 新建一条自己的记忆 | `memory.write` |

仅有 `memory.read` 的密钥不能新建记忆。当前四个工具不提供修改或删除记忆的操作。密钥可在同一设置页吊销;吊销后,后续请求不能再用这把密钥通过校验。接入地址与配置见[记忆 MCP 文档](/docs/mcp-cli/mcp/)。

工具结果会返回你配置的 AI 客户端;该客户端如何处理结果由其自身规则决定,上述账号与权限限制不代表对外部客户端的数据处理作出保证。

## 规划中的录音工具与 CLI

下文仅描述录音／逐字稿类 MCP 工具与 CLI 的规划设计,不适用于上面的当前记忆 MCP。

## 数据路径

以下是规划中的数据路径。开放后,通过 MCP 或 CLI 访问你的 iKho 数据时,请求全程走境内链路:

  
    1

    AI 客户端发起请求
你的 AI 客户端(桌面助手、编辑器或终端 agent)通过 MCP 协议发出工具调用。

  

  
    2

    境内 MCP 节点转发
请求经境内 MCP 节点校验授权后转发。节点只做转发,不落盘、不缓存你的内容数据。

  

  
    3

    iKho 服务返回数据
录音、逐字稿与智能笔记从 iKho 服务返回你的客户端。请求完成后,链路上不留存你的内容数据(录音、逐字稿与笔记),仅保留用于排障的请求日志。

  

按此设计,数据全程只在境内节点处理,不出境。

## 权限范围

按规划,录音／逐字稿类 MCP 工具与 CLI 使用的授权是只读的,且仅限你自己的账号:

| 操作 | 是否允许 |
|---|---|
| 读取你自己账号的录音、逐字稿与智能笔记 | 允许 |
| 写入或修改任何数据 | 不允许 |
| 删除录音、逐字稿或笔记 | 不允许 |
| 访问其他账号的数据 | 不允许 |

按此设计,即使 AI 客户端被诱导发出写入或删除类指令,服务端也不会执行:授权范围里不包含这些能力。

## 授权与撤销

  
- 规划中,在 AI 客户端里调用 `logout` 工具即可撤销授权,已签发的令牌立即失效。
  
- 规划中的录音类工具与 CLI 尚未提供自助授权控制台;其授权、撤销与状态排查方式以正式发布为准。当前记忆 MCP 的 API Key 管理见上文,相关问题可通过[联系我们](/docs/mcp-cli/contact/)反馈。

## 本地令牌

规划中,登录后的令牌只保存在本机的 `~/.ikho/` 目录,不写入任何其他位置;删除该目录等同于在本机登出,下次使用需要重新登录并完成授权。具体的目录与文件名以正式发布为准。