puppyone logopuppyone
文档定价博客开源
开始使用

puppyone × Claude Code：通过 MCP 给它一份持久共享上下文

2026年4月23日puppyone team

TL;DR

  • Claude Code 在一个会话内表现出色 —— 读你仓库、改文件、跑命令。一旦 /quit 或者电脑睡眠，工作记忆就没了。
  • puppyone 通过 MCP 给 Claude Code 一份持久、版本化、多租户的工作空间。 一段配置。现在 Claude 读写一份会话之间都活着的共享工作空间，里面同步着 ingest 的 SaaS 数据，对你其他每个 Agent（Cursor、n8n、自建代码、同事）都可见。
  • 心智模型：AGENTS.md 和你仓库留在 GitHub（Claude Code 像以往一样在本地读）。长篇上下文、ingest 的 SaaS 数据、Agent 输出、共享笔记放 puppyone，作为 MCP 挂载的文件暴露给 Claude。
  • 这是我们知道的、给 Claude Code 一份不会每次开新终端就 reset 的记忆的最干净方式 —— 而且不会撑爆对话上下文。

加 puppyone 之后 Claude Code 变了什么

没有 puppyone 时，每次新 Claude Code 会话都从冷启动开始。Agent 重新读你仓库、重新发现你的约定，"先记住这个等会用"在会话结束的瞬间消失。多会话工作流（周一写规格、周二实现、周三重构）失去连续性。

通过 MCP 接上 puppyone 之后，Claude Code 拿到：

  • 一个跨会话、跨重启、跨设备都活着的持久文件工作空间。
  • 以文件形态出现的 SaaS 数据 —— Slack 线程、Notion 规格、Postgres 切片以可读文件出现在 /integrations/...，按计划刷新。Claude 用 cat 读，不用玩 API。
  • 多 Agent 可见性 —— Claude 写到 puppyone 的任何东西对你 Cursor Agent、n8n flow、自建 Python Agent、同事都可见。同一个工作空间，多个前门。
  • per-agent 权限 —— Claude Code 拿到自己的 Access Point，明确读写路径。它不会意外看见（或者清掉）scope 之外的数据。
  • 自动版本历史 —— Claude 每一次写都是 commit，带 author、时间戳、diff。在 /specs/architecture.md 里搞砸了一次重构？秒级回滚。

你不是在改 Claude Code 在会话内怎么工作。你是在给它一个会话之外存在的工作空间。

完全不变的东西

  • 代码留在 GitHub。 Claude Code 像以前一样读写你本地仓库。我们不是代码托管；见 puppyone vs GitHub。
  • AGENTS.md 留在你仓库。 那是 repo 专属指令的正确家。Claude 在本地读它；不需要通过 puppyone 重新挂载。
  • 你的 prompt、slash 命令、Claude Code 配置都不变。
  • CI / PR / review 流程不变。 PR 仍然到 GitHub。puppyone 是 Claude Code 底下的工作空间，不是 code review 的替代。

怎么接（短版）

  1. 建一个 puppyone 工作空间。 云端（try.puppyone.ai）或者在你 VPS / Mac mini 上 Docker 自托管。
  2. 拿到一个 MCP endpoint，对应一个有你想给 Claude 的路径 scope 的 Access Point（比如读 /specs、/research、/integrations；读+写 /scratch/claude-code）。
  3. 加进 Claude Code 的 MCP 配置。 在 ~/.claude.json（或者你这版 Claude Code MCP 配置在的地方）里一段，指向 puppyone MCP server。
  4. 会话内，工作空间作为可挂载表面出现 —— Claude 通过 MCP 工具能 cat、ls、grep、read_file、write_file。
  5. 可选：在 AGENTS.md 里告诉 Claude 它有这个工作空间，写一小段，比如*"你能访问 puppyone MCP server 上一个持久工作空间。/scratch/claude-code 用作工作笔记，/specs 读当前架构，长会话的总结写到 /notes/<date>.md。"* 这能推 Claude 真正用上这个新表面，而不是只把东西塞对话上下文里。

（一步一步的指南在 Claude Code 集成文档。这页讲为什么，不是逐步点击。）

真正变好的工作流

1. 多会话特性开发

没 puppyone： 周一 —— Claude Code 帮你写规格。周二 —— 新会话，你得复制粘贴回去，或者指望 Claude 重新推。

有 puppyone： 周一 —— Claude 把规格写到 puppyone 的 /specs/feature-x.md。周二 —— 新会话开始；Claude cat /specs/feature-x.md，从你停的地方继续。规格也对 Cursor、n8n flow、同事可见。

2. 写代码前的长跑研究

没 puppyone： 你让 Claude Code 调研某个库在 30 个仓库里怎么处理 X。输出在对话里。会话结束你得手动刮出来。

有 puppyone： Claude 边跑边把发现写到 /research/library-x/。每个发现是自己的文件加一个 commit。明天你（或另一个 Agent）能 grep -r "X" /research/library-x/ 拿全部。

3. 多 Agent 交接

没 puppyone： 一个研究 Agent（n8n + Claude API）在某处放了个 markdown。你终端里的 Claude Code 不容易看见。手动复制粘贴。

有 puppyone： 两个 Agent 都挂在同一个 puppyone 工作空间。研究 Agent 写到 /research/，Claude Code 原生读 /research/。无需手动交接。

4. Agent 身份和审计

没 puppyone： "谁写的这个 commit？" → "某次 Claude 会话，不记得什么时候。"

有 puppyone： 每次写都键入到 Claude Code 的 Access Point，带时间戳和完整 diff。你能按 Agent 审计，做合规、调试，或者纯好奇。

5. Claude 内的 SaaS 形状上下文

没 puppyone： 你告诉 Claude "auth 规格在 Notion，链接在这"。Claude 打不开链接。你粘贴内容进去。token 膨胀。

有 puppyone： Notion 连接器把 Auth Spec 镜像到 /integrations/notion/auth-spec.md。Claude 当普通文件读。Slack 线程（/integrations/slack/...）、Postgres 切片、GitHub issue 同理。

该避免的模式

  • 别试图把整个本地代码库放进 puppyone。 那是你本地文件系统（和 Cursor / Claude Code 已有的仓库访问）的活。puppyone 用来放不是代码库的东西：长篇上下文、Agent 输出、SaaS 数据、scratch、跨会话笔记。
  • 别把 Claude 对话 transcript 不过滤就自动写进 puppyone。 对话轮大多数是噪音。让 Claude 把总结 / 结构化输出写到 puppyone，不是原始 transcript。
  • 别不假思索地给 Access Point /specs（或任何人 curate 的路径）的写权限。 scope 的全部意义就是 Claude 写到自己的区域，除非你明确想让它编辑 canonical 文档。
  • 别依赖 puppyone 做 code review。 代码改动仍然走 GitHub PR。puppyone 是工作空间，不是 merge gate。

这跟你栈里其他东西怎么配

Claude Code 是大多数团队跑的几个 Agent 之一。干净拓扑：

  • Claude Code 通过 MCP 用 puppyone 持久上下文。
  • Cursor 通过 MCP 用 puppyone —— 同一个工作空间。见 puppyone for Cursor。
  • n8n / LangChain / CrewAI 工作流通过 REST 或连接器层用 puppyone。见 puppyone for n8n 等。
  • 自建 Python Agent通过 SSH / Bash 或 REST 用 puppyone。

重点不是把你锁进一个编辑器或框架。是给每个编辑器和框架一个共享底座，让它们停止重新发明 per-product 记忆。

FAQ

puppyone 替代 AGENTS.md 吗？ 不。AGENTS.md 留在你仓库里作为 per-repo 指令文件。Claude 在本地读。puppyone 装的是 AGENTS.md 能引用但不该包含的长篇上下文。

挂一个巨大的 puppyone 工作空间会撑爆 Claude Code 的 context 吗？ 不会 —— MCP 工具是按需调用。Claude 只加载它真正 read_file 的文件。工作空间可以巨大；只有读到的算。

同事的 Claude Code 会话能看见同一份 puppyone 工作空间吗？ 能 —— 那就是重点。每个同事的 Claude Code 用自己的 Access Point（合适的 scope），但全都连同一个工作空间。一边的写另一边可见。

Claude Code 自己的 "记忆" 功能怎么办？ Claude Code 的内置功能（project 记忆、slash 命令等）跟以前一样工作。puppyone 是底下另一层持久层 —— 那些内置功能盖不到的（SaaS 接入、多 Agent 可见、per-agent 身份等）有用。

我只用 Claude Code，一个人，一台笔记本，需要 puppyone 吗？ 大概率不需要。如果你也有 Cursor Agent、n8n 工作流、同事，或者要跨会话连续 —— 需要。

MCP 配置难吗？ 在 Claude Code 配置里几行 JSON。配置时间个位数分钟。每周每个 Agent 的回报是几小时到几天。

再说一遍 TL;DR

通过 MCP 加 puppyone，给 Claude Code 它默认缺的那一样：一份持久、版本化、团队可见的工作空间。AGENTS.md 和你仓库原地不动。长篇上下文和共享 Agent 状态放 puppyone。同一个 Claude，长得多的记忆。

把 Claude Code 接进一个不会每次会话都 reset 的工作空间。Get started