Hjarni

Hjarni

为你、ChatGPT 和 Claude 提供的 Markdown 笔记。
官方托管的 MCP 服务，用于管理你阅读和编辑的同一批笔记。

网站 · 文档 · 博客

---

功能介绍

Hjarni 是一款 Markdown 笔记应用，提供位于 https://hjarni.com/mcp 的官方托管 MCP 服务。你可以在浏览器或 Hjarni 的 iPhone、iPad、Apple Silicon Mac 和 Android 应用中编写和编辑笔记。连接 ChatGPT、Claude 或其他兼容的 MCP 客户端，即可搜索、阅读、创建、更新和整理这些已保存的笔记。

使用文件夹、标签、维基链接和指令，让项目简报、研究笔记本或第二大脑在各个助手间保持最新。你可以在笔记历史记录中查看已保存的更改，恢复较早版本的正文，并将活跃笔记连同附件导出为 Markdown。

服务器由 Hjarni 托管；连接时无需运行本地桥接程序或 Docker 容器。本仓库介绍了这项托管服务。有关配置方式和客户端特定限制，请参阅客户端兼容性。

在 ChatGPT 和 Claude 之间共享客户端上下文

将每位客户端的偏好、约定范围、带日期的决策、当前状态和下一步行动记录在一份项目简报中。ChatGPT 和 Claude 可以通过 Hjarni 的官方托管 MCP 服务，读取和更新同一份 Markdown 笔记。

1. 按照下方的配置指南，将两款助手连接到同一个 Hjarni 账户。从客户端项目上下文模板开始：该模板会创建一个项目索引和一份空白简报，供你填写已确认的事实。为每位客户端和每个项目分别创建一份简报。
2. 起草内容前，请让助手找到正确的客户端和项目，阅读当前简报的完整内容，并返回其来源链接。如果有多份笔记符合条件，请让它确认要使用哪一份。
3. 先在聊天中起草拟议的更新。确认后，再让助手仅将这些更改保存到同一份简报中，同时保留其他事实，以及决策背后的日期和原因。打开笔记检查结果。
4. 在与另一款助手开启的新聊天中，明确要求它先获取更新后的简报，再继续工作。检查它是否报告了新的状态和下一步行动，同时保留未变更的范围和偏好。

连接后即可使用已保存的笔记；但这并不能保证助手会检索到这些笔记，也不会复制每段对话或助手自身的记忆。客户端上下文操作演示展示了两款助手如何使用同一份虚构简报，并通过提示词重复这些检查。

审查、恢复和导出

笔记历史记录和回收站可让你查看已保存的编辑记录及其记录的作者或 AI 客户端，将之前的笔记正文与当前文本进行比较，并将较早的正文恢复为新版本。恢复操作会替换整个正文，包括之后的所有编辑；当前标题、文件夹和其他字段保持不变。同一作者快速进行的编辑可能会合并为一个修订版本。已删除的笔记和文件夹会在回收站中保留 30 天，可在此期间恢复，但需遵守账户限制。历史记录用于查看已保存的更改；写入前是否需要批准，取决于助手的连接方式和设置。

导出和数据所有权介绍了如何将活动笔记下载为包含文件夹和附件的 Markdown ZIP 文件，并提供了一个示例 ZIP 文件，供你在不登录账户的情况下查看。导出是 Hjarni 中的一项操作，不是 MCP 工具。标准 Markdown ZIP 文件不包含已归档和已移至回收站的笔记、修订历史记录及文件夹说明；在其他应用中使用时，可能需要更新 wiki 链接和附件 URL。个人笔记、单个文件夹和团队都可以分别导出。

连接

端点为 https://hjarni.com/mcp。ChatGPT 和 Claude 使用 OAuth 登录；无需手动复制 API 令牌。对于接受 Authorization 标头的客户端，Hjarni 还支持完全访问权限的 API 令牌和受限的 Agent 令牌。

Claude.ai / Claude Desktop / Claude mobile

Hjarni 已收录于 Claude Connectors Directory：打开列表页面，点击 Connect 并登录。

或者通过 URL 添加：

1. 打开 Customize > Connectors，并添加自定义 Web 连接器。
2. 输入 URL https://hjarni.com/mcp。
3. 选择 OAuth 登录，完成添加连接器，然后登录 Hjarni。

账户和工作区要求请参阅 Hjarni Claude 指南和 Claude 当前的连接器说明。Claude Free 可使用自定义连接器，但最多只能添加一个；Team 和 Enterprise 的所有者负责管理工作区的可用性。

Claude Code

claude mcp add --transport http hjarni https://hjarni.com/mcp

添加 --scope user，即可在所有项目中使用。然后在 Claude Code 中运行 /mcp，完成 OAuth 登录。

ChatGPT

从 Hjarni 的 ChatGPT 目录页面安装并登录。有关可用性和使用方法，请参阅 ChatGPT 设置指南。

如果你的账户允许使用自定义 MCP 服务，也可以通过 URL 添加：

1. 打开 Plugins，选择 +，然后选择 Add custom MCP server。
2. 输入名称、服务 URL https://hjarni.com/mcp，并选择 OAuth 身份验证。
3. 检查连接详情，创建并安装插件，然后登录 Hjarni。
4. 在新聊天中，从 @ 菜单选择 Hjarni，并让它查找已保存的笔记。

自定义服务的可用性和工作区控制与安装目录条目相互独立。如果账户中的标签有所不同，请按照 OpenAI 当前的自定义 MCP 说明操作。

其他 MCP 客户端

客户端需要支持 Streamable HTTP 和一种受支持的身份验证方式：OAuth 2.0 with PKCE 或 Authorization: Bearer YOUR_API_TOKEN。OAuth 发现地址为 https://hjarni.com/.well-known/oauth-authorization-server；受保护资源元数据地址为 https://hjarni.com/.well-known/oauth-protected-resource。提示词、面板和事件等功能取决于客户端。

设置指南：Cursor · Copilot · Copilot Studio · Perplexity · Raycast

访问权限和 Agent 令牌

OAuth 登录连接使用已连接的 Hjarni 账户权限，包括其获授权的团队和共享笔记。在提示词中指定一个文件夹或添加文件夹说明，并不会限制该连接的访问权限。

对于 Claude Code 或 Cursor 等兼容客户端，请在 Settings > Connections 中创建 Agent 令牌，并为某个空间或文件夹授予 无访问权限、读取或写入权限。授权会沿层级向下继承，也可在下级覆盖；Agent 不能获得超出你自身权限的访问权。每个令牌都可以在历史记录中拥有自己的说明和身份。使用该令牌作为 Bearer 凭据，而不是常规 OAuth 连接。

受限令牌可见的工具列表范围更窄，也无法使用账户级管理工具或笔记面板。它们仍会暴露少量账户级详细信息，包括你的个人资料，以及脑部说明（除非针对该令牌禁用）；Agent 令牌参考列出了具体限制。隐私与权限说明了账户、团队和连接的访问权限。

可用工具

此表介绍面向助手的工具。实际可用情况取决于连接权限和客户端缓存的工具列表；服务器更新后，请在客户端中重新连接或刷新服务器。

工具	描述
me	已连接的个人资料、团队、笔记配额和入门状态；受限令牌会返回其授权范围，而非整个账户的配额和入门状态
dashboard-get	账户概览：所有空间的数量、最近笔记和近期变更
search	对笔记、容器和标签进行全文搜索
notes-list	列出笔记，可按容器、标签筛选并排序
notes-get	读取单篇笔记：完整正文、标签、链接、反向链接、文件和继承的 AI 指令
notes-create	创建笔记，设置标题、正文、摘要、标签和容器位置
notes-update	编辑或追加内容、替换或追加 Markdown 章节、移动笔记、更改标签、归档、收藏或标记为已验证
notes-open	在受支持的主机上打开可编辑的笔记面板，或在其他客户端上返回笔记数据；省略 ID 可打开选择器
notes-delete	将笔记移至回收站（可在 30 天内恢复）
notes-restore	从回收站恢复笔记
notes-history	查看笔记的修订历史：每个版本的撰写者、时间和变更内容
notes-revert	将笔记正文还原到较早的修订版本（会追加一个新版本，因此可以撤销）
containers-list	列出用于整理笔记的文件夹
containers-get	获取单个容器及其描述和 AI 指令
containers-create	创建文件夹
containers-update	更新容器（重命名、移动、更改描述、归档）
containers-permissions	设置或清除团队成员在团队容器中的角色
containers-delete	将文件夹、其子文件夹及其中的笔记移至回收站（可在 30 天内恢复）
containers-restore	恢复已删除的文件夹及其所有关联删除内容
tags-list	列出所有标签
tags-create	创建标签
tags-manage	重命名、合并或删除标签
links-manage	创建或移除笔记之间的双向链接
instructions-get	读取大脑、个人根目录、容器或团队级别的 AI 指令
instructions-update	替换或追加大脑、个人根目录、个人文件夹或团队指令，具体取决于访问权限和所有者权限
files-attach	将 Base64 文件附加到个人笔记
files-attach_from_url	将公开 URL 或原生 ChatGPT 文件引用附加到个人笔记
files-create_upload_url	为获授权的个人、团队或共享笔记生成一次性浏览器上传链接
files-check_upload	检查上传链接的状态
files-get_download_url	获取临时、无需登录的下载 URL；有效期间请将其视为凭证
files-remove	永久移除个人笔记中的附件
email-addresses-list	列出邮件收集地址
email-addresses-create	创建邮件收集地址：发往该地址的邮件会变成笔记，具体取决于账户资格
teams-list	列出用户加入的所有团队
teams-get	获取团队详情，包括近期笔记
teams-create	创建新团队
teams-invite	通过电子邮件邀请团队成员，或获取可分享的加入链接
feedback-submit	向维护者发送有关 Hjarni 的反馈
nudges-dismiss	忽略用户拒绝的产品建议

编辑时，请先读取当前笔记，并优先进行有针对性的编辑，而不是替换整个正文。将其 lock_version 作为 expected_lock_version 传入，以检查写入时数据是否过期。这不是严格锁：纯 append_body 调用会跳过此检查；如果笔记的最新编辑归属于已连接的用户，且时间早于 30 分钟，则即使版本不匹配也会接受。报告成功前，请检查工具结果：访问权限或限制导致的拒绝可能返回带有 status 的 ok: false，或带有错误消息的 error: true。请参阅工具和权限参考。

内置提示词

服务器还会向支持提示词发现的客户端提供 MCP 提示词：

提示词	描述
summarize_note	总结一则笔记，并推荐标签和相关链接
weekly_review	回顾近期活动，并推荐改进整理方式的建议
research_topic	综合知识库中与某个主题相关的所有内容

MCP Apps

在支持 MCP Apps（io.modelcontextprotocol/ui 扩展）的宿主上，files-create_upload_url 可以显示内嵌拖放区，让文件直接从聊天上传到笔记中。其他客户端会获得普通上传链接。

notes-open 可以在对话旁显示笔记选择器和编辑器。在支持 Hjarni 面板扩展的 ChatGPT 宿主中，面板还支持提及笔记，以及将选中的文本作为上下文附加。具体是否可用取决于宿主和已发布连接的当前工具元数据。notes-panel 和 notes-search_mentions 是该界面专用的工具；助手应使用 notes-get 读取笔记，并使用 notes-update 编辑笔记。

客户端还可以通过 resources/read 和类似 hjarni://notes/42 的 URI，将已保存的笔记作为资源读取，但仍受相同的笔记访问检查限制。这些是已保存笔记资源，不会自动同步对话。

变更事件

支持事件扩展的客户端可以订阅 note.created、note.updated 和 note.deleted（移至回收站）。Hjarni 会向经过验证的 Webhook 回调发送通知，并在发送前检查访问权限。通知会标识发生变更的笔记；客户端可使用 notes-get 获取其内容。

events/list、events/subscribe 和 events/unsubscribe 是协议方法，而非工具。通知仅通过 Webhook 发送；不支持轮询和流式传送。事件本身并不会让每个已连接的助手都在后台运行。请参阅事件参考和事件触发的工作流。

使用示例

研究助手

“我对技术栈做过哪些决定？”

Claude 会搜索你的笔记，沿着相关笔记之间的维基链接进行查找，并综合多个来源生成摘要。

快速记录

“将此内容保存为 Projects 文件夹中的一则笔记，并为它添加标签”

Claude 会找到合适的容器，使用 Markdown 格式创建笔记，添加标签，并将其链接到相关笔记。

每周回顾

“帮我整理收件箱”

让 Claude 列出未归档的笔记，根据你的文件夹结构建议每则笔记的归属位置，并在移动之前等待你批准。

结合上下文写作

“使用我最近的会议笔记起草一份项目进展更新”

Claude 会提取相关笔记，并将其用作素材。

功能

• Markdown 笔记，全面支持格式设置
• 维基链接（[[id:Note Title]]），用于交叉引用
• 文件夹，每个文件夹可配置自定义 AI 指令
• 全文搜索，覆盖所有内容
• 笔记之间的双向链接
• 用于跨类别整理的标签
• AI 指令，支持大脑、个人根目录、文件夹、团队和单个 Agent 令牌级别
• 笔记历史，记录每次修订的归属者（你或具体 AI 客户端），并支持还原
• 回收站，笔记和文件夹可在 30 天内恢复
• 所有套餐均支持文件附件（Pro 和 Teams 套餐不限量）
• 电子邮件收集：为文件夹分配专属电子邮件地址（Pro）
• 公开分享：所有套餐均支持通过链接只读查看笔记和文件夹；访客编辑需要付费访问权限
• Agent 令牌，按空间和文件夹强制实施读写授权
• 团队协作，共享知识库并为每个文件夹设置角色
• iPhone、iPad、Mac 和 Android 应用
• 用于自定义集成的 REST API
• 随时将数据导出为 Markdown

MCP 服务详情

端点	https://hjarni.com/mcp
传输方式	使用 JSON-RPC 2.0 的可流式 HTTP
协议版本	2025-11-25、2025-06-18、2025-03-26，以及通过 initialize 支持的 2024-11-05；通过 server/discover 支持的 2026-07-28（支持的方法请参阅参考文档）
身份验证	OAuth 2.0（PKCE）、完整访问权限 API 令牌，或作为 Bearer 凭证的受限 Agent 令牌
功能	工具、提示词、笔记和 UI 资源（MCP Apps），以及 Webhook 事件

完整的协议参考文档请参阅 MCP 服务文档。

定价

方案	价格	包含内容
免费	$0	25 条个人笔记、文件夹、标签、搜索、MCP 和 API 访问权限、仅查看的公开链接、5 个文件附件共 20 MB
Pro	$12/mo 或 $120/yr	无限笔记和文件附件、邮件收集、公开分享、与 2 位协作者分享
Teams	$20/seat/mo 或 $200/seat/yr	共享知识库、团队 MCP 和 API、成员管理、按文件夹设置角色

所有方案均包含 MCP 和 API 访问权限；但账号限制、功能资格和权限仍然适用。ChatGPT 或 Claude 订阅需另行购买。也提供欧元和英镑定价；查看当前价格和限制。

链接

• 网站
• 文档
• 入门指南
• MCP 服务参考文档
• REST API 参考文档
• Claude 设置指南
• ChatGPT 设置指南
• 博客
• 隐私
• 条款

支持

请发送邮件至 [email protected]。

---