<!--
  Markdown representation of https://jotaid.com/zh/mcp
  Generated by scripts/gen-markdown-variants.mjs — do not edit by hand.
  Served from the canonical URL under `Accept: text/markdown`.
-->

# 让 AI agent 读你的笔记

> 在装了 Jotaid Pro 的 Mac 上，同一台 Mac 里的 AI agent 可以通过 **MCP**（Model Context Protocol，很多 agent 用来连接外部工具的通用标准）连接 Jotaid。它们读取你的笔记，以及 Jotaid 从这些笔记里建出的概念网络，于是你可以直接问 agent：这些笔记合起来说明了什么。

## 一览

- **只读**——agent 只能读取，不能新建、修改或删除任何内容
- **默认关闭**——你打开之前什么都不会监听，而且只在 Jotaid 打开期间运行
- **只在你自己的 Mac 上**——它只监听 `127.0.0.1`，你的网络和互联网上的任何东西都连不到它
- **仅限 Mac，需要 Pro**——iPhone 上没有 MCP 服务器

## agent 能做什么

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

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

## 能读什么，由你决定

- **可读项目**——agent 只能看到你勾选的项目，请求其他项目会被拒绝
- **访问令牌**——存放在 Mac 的钥匙串里；重新生成后，仍在用旧令牌的连接会立即断开
- **上次使用**——显示 agent 最近一次从服务器读取的时间

Jotaid 不上传任何东西。agent 读到的文字之后会怎样，取决于那个 agent 和它的服务商——和你分享给它的其他内容一样。

## 连接一个 agent

在 Mac 上的 Jotaid 里打开 **设置 → Agent**，打开 **允许 Agent 读取你的笔记**，再点 **复制接入配置**，把配置粘进你的 agent 的 MCP 设置。任何支持「通过 HTTP 连接 MCP 服务器并附带自定义请求头」的 agent 都可以连接。分步说明见指南：[连接 AI Agent（MCP）](https://docs.jotaid.com/zh/guide/mcp)。

## 它不做什么

- agent 不能写入：不能新建笔记、不能修改、不能删除
- 其他设备连不到它，也没有托管版本——Jotaid 没有公开的 HTTP API
- Jotaid 里没有能跨整个笔记库回答问题的对话功能；回答由你接入的 agent 完成

更多问答见[常见问题](https://jotaid.com/zh/faq)；Pro 包含哪些功能见[免费版与 Pro](https://docs.jotaid.com/zh/guide/pricing)。
