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

puppyone × Cursor：通过 MCP 挂上共享工作空间和 SaaS 上下文

2026年4月23日puppyone team

TL;DR

  • Cursor 在一个仓库内、一台笔记本上表现出色。 读你代码、索引、跑 chat / agent。仓库之外，Cursor 没有真正的上下文层。
  • puppyone 给 Cursor 一份活在仓库之外的工作空间。 通过 MCP 接进去，Cursor 在它编辑你代码的同一个 chat 里能 read_file puppyone 内的文件。
  • 那个工作空间装：长篇规格和设计笔记、ingest 的 SaaS 数据（Notion / Slack / Gmail / Postgres / GitHub issue）、之前 Agent 的输出、你团队的共享上下文。全部版本化，全部 per-agent scoped。
  • Cursor 的仓库功能原地不动（codebase 索引、.cursor/rules、project context）。puppyone 加的是 Cursor 不天生拥有的那层 —— 持久、跨会话、跨 Agent、SaaS-aware 的上下文。

把 puppyone 接进 Cursor 之后变了什么

Cursor 的活是你的仓库。它做得很棒。缝在你 Agent 需要不在仓库里的上下文时显出来：

  • 你正在做的特性的 Notion 规格。
  • 昨天 Slack 里某人解释为什么 X 这么定的那条线程。
  • 你代码会调但它不定义的 Postgres 切片。
  • 周一另一个 Agent 做的研究，写到了某个文件夹。
  • 你同事在另一台机器上 Cursor 会话里的笔记。

没 puppyone 时你做手动舞步：粘贴内容到 chat、截图、@ 附文件、从另一个 tab 手动复制。接上 puppyone 之后，同一个 Cursor Agent 直接 read_file /integrations/notion/feature-x-spec.md。不复制粘贴。同一个 chat。同一个 Cursor。

你还拿到：

  • 跨会话持久写入。 Cursor Agent 能把长总结或多文件计划写到 puppyone（/scratch/cursor/<date>.md）—— 明天的会话能接上。
  • 多 Agent 可见性。 Cursor 写的任何东西对你 Claude Code 会话、n8n 研究 flow、自建 Python Agent 都可见 —— 全在同一个工作空间。
  • per-agent 权限。 Cursor 拿到自己的 Access Point，明确读写 scope。比如能读你规格但只能写到自己 scratch 文件夹。
  • 自动版本历史。 Cursor 通过 puppyone 每次写都是 commit，带 author / 时间戳 / diff / 回滚。

关键：Cursor 怎么处理你仓库一点没变。我们不索引你代码；Cursor 已有的 codebase 索引不变。我们只是叠上 Cursor 不天生拥有的外部上下文层。

完全不变的东西

  • 你仓库留在 GitHub / 本地。 Cursor 像以前一样读写。
  • .cursor/rules 和 project context 功能留在你仓库里。 Cursor 像以前一样用。
  • code review / PR 流程不变。代码走 GitHub PR。
  • Cursor 的 chat、agent、行内编辑功能不变。我们是 MCP server，不是 Cursor 插件或 fork。

怎么接（短版）

  1. 建一个 puppyone 工作空间。 云端（try.puppyone.ai）或 Docker 自托管。
  2. 给 Cursor 定一个 Access Point，路径 scope 你想要的（比如读 /specs、/research、/integrations；读+写 /scratch/cursor）。
  3. 把 MCP server 加进 Cursor 的 MCP 配置。 Cursor 设置 → MCP，指向 puppyone MCP endpoint，带 Access Point token。
  4. 在 Cursor chat 里，工作空间作为工具表面出现 —— Cursor 能调 read_file、list_directory、write_file、search。
  5. 可选：在 .cursor/rules 里加一行告诉 Cursor puppyone 工作空间里有什么、什么时候用（"规格和团队共享笔记在 puppyone 的 /specs 和 /notes 里。设计前先读那些。"）。

真正变好的工作流

1. "规格写了什么？" —— 不用离开 Cursor

没 puppyone： 打开 Notion，找规格，复制一段，粘到 Cursor chat。

有 puppyone： Notion 连接器把规格镜像到 /integrations/notion/feature-x.md。Cursor 里："读 /integrations/notion/feature-x.md，告诉我这个特性应该做什么。"完成。Cursor 读了，你继续写。

2. 周三接上周一的会话

没 puppyone： 周一你跟 Cursor 一起设计架构。周三再打开 Cursor 不记得了。

有 puppyone： 周一的 Cursor 写了 /scratch/cursor/architecture-discussion.md。周三的 Cursor 读它，继续。

3. 两个同事，一个工作空间

没 puppyone： 同事的 Cursor 在他笔记本上有自己的上下文。你看不到他探索了什么。他看不到你做了什么。

有 puppyone： 两边 Cursor 通过 MCP 连同一个 puppyone 工作空间，各自有 Access Point。你写到 /notes/ 的同事看见。屋子两边的 Cursor 在读同一个工作空间。

4. 同一个项目上 Cursor + Claude Code + n8n

没 puppyone： 每个 Agent 有自己 per-product 的记忆。要在它们之间共享上下文要手动搬。

有 puppyone： 三个都连同一个 puppyone 工作空间。Cursor 读 Claude Code 昨天写的。n8n flow 把研究写到 /research/，Cursor 看见。无胶水代码，无手动复制。

5. Cursor 内的 Postgres / Slack / Gmail 上下文

没 puppyone： Cursor 不跟你的数据库或 Slack 说话。你手工总结或用临时工具。

有 puppyone： 连接器把 SaaS 源物化成文件。/integrations/postgres/active-users.csv、/integrations/slack/eng-channel/2026-04-22.md —— Cursor 通过 MCP 当文件读，不需要懂 API。

该避免的模式

  • 别试图把代码库放进 puppyone。 Cursor 已经在 codebase 上下文上很强。puppyone 用来放代码库外面的所有东西。
  • 别随便给 Cursor 写 canonical 路径的权限。 让它写到自己 scratch；review 之后再 promote 到 canonical 路径。
  • 别不过滤地自动镜像整个 SaaS workspace。 挑重要的 Notion 空间 / Slack 频道 / Postgres 查询。一个嘈杂的工作空间是没用的工作空间。
  • 别指望 puppyone 替代 .cursor/rules。 仓库专属 Cursor 规则属于仓库。长篇、跨仓库、跨 Agent 的上下文属于 puppyone。

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

  • Cursor 通过 MCP 用 puppyone 拿外部上下文。
  • Claude Code 用同一份 puppyone 工作空间通过 MCP。见 puppyone for Claude Code。
  • n8n / LangChain / CrewAI 通过 REST 或连接器层用 puppyone。见 puppyone for n8n。
  • 自建代码 通过 SSH / Bash / REST 用 puppyone。

Cursor 不再是"知道我的仓库其他什么都不知道的孤岛"，开始是"通向共享 Agent 工作空间的编辑器视图"。

FAQ

puppyone 替代 Cursor 的 codebase 索引吗？ 不。我们不碰你仓库或 codebase 索引。Cursor 本地索引不变。我们加仓库之外的上下文。

挂一个巨大的 puppyone 工作空间，Cursor chat 会变慢吗？ 不会。MCP 工具是按需调用。Cursor 只读它真正要的。工作空间可以很大；只有被 read_file 的文件进 chat。

puppyone 能跟 Cursor 的 "Composer" / 多文件编辑一起用吗？ 能。Composer 像 chat 一样能通过 MCP 读 puppyone 上下文。你能在 Composer prompt 里 @ puppyone 文件。

puppyone 跟 Cursor 项目规则（.cursor/rules）是什么关系？ 互补。项目规则在你仓库里，管 Cursor 在那个仓库的行为。puppyone 提供 Cursor 能拉的跨仓库、跨 Agent、SaaS-aware 上下文。

每个同事能有自己 scope 的工作空间视图吗？ 能。每个 Cursor 会话用自己的 Access Point，合适的读写路径。同一个工作空间，per-同事不同 scope。

我是单人开发者，一个仓库，需要 puppyone 吗？ 只有当你有那个仓库之外、Cursor 需要拉的上下文（Notion 规格、Slack 线程、多会话研究）才需要。如果你关心的一切都在仓库里，大概不需要。

再说一遍 TL;DR

Cursor 在仓库上很棒。它不是仓库外所有东西的上下文层。puppyone 是。通过 MCP 挂上，Cursor 能读你规格、你 Notion、你 Slack、你之前 Agent 的输出 —— 不用离开 chat。同一个 Cursor，宽得多的上下文。

别再往 Cursor 里贴 Notion 截图。直接挂上工作空间。Get started