---
description: "通过 MCP 让你 Mac 上的 AI agent 读取 Jotaid 笔记：只读、默认关闭、需要 Pro。打开开关、选择 agent 能读哪些项目，再把接入配置粘进你的 agent。"
---
<!--
  Markdown representation of https://docs.jotaid.com/zh/guide/mcp
  Generated by scripts/gen-markdown-variants.mjs — do not edit by hand.
  Served from the canonical URL under `Accept: text/markdown`.
-->

# 连接 AI Agent（MCP）

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

> **一览**
>
> - **仅限 Mac。** iPhone 上没有 MCP 服务器。
> - **需要 Pro。** 它是 [Jotaid Pro](https://docs.jotaid.com/zh/guide/pricing) 的一部分。
> - **只读。** agent 只能读取，不能新建、修改或删除任何内容。
> - **默认关闭。** 你打开之前，什么都不会监听。
> - **只在 Jotaid 打开期间运行。**

## agent 能做什么

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

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

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

## 打开开关

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

## 选择 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，或者把开关关掉再打开，然后重新点一次 **复制接入配置**，因为地址可能变了。

## 相关

- [免费版 vs Pro](https://docs.jotaid.com/zh/guide/pricing)
- [AI 配置](https://docs.jotaid.com/zh/guide/ai-setup)：Jotaid 内置的 AI 功能，使用你自己的服务商 Key
- [语义相关](https://docs.jotaid.com/zh/guide/semantic-relations)：在你设备上按意思查找是怎么工作的