推出 MongoDB Claude SDK 会话适配器：为智能体提供持久化会话存储
内容提要
MongoDB 推出 Claude Agent SDK 会话适配器，提供 Python 版，TypeScript 版计划于 2027 年 1 月发布。该适配器实现 SDK 的 SessionStore 接口，将代理会话记录实时镜像到 MongoDB，使会话可在不同实例间恢复，适用于 Lambda 等无状态部署。它支持跨环境连续性、故障恢复，并复用现有 MongoDB 集群的访问控制与备份策略，满足审计和留存需求，只需几行代码配置即可使用。
延伸解读
无状态部署下的会话连续性
文章指出，当 Claude 智能体部署在 Lambda 等无状态环境时，每次调用都是可丢弃的实例，本地磁盘无法保留会话。MongoDB 会话适配器通过实时镜像会话记录，使任何实例都能恢复完整历史。这意味着团队无需为会话持久化单独搭建系统，直接复用现有 MongoDB 集群即可实现跨实例的连续对话。
故障恢复与审计留存的一体化
适配器将每个对话轮次和操作实时写入 MongoDB，而非批量或本地缓存，因此主机崩溃或容器重调度后，接手的实例能看到与失败前一致的状态。同时，会话数据存放在现有 MongoDB 集群中，沿用相同的访问控制和备份策略，满足内部审计与数据留存要求，避免为智能体记忆另建一套系统。
接入成本与版本节奏
文章强调只需在 ClaudeAgentOptions 中配置几行代码即可启用，并提供了 pip 安装命令。目前适配器提供 Python 版，TypeScript 版计划于 2027 年 1 月发布。对于使用 Python 的团队，可以立即评估；而 TypeScript 用户需等待后续版本，暂无法直接使用。
Q&A
MongoDB Claude SDK 会话适配器是什么？
MongoDB Claude SDK 会话适配器是一个实现 Claude Agent SDK 的 SessionStore 接口的组件，可将代理会话记录实时镜像到 MongoDB，使会话能在不同实例间恢复。目前提供 Python 版本，TypeScript 版本计划于 2027 年 1 月发布。
为什么需要为 Claude 智能体配置 SessionStore？
当智能体部署在无状态环境（如 Lambda）时，每次调用都是临时实例，没有本地磁盘存储会话。没有 SessionStore，每个请求都是无状态的，智能体无法记住之前的对话。配置 SessionStore 后，任何实例都能获取会话的完整历史，实现跨实例的连续性。
MongoDB 会话适配器如何保证故障恢复？
适配器在会话进行时将每一步操作实时写入 MongoDB，而不是批量或缓存在本地。因此如果主机崩溃或容器在对话中途被重新调度，数据不会丢失，任何接管会话的实例都能看到与故障实例相同的状态（直到最后一个完成的步骤）。
使用 MongoDB 会话适配器有哪些好处？
主要好处包括：跨环境连续性（会话状态不依赖单台机器，可在不同实例或设备间恢复）、故障恢复（实时写入避免数据丢失）、以及留存与审计（会话数据存储在现有 MongoDB 集群中，复用相同的访问控制和备份策略，满足审计和留存需求）。
如何配置 MongoDB 会话适配器？
首先安装包：pip install claude-agent-sdk-mongodb-session-store。然后在代码中创建 MongoDBSessionStore 实例并传入 MongoDB 客户端，调用 create_schema() 初始化，最后在 ClaudeAgentOptions 中设置 session_store 参数即可。只需几行代码。
适配器支持哪些编程语言？
目前提供 Python 版本，TypeScript 版本计划于 2027 年 1 月发布。
