Sooveryn

Sooveryn MCP

Sooveryn 是托管的 MCP 服务。其代码不公开：本仓库仅包含文档和配置示例。

为 Claude Code 提供持久记忆和 AI 团队。

在 YouTube 上观看演示（1 分钟） · 法语版

Sooveryn 为 Claude Code 配备了一支能够记住项目的 AI 人格团队。作为合作伙伴和团队负责人的 Soov 会将你的决策和工作方式保存为持久记忆。他会在不同会话之间、不同设备上，根据关键词和含义重新找到这些记忆。

他会向队友征求意见（Néo 负责安全，Vera 会质疑你的想法，Iris 负责设计，Maria 负责 SEO），也可以让他们先讨论再做决定。付费套餐支持创建自定义人格和技能。

• 网站：https://www.sooveryn.com
• 服务：https://mcp.sooveryn.com/mcp（可流式传输的 HTTP，API 密钥通过标头传递）
• MCP 注册表（registry.modelcontextprotocol.io）：com.sooveryn/sooveryn
• 兼容 Claude Code、VS Code、Orca、Pi，以及支持通过密钥连接远程 HTTP 服务的 MCP 客户端

开始使用

1. 前往 https://www.sooveryn.com/try 并输入你的电子邮件地址。无需密码。
2. 确认你通过电子邮件收到的验证码，或点击同一封邮件中的链接。此时会创建你的账户和第一个 API 密钥。
3. 连接客户端。对于 Claude Code，页面会显示一条命令，你可以在项目文件夹中的终端里粘贴执行；对于其他客户端，请使用下方对应的配置。你的密钥可用于访问账户并读取记忆：请勿将其放入任何会提交到 git 的内容中。
4. 在会话中说 Soov Init。Agent 会在项目根目录下写入 sooveryn.md 文件，确保该文件不会提交到 git，并通过 CLAUDE.md 中的 @sooveryn.md 行在每次会话中加载该文件。从此以后，每次会话都会从 Soov 及其项目记忆开始。

日后重新登录时，只需在同一页面输入相同的地址：使用收到的验证码即可登录。你可以在 API 密钥页面（https://www.sooveryn.com/me/keys）创建更多密钥；最好每台设备使用一个密钥。

Claude Code 和 Orca

最快的方式是在项目文件夹中的终端里运行一条命令。它会将服务和密钥保存到你自己的 Claude Code 项目设置中，不会在项目中写入任何内容：

claude mcp add --transport http sooveryn https://mcp.sooveryn.com/mcp --header "Authorization: Bearer <YOUR-API-KEY>"

若要将配置保存在项目中，同时不在其中放入密钥：将密钥放入名为 SOOVERYN_API_KEY 的环境变量，并在 Claude Code 启动时设置（例如，在 shell 配置文件中）。然后在项目根目录添加 .mcp.json（示例）。Claude Code 加载该文件时会替换 ${SOOVERYN_API_KEY}，因此文件中不包含任何密钥：

{
  "mcpServers": {
    "sooveryn": {
      "type": "http",
      "url": "https://mcp.sooveryn.com/mcp",
      "headers": {
        "Authorization": "Bearer ${SOOVERYN_API_KEY}"
      }
    }
  }
}

Orca 会运行 Claude Code，而 Claude Code 会读取此文件。

VS Code

.vscode/mcp.json（示例）。VS Code 会忽略 .mcp.json 中的 headers，因此需要在 servers 键下使用专属文件。它会提示你输入一次密钥，在输入时隐藏密钥，并安全地保存密钥：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "sooveryn-key",
      "description": "Sooveryn API key",
      "password": true
    }
  ],
  "servers": {
    "sooveryn": {
      "type": "http",
      "url": "https://mcp.sooveryn.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:sooveryn-key}"
      }
    }
  }
}

Pi

安装它的 MCP 扩展。随后，Pi 会读取与 Claude Code 相同的 .mcp.json。

pi install npm:pi-mcp-adapter

如果 Pi 未能从环境变量中读取密钥，请像下面这样将密钥直接写入文件。

其他 MCP 客户端

设置	值
传输方式	可流式传输的 HTTP
URL	https://mcp.sooveryn.com/mcp
标头	Authorization: Bearer <YOUR-API-KEY>
可选标头	X-Project-Scope: <project-name>

如果不设置 X-Project-Scope，Agent 会按照 sooveryn.md 中的说明，在每次调用时传递项目名称。

如果密钥写在文件中

网站的 API 密钥页面会提供已写入密钥的文件。请将它们添加到 .gitignore，避免提交到 git：

.mcp.json
.vscode/mcp.json

密钥一旦提交，就会留在历史记录中，即使删除文件也一样：请在 API 密钥页面撤销该密钥并创建一个新密钥。

工具

工具	功能
init	当你说“ Soov Init”时，在当前项目中初始化 Sooveryn。
activate	启动一个 persona：包括其角色、规则，以及适合本次会话的部分记忆。
search_memory	按词语和含义搜索 persona 的记忆。
write_event	记录发生的事情。
update_semantic	创建或更新一份命名的事实表。
update_procedural	创建或更新一条命名的工作规则。
write_previous_context	为项目的下一次会话留下简短的交接说明。
clear_previous_context	交接说明应用后将其清除。
start_debate	检查计划及其配额后，开启由两个到四个 persona 参与的辩论，并返回要遵循的流程。
list_skills	列出账户可使用的技能：技能目录和你自己的技能。
get_skill	返回某项技能的说明。
stats	统计一个 persona 的记忆条目。
reindex	重建一个 persona 的记忆索引缓存。

记忆与隐私

• 记忆分为三类：发生过的事情、已知信息和工作方式。每个项目都有自己的记忆；Pro 还提供跨项目共享的通用记忆。
• 记忆会保留 persona 写入的内容。你可以在网站上查看全部内容，并可在任何套餐中申请获取一份数据副本。
• 记忆内容在数据库中加密，每个账户使用单独的密钥，该密钥由存放在数据库之外的主密钥保护。由于服务器持有主密钥，Sooveryn 在技术上能够解密你的记忆以便为你提供服务：这种加密主要用于防止数据库及其备份被盗或泄露，并非端到端加密。
• 部分信息不会加密，以便服务进行排序和筛选：标识符、每条记忆对应的 persona 和类型、项目名称、计数器和日期、账户数据，以及你创建的 personas 和技能。
• 服务器位于法国。激活 persona 时，你记忆中的相关部分会发送到你的 AI 客户端，再由客户端发送给你的 AI 服务提供商。使用 Consolidation 选项（Pro）时，你记忆的摘录会发送给位于美国的 Anthropic，以供其提出整合建议。
• 详情请参阅：隐私政策和条款。

须知

• 写入记忆的内容会在之后的会话中重新出现。Agent 从不可信来源（网页、issue、文件）复制的文本可能会影响之后的会话：请不时在网站上检查你的记忆。
• 在项目根目录放置 .incognito 文件，可阻止本次会话写入记忆。由 Agent 应用此规则，而非服务器；服务器不会读取你的文件。

套餐

免费套餐：整个团队可在一个项目中使用，包括辩论，但调用、记忆写入和辩论均有每日限额。付费套餐可添加自定义 personas 和技能；Pro 还提供通用记忆和记忆整合。价格和详情：https://www.sooveryn.com/#pricing。

支持与安全

• 支持：[email protected]
• 报告漏洞请参阅 SECURITY.md。切勿在公开 issue 中报告。
• 欢迎在此仓库提交文档错误相关的 issue。切勿在其中粘贴你的密钥、配置文件或记忆：此页面是公开的。

许可证

此仓库中的文档和示例采用 MIT 许可证。Sooveryn 服务、其代码、名称和徽标不在许可范围内。

Sooveryn 由法国的 Cyril Pierron EI 以 PANDAPROG 名义发布。法律声明：https://www.sooveryn.com/legal。