连接 AI Agent（MCP）

Jotaid 可以让你 Mac 上的 AI agent 读取你的笔记和概念网络，你就能直接问它：这些笔记合起来说明了什么。它通过 MCP（Model Context Protocol）实现，这是很多 AI agent 用来连接外部工具的通用标准。

一览

仅限 Mac。 iPhone 上没有 MCP 服务器。
需要 Pro。 它是 Jotaid Pro 的一部分。
只读。 agent 只能读取，不能新建、修改或删除任何内容。
默认关闭。 你打开之前，什么都不会监听。
只在 Jotaid 打开期间运行。

agent 能做什么

连接之后，agent 可以像你在 Jotaid 里一样浏览笔记：

浏览你的项目、笔记和标签
搜索笔记，可以按意思找，也可以找一个确切的词
阅读一篇笔记的全文，包括其中的 [[链接]]，以及它在项目和主题里的位置
查一个概念：按名字找（改名前的旧名也能找到），看哪些笔记提到了它、它和其他概念是什么关系
看整张网络：哪些概念总是一起出现、它们怎么分组
看一个概念随时间的变化：它什么时候出现、什么时候变多、什么时候沉寂
一步打开一个话题：和一个问题相关的笔记、这些笔记涉及的概念，以及这些概念连向哪里

正因为如此，「我的笔记合起来说明了什么」这个问题才有答案：agent 读的是你在图谱、矩阵和趋势视图里看到的同一张概念网络，再用文字说出来。

打开开关

打开 设置 → Agent，找到 MCP 连接。
打开 允许 Agent 读取你的笔记。
服务器运行后，知识库服务器 这一行会显示它的地址。

选择 agent 能读什么

可读项目 决定 agent 能看到哪些项目。agent 只能读取你在这里勾选的内容。

默认是全部，包括现有的每个项目，也包括以后新建的项目。
取消勾选某个项目，就把它排除在外。一旦取消，选择就变成「当前仍勾选的项目」这份明确清单，以后新建的项目不会再自动加入。
速记箱 和其他项目一样可以勾选。

请求清单之外的项目会被拒绝。

连接你的 agent

点击 复制接入配置（MCP 连接 标题旁边的复制图标）。它会复制一段完整的配置，包括服务器地址和你的访问令牌，直接粘进 agent 的 MCP 设置即可。格式如下：

json

{
  "mcpServers": {
    "jotaid": {
      "type": "http",
      "url": "http://127.0.0.1:<端口>/mcp",
      "headers": {
        "Authorization": "Bearer <你的令牌>"
      }
    }
  }
}

请始终粘贴复制出来的版本，不要照着这个示例手敲：不同的 Mac 上端口可能不同，复制接入配置会填入 Jotaid 实际使用的那个。

任何支持「通过 HTTP 连接 MCP 服务器、并能自定义请求头」的 agent 都可以连接。配置放在哪里取决于具体的 agent，请查看它的文档里关于「MCP servers」的部分。

一段现成的开场 prompt

在 Node 模式 → 趋势 里，复制一段给你的 agent 的 prompt 按钮会复制一段现成的请求：让 agent 读取当前项目的概念网络，说出一眼看不出来的东西。把它粘进已经连接好的 agent 即可。

保管好你的令牌

访问令牌 是进入服务器的唯一钥匙。拿到它的人就能读到你允许访问的项目，请像对待密码一样对待它。

它保存在你 Mac 的钥匙串里。
复制 token 只复制令牌本身，适用于需要单独填写令牌的 agent。
重新生成 会签发一个新令牌。旧令牌立即失效，仍在用它连接的 agent 会被断开，之后记得更新 agent 的配置。
上次使用 显示 agent 最近一次读取的时间。如果这个时间出乎你的意料，请重新生成令牌。

隐私

服务器只在你自己的 Mac 上监听（127.0.0.1），你所在网络里的其他设备和互联网都连不到它。
Jotaid 不上传任何内容。agent 读到的文字之后怎么处理，取决于那个 agent 和它的服务商，和你分享给它的其他内容一样。
按意思搜索时，用的是你在 设置 → Agent 里为语义索引选择的后端。默认的端侧后端不会让任何内容离开你的 Mac，也不产生费用；如果你选了远端后端，搜索文字会发给那个服务商，和在 app 内搜索时一样。

服务器状态

知识库服务器 旁边的图标说明当前状态：

状态	含义
运行中	正在监听，agent 可以连接
未监听	开关已打开，但服务器没能启动，通常是端口被其他 app 占用了
已关闭	开关是关着的
需要 Pro	这台 Mac 上还没有解锁 Pro
正在检查订阅…	Jotaid 还在确认你的 Pro 状态，比如离线状态下刚启动时

常见问题

agent 连不上。 确认 Jotaid 已打开，状态显示 运行中。如果你重新生成过令牌，要把新的接入配置粘进 agent。

agent 说什么都看不到，或者找不到某个项目。 检查 可读项目，那个项目可能没有勾选。

状态显示「未监听」。 可能有别的 app 占用了端口。退出那个 app，或者把开关关掉再打开，然后重新点一次 复制接入配置，因为地址可能变了。

连接 AI Agent（MCP） ​

agent 能做什么 ​

打开开关 ​

选择 agent 能读什么 ​

连接你的 agent ​

保管好你的令牌 ​

隐私 ​

服务器状态 ​

常见问题 ​

相关 ​