代理

连接代理。

只要你指定是哪个代理、它能读什么，Claude Code、Claude Desktop、Cursor 或你自己的脚本就能在你的 Mac 上通过 Kiku 读取你的通话。只需三步。

1打开“代理”
在 Kiku 的设置中，于“代理”下打开“允许代理读取你的通话”。“记忆”也需要开启。Kiku 运行时才会应答代理。
2连接代理
点按“连接代理”，给它起个名字，比如 Claude。选择它读什么（“笔记”或“笔记和引语”）、读哪些通话（“最近 90 天”“全部”或“从现在起”），以及能读多久（“30 天”“90 天”或“直到我撤销”）。
3复制它的密钥
Kiku 只显示一次代理的密钥，以 kk_ 开头，下面的配置行也已替你填好。现在就复制：Kiku 只保存密钥的指纹。

MCP

把 Kiku 加到你的代理。

Kiku 的 MCP 服务器就是 App 里的 kiku 助手程序。你的代理会自己启动它，密钥放在 KIKU_TOKEN 中。把你的密钥填在写着 kk_... 的地方。

Claude Code

在终端中，对所有项目生效：

claude mcp add --scope user kiku -e KIKU_TOKEN=kk_... -- /Applications/Kiku.app/Contents/Helpers/kiku mcp

然后在 Claude Code 中输入 /mcp，就能看到 kiku 和它的工具。

Claude Desktop

在 Claude 中，依次进入设置、开发者、编辑配置，会打开 claude_desktop_config.json。加入以下内容，然后重启 Claude：

{
  "mcpServers": {
    "kiku": {
      "command": "/Applications/Kiku.app/Contents/Helpers/kiku",
      "args": [
        "mcp"
      ],
      "env": {
        "KIKU_TOKEN": "kk_..."
      }
    }
  }
}

Cursor

对所有项目，把同样的配置块放进 ~/.cursor/mcp.json；只对一个项目，放进 .cursor/mcp.json（别把密钥提交到 git）。然后在 Cursor 设置的 MCP 中打开 kiku。

其他 MCP App

命令为 /Applications/Kiku.app/Contents/Helpers/kiku，参数为 mcp，密钥放在 KIKU_TOKEN 环境变量中。

然后问问看，比如：“关于发布日期，我们是怎么决定的？”或者“给今天上午的通话写一封跟进邮件。”

命令行

kiku api，给你的脚本用。

同一个助手程序也能在 shell 中应答，每个操作一个子命令。kiku api 列出所有子命令，kiku api list_meetings --help 解释其中一个。通过管道输出时（或加上 --json）打印 JSON，在终端中则打印表格。

export KIKU_TOKEN=kk_...
alias kiku=/Applications/Kiku.app/Contents/Helpers/kiku
kiku api list_meetings --since 7d
kiku api get_meeting 1791194400000-launch01 --json | jq .result.notes
kiku api brief --people "Léa Martin" --people "Tom Becker"

本地 API

留在你 Mac 上的 REST API。

这一切底下是一个 REST API，运行在 Kiku 文件夹里的一个套接字上，只有你能打开：没有网络端口，所以任何网页、任何其他用户都无法访问。它在 /v1/openapi.json 描述自己，也在 /v1/llms.txt 为读网页的代理提供说明。每个回答都会注明出自哪通电话。

curl --unix-socket "$HOME/Library/Application Support/Kiku/api.sock" \
  -H "Authorization: Bearer $KIKU_TOKEN" \
  "http://localhost/v1/meetings?since=7d"

它能回答什么

search: 按关键词搜索以前的通话，最相关的排在前面，并附上匹配的句子。
list_meetings: 通话列表，最新的在前，可按日期、人或 App 筛选。
get_meeting: 一通电话的笔记：摘要、决定、后续事项。
list_people: Kiku 从你的通话中认识的人。
get_person: 和某人的通话，以及双方各自的后续事项。
list_commitments: 还没完成的后续事项，你的或对方的。
list_decisions: 就某个主题做出的决定。
brief: 和这些人开会前的一份简报。

如果它没有回应

unauthorized: Kiku 不认识这把密钥：代理已被撤销，或者密钥输错了。
off: Kiku 设置中的“代理”处于关闭状态。
needs_app: Kiku 没有在运行。打开它即可。

由你掌控

始终属于你的。

默认关闭
在你打开“代理”之前，什么都不会应答；在网络上，永远什么都不会应答。
每个代理一把密钥
每把密钥都有各自能读的内容、起始时间和期限。可以把代理暂停一小时或到明天，也可以撤销其中一个，它会在下一个请求时停止。
访问记录
哪个代理在什么时候读了哪通电话。记录里从不包含笔记本身。
不给代理
可以标在一通电话上，也可以标在一个人身上，涵盖和他的所有通话。对代理来说，这些通话不存在。

Kiku 自己什么都不发送。你连接的代理为了回答你，通常会把读到的内容发给其模型所属的公司，而通话里的其他人并没有选择这样做。这台 Mac 上以你的身份运行的程序也能直接读取 Kiku 的文件夹：密钥只控制它们通过 Kiku 能拿到什么。

Claude Code 可以通过它的 shell 读取文件。要让它只读你允许的内容，请把以下内容加到 ~/.claude/settings.json：

"permissions": {
  "deny": [
    "Read(~/Library/Application Support/Kiku/**)",
    "Bash(*Application Support/Kiku*)"
  ]
}